Anime

Rank anime

Ranks anime by sort (default TRENDING_DESC, or POPULARITY_DESC, SCORE_DESC, FAVOURITES_DESC, START_DATE_DESC, UPDATED_AT_DESC). Filter by season, season_year (1940 to 2100), format, genre and status. Paged with page and per_page (default 20, max 50); results carry titles, scores, popularity, episodes, studios and tags.

get/anime/rankings

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/anime/rankings
  • Auth: API key in header x-api-key

Query parameters

sort'TRENDING_DESC' | 'POPULARITY_DESC' | 'SCORE_DESC' | 'FAVOURITES_DESC' | 'START_DATE_DESC' | 'UPDATED_AT_DESC'

Order: TRENDING_DESC, POPULARITY_DESC, SCORE_DESC, FAVOURITES_DESC, START_DATE_DESC, UPDATED_AT_DESC. Default TRENDING_DESC.

season'WINTER' | 'SPRING' | 'SUMMER' | 'FALL'

Airing season filter: WINTER, SPRING, SUMMER, FALL.

season_yearinteger

Airing year filter, 1940-2100.

format'TV' | 'TV_SHORT' | 'MOVIE' | 'SPECIAL' | 'OVA' | 'ONA' | 'MUSIC'

Format filter: TV, TV_SHORT, MOVIE, SPECIAL, OVA, ONA, MUSIC.

genrestring

Genre filter, e.g. Fantasy.

status'FINISHED' | 'RELEASING' | 'NOT_YET_RELEASED' | 'CANCELLED' | 'HIATUS'

Status filter: FINISHED, RELEASING, NOT_YET_RELEASED, CANCELLED, HIATUS.

pageinteger

1-based page number, default 1

per_pageinteger

Results per page, default 20, max 50

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "format": "TV",
    "genre": "Fantasy",
    "has_next_page": true,
    "page": 1,
    "per_page": 20,
    "results": [
      {
        "average_score": 91,
        "country_of_origin": "JP",
        "duration": 24,
        "end_date": {
          "day": 29,
          "month": 9,
          "year": 2023
        },
        "episodes": 28,
        "favourites": 54038,
        "format": "TV",
        "genres": [
          "Adventure",
          "Drama",
          "Fantasy"
        ],
        "id": 154587,
        "id_mal": 52991,
        "mal": {
          "max": 10,
          "score": 9.26,
          "scored_by": 911901
        },
        "mean_score": 91,
        "next_airing_episode": {
          "airing_at": 1704900600,
          "episode": 13,
          "time_until_airing": 259200
        },
        "popularity": 456965,
        "season": "FALL",
        "season_year": 2023,
        "site_url": "https://anilist.co/anime/154587",
        "start_date": {
          "day": 29,
          "month": 9,
          "year": 2023
        },
        "status": "FINISHED",
        "studios": [
          "MADHOUSE"
        ],
        "tags": [
          {
            "category": "Cast-Main Cast",
            "name": "Elf",
            "rank": 91
          }
        ],
        "title": {
          "english": "Frieren: Beyond Journey's End",
          "native": "葬送のフリーレン",
          "romaji": "Sousou no Frieren"
        },
        "trending": 120,
        "type": "ANIME"
      }
    ],
    "season": "FALL",
    "season_year": 2023,
    "sort": "TRENDING_DESC",
    "status": "FINISHED",
    "total": 5000
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.