Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the AniList API page →
Media, Film & Knowledge

AniList API & Scraper

This API reads AniList, the anime and manga database, as JSON with no account and no AniList key.

37 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

`media` returns one anime or manga in one call: every title and synonym, description, format, status, start and end dates, season, episodes and episode length or chapters and volumes, source material, country, the Weighted Score the page shows, Mean Score, popularity (users with it on their list), favourites, trending, its all-time, yearly and seasonal rankings, the score distribution and the list-status distribution, genres, every tag with its rank and spoiler flags, main studios and producers, trailer, the next episode and when it airs, external and streaming links, streaming episodes, every related title, and the first page of characters with voice actors, staff, recommendations and reviews. It takes an AniList id, an anilist.co link or a MyAnimeList id; `media_batch` returns up to 50 titles in one call. `search_media` has every filter of anilist.co's browse page (genres and tags in and out, tag category and minimum tag rank, format, status, season and year, start-date range, country, source, streaming service, licensed, adult, and ranges for score, popularity, episodes, length, chapters and volumes) and 22 sort orders, so trending, top-rated, most popular and seasonal charts are one call each. Full lists page through a title's characters (one language or every dub), staff, daily trend history and episode air times, the airing calendar, reviews with their full text, recommendations, characters, voice actors and their roles, studios and their titles, public user profiles with statistics, favourites, anime and manga lists, followers and following, the activity feed and the forum.

Reference

What an AniList field actually contains

Fields that read differently from how they look. Every row was measured against live AniList on 2026-11-16.

FieldWhat it holds
weighted_scoreThe score anilist.co prints as "Weighted Score" (0-100). Equal to the page on 10 of 10 titles read in the same minute (Fullmetal Alchemist: Brotherhood 90). Null for titles AniList has not scored yet.
average_scoreAniList's older name for the same number: equal to weighted_score on 100 of 100 titles (50 trending anime, 50 popular manga). Kept for code written against it.
mean_scoreThe page's "Mean Score": the plain average of user scores. Equal to the page on 10 of 10 titles.
popularityThe page's "Popularity": users with the title on their list. Equal to the page on 9 of 10 titles; on the tenth the page itself was a cached render 382 users behind (Death Note: 983,596 on the page, 983,978 live, three reads).
favouritesThe page's "Favorites". Equal to the page on 10 of 10 titles.
main_studios, producersanilist.co's "Studios" and "Producers" lines: studios marked main, then every other credited company. Equal to the page on 7 of 7 anime that list them.
tags[].is_spoilerEvery tag is returned, including the ones anilist.co hides as spoilers; is_general_spoiler and is_media_spoiler say which kind.
rankingsThe "#4 Highest Rated All Time" style badges: rank, type (RATED or POPULAR), year and season when the ranking is for one season or year.
next_airing_episodeEpisode number, air time (UTC and unix) and seconds until it airs, for titles that are airing.
total, total_at_leastAniList publishes an exact count only on the last page of a list. On earlier pages total is null and total_at_least is how many exist at least; has_next_page says whether to read on.

Data is what AniList publishes to a logged-out visitor, including user names and public lists. Private lists are not readable and come back as not found.

Live example

Real request and response JSON

Captured from the indexed primary action, media, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/anilist/v1/media",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "media": 5114
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "anilist",
    "endpoint": "media",
    "mode": "live",
    "latency_ms": 742.7,
    "record_count": 1,
    "bytes": 77457,
    "cache_hit": false,
    "upstream_requests": 1,
    "charged_credits": 1,
    "version": "0.1.0",
    "request_id": "db8fc7c3b17f4952",
    "queue_ms": 2.1,
    "fetched_at": "2026-11-16T21:05:21.513Z"
  },
  "data": {
    "media": {
      "id": 5114,
      "mal_id": 5114,
      "mal_url": "https://myanimelist.net/anime/5114",
      "url": "https://anilist.co/anime/5114",
      "type": "ANIME",
      "format": "TV",
      "status": "FINISHED",
      "title": {
        "romaji": "Hagane no Renkinjutsushi: FULLMETAL ALCHEMIST",
        "english": "Fullmetal Alchemist: Brotherhood",
        "native": "鋼の錬金術師 FULLMETAL ALCHEMIST",
        "user_preferred": "Hagane no Renkinjutsushi: FULLMETAL ALCHEMIST"
      },
      "synonyms": [
        "FMA",
        "FMAB",
        "Hagaren"
      ],
      "description": "\"In order for something to be obtained, something of equal value must be lost.\"\n\nAlchemy is bound by this Law of Equivalent Exchange—something the young brothers Edward and Alphonse Elric only realize after attempting human transmutation: the one forbidden act of alchemy. They pay a terrible price for their transgression—Edward loses his left leg, Alphonse his physical body. It is only by the desperate sacrifice of Edward's right arm that he is able to affix Alphonse's soul to a suit of armor. Devastated and alone, it is the hope that they would both eventually return to their original bodies ",
      "start_date": "2009-04-05",
      "end_date": "2010-07-04",
      "season": "SPRING",
      "season_year": 2009,
      "episodes": 64,
      "duration_min": 25,
      "chapters": null,
      "volumes": null,
      "country_of_origin": "JP",
      "is_licensed": true,
      "source": "MANGA",
      "genres": [
        "Action",
        "Adventure",
        "Drama"
      ],
      "weighted_score": 90,
      "average_score": 90,
      "mean_score": 90,
      "popularity": 744947,
      "favourites": 69544,
      "trending": 35,
      "is_adult": false,
      "hashtag": null,
      "cover_image": {
        "extra_large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx5114-nSWCgQlmOMtj.jpg",
        "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx5114-nSWCgQlmOMtj.jpg",
        "medium": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/small/bx5114-nSWCgQlmOMtj.jpg",
        "color": "#e4c993"
      },
      "banner_image": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/5114-q0V5URebphSG.jpg",
      "next_airing_episode": null,
      "updated_at": "2026-11-16T21:00:13Z",
      "tags": [
        {
          "id": 1291,
          "name": "Alchemy",
          "rank": 97,
          "category": "Theme-Fantasy",
          "is_spoiler": false,
          "is_general_spoiler": false,
          "is_media_spoiler": false,
          "is_adult": false,
          "description": "Features character(s) who practice alchemy.",
          "user_id": 764829
        },
        {
          "id": 456,
          "name": "Conspiracy",
          "rank": 94,
          "category": "Theme-Drama",
          "is_spoiler": true,
          "is_general_spoiler": false,
          "is_media_spoiler": true,
          "is_adult": false,
          "description": "Contains one or more factions controlling or attempting to control the world from the shadows.",
          "user_id": null
        },
        {
          "id": 34,
          "name": "Military",
          "rank": 92,
          "category": "Theme-Other-Organisations",
          "is_spoiler": false,
          "is_general_spoiler": false,
          "is_media_spoiler": false,
          "is_adult": false,
          "description": "Centered around the life and activities of military personnel.",
          "user_id": 560957
        }
      ],
      "studios": [
        {
          "id": 4,
          "name": "bones",
          "is_main": true,
          "is_animation_studio": true,
          "url": "https://anilist.co/studio/4",
          "favourites": 14451
        },
        {
          "id": 17,
          "name": "Aniplex",
          "is_main": false,
          "is_animation_studio": false,
          "url": "https://anilist.co/studio/17",
          "favourites": 2332
        },
        {
          "id": 58,
          "name": "Square Enix",
          "is_main": false,
          "is_animation_studio": false,
          "url": "https://anilist.co/studio/58",
          "favourites": 364
        }
      ],
      "main_studios": [
        "bones"
      ],
      "producers": [
        "Aniplex",
        "Square Enix",
        "Mainichi Broadcasting System"
      ],
      "trailer": {
        "id": "1ac3_YdSSy0",
        "site": "youtube",
        "thumbnail": "https://i.ytimg.com/vi/1ac3_YdSSy0/hqdefault.jpg",
        "url": "https://www.youtube.com/watch?v=1ac3_YdSSy0"
      },
      "season_int": 92,
      "is_locked": false,
      "is_recommendation_blocked": false,
      "is_review_blocked": false,
      "rankings": [
        {
          "id": 4,
          "rank": 4,
          "type": "RATED",
          "format": "TV",
          "year": null,
          "season": null,
          "all_time": true,
          "context": "highest rated all time"
        },
        {
          "id": 511,
          "rank": 11,
          "type": "POPULAR",
          "format": "TV",
          "year": null,
          "season": null,
          "all_time": true,
          "context": "most popular all time"
        },
        {
          "id": 4691,
          "rank": 1,
          "type": "RATED",
          "format": "TV",
          "year": 2009,
          "season": null,
          "all_time": false,
          "context": "highest rated"
        }
      ],
      "score_distribution": [
        {
          "score": 10,
          "amount": 2529
        },
        {
          "score": 20,
          "amount": 329
        },
        {
          "score": 30,
          "amount": 592
        }
      ],
      "status_distribution": [
        {
          "status": "CURRENT",
          "amount": 55748
        },
        {
          "status": "PLANNING",
          "amount": 157966
        },
        {
          "status": "COMPLETED",
          "amount": 490005
        }
      ],
      "external_links": [
        {
          "id": 1503,
          "site": "Hulu",
          "url": "http://www.hulu.com/fullmetal-alchemist-brotherhood",
          "type": "STREAMING",
          "language": null,
          "site_id": 7,
          "notes": null,
          "is_disabled": false,
          "color": "#1CE783",
          "icon": "https://s4.anilist.co/file/anilistcdn/link/icon/7-rM06PQyWONGC.png"
        },
        {
          "id": 5244,
          "site": "Crunchyroll",
          "url": "http://www.crunchyroll.com/fullmetal-alchemist-brotherhood",
          "type": "STREAMING",
          "language": null,
          "site_id": 5,
          "notes": null,
          "is_disabled": false,
          "color": "#F88B24",
          "icon": "https://s4.anilist.co/file/anilistcdn/link/icon/5-AWN2pVlluCOO.png"
        },
        {
          "id": 5935,
          "site": "Amazon Prime Video",
          "url": "https://www.amazon.com/One-All/dp/B002T8C202/ref=sr_1_52/146-1307517-0174061?s=instant-video&rps=1&ie=UTF8&qid=1528858933&sr=1-52&refinements=p_n_theme_browse-bin%3A2650364011%2Cp_85%3A2470955011%2Cp_n_entity_type%3A14069184011%7C14069185011",
          "type": "STREAMING",
          "language": null,
          "site_id": 21,
          "notes": null,
          "is_disabled": false,
          "color": "#FF9900",
          "icon": "https://s4.anilist.co/file/anilistcdn/link/icon/21-bDoNIomehkOx.png"
        }
      ],
      "streaming_episodes": [
        {
          "title": "Episode 1 - Fullmetal Alchemist",
          "url": "http://www.crunchyroll.com/watch/GRE5P5PV6/fullmetal-alchemist",
          "site": "Crunchyroll",
          "thumbnail": "https://img1.ak.crunchyroll.com/i/spire2-tmb/bba713cd933d6eadd690fcf477cfb2c21471054462_full.jpg"
        },
        {
          "title": "Episode 2 - The First Day",
          "url": "http://www.crunchyroll.com/watch/G69PJPJVY/the-first-day",
          "site": "Crunchyroll",
          "thumbnail": "https://img1.ak.crunchyroll.com/i/spire1-tmb/ddf59534e12f0ce000c42b163132071f1471781407_full.jpg"
        },
        {
          "title": "Episode 3 - City of Heresy",
          "url": "http://www.crunchyroll.com/watch/G6490901Y/city-of-heresy",
          "site": "Crunchyroll",
          "thumbnail": "https://img1.ak.crunchyroll.com/i/spire4-tmb/f132b5b37031a79cb9dad9c6826a14ad1471053084_full.jpg"
        }
      ],
      "relations": [
        {
          "relation_type": "SOURCE",
          "id": 30025,
          "mal_id": 25,
          "type": "MANGA",
          "format": "MANGA",
          "status": "FINISHED",
          "title": {
            "romaji": "[trimmed-depth]",
            "english": "[trimmed-depth]",
            "native": "[trimmed-depth]",
            "user_preferred": "[trimmed-depth]"
          },
          "cover_image": {
            "extra_large": "[trimmed-depth]",
            "large": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "color": "[trimmed-depth]"
          },
          "start_date": "2001-07-12",
          "season": null,
          "season_year": null,
          "episodes": null,
          "chapters": 116,
          "volumes": 27,
          "weighted_score": 89,
          "average_score": 89,
          "mean_score": 89,
          "popularity": 81549,
          "favourites": 7947,
          "is_adult": false,
          "url": "https://anilist.co/manga/30025"
        },
        {
          "relation_type": "SIDE_STORY",
          "id": 6421,
          "mal_id": 6421,
          "type": "ANIME",
          "format": "OVA",
          "status": "FINISHED",
          "title": {
            "romaji": "[trimmed-depth]",
            "english": "[trimmed-depth]",
            "native": "[trimmed-depth]",
            "user_preferred": "[trimmed-depth]"
          },
          "cover_image": {
            "extra_large": "[trimmed-depth]",
            "large": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "color": "[trimmed-depth]"
          },
          "start_date": "2009-08-26",
          "season": "SUMMER",
          "season_year": 2009,
          "episodes": 4,
          "chapters": null,
          "volumes": null,
          "weighted_score": 77,
          "average_score": 77,
          "mean_score": 77,
          "popularity": 29966,
          "favourites": 142,
          "is_adult": false,
          "url": "https://anilist.co/anime/6421"
        },
        {
          "relation_type": "SIDE_STORY",
          "id": 9135,
          "mal_id": 9135,
          "type": "ANIME",
          "format": "MOVIE",
          "status": "FINISHED",
          "title": {
            "romaji": "[trimmed-depth]",
            "english": "[trimmed-depth]",
            "native": "[trimmed-depth]",
            "user_preferred": "[trimmed-depth]"
          },
          "cover_image": {
            "extra_large": "[trimmed-depth]",
            "large": "[trimmed-depth]",
            "medium": "[trimmed-depth]",
            "color": "[trimmed-depth]"
          },
          "start_date": "2011-07-02",
          "season": "SUMMER",
          "season_year": 2011,
          "episodes": 1,
          "chapters": null,
          "volumes": null,
          "weighted_score": 69,
          "average_score": 69,
          "mean_score": 69,
          "popularity": 40095,
          "favourites": 235,
          "is_adult": false,
          "url": "https://anilist.co/anime/9135"
        }
      ],
      "characters": {
        "results": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "gender": "[trimmed-depth]",
            "age": "[trimmed-depth]",
            "role": "[trimmed-depth]",
            "name_in_this_title": "[trimmed-depth]",
            "voice_actors": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "gender": "[trimmed-depth]",
            "age": "[trimmed-depth]",
            "role": "[trimmed-depth]",
            "name_in_this_title": "[trimmed-depth]",
            "voice_actors": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "gender": "[trimmed-depth]",
            "age": "[trimmed-depth]",
            "role": "[trimmed-depth]",
            "name_in_this_title": "[trimmed-depth]",
            "voice_actors": "[trimmed-depth]"
          }
        ],
        "has_more": true,
        "total": null
      },
      "staff": {
        "results": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "language": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "primary_occupations": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "role": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "language": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "primary_occupations": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "role": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "name_native": "[trimmed-depth]",
            "name_preferred": "[trimmed-depth]",
            "language": "[trimmed-depth]",
            "image": "[trimmed-depth]",
            "primary_occupations": "[trimmed-depth]",
            "favourites": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "role": "[trimmed-depth]"
          }
        ],
        "has_more": true,
        "total": null
      },
      "recommendations": {
        "results": [
          {
            "recommendation_id": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "media": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          },
          {
            "recommendation_id": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "media": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          },
          {
            "recommendation_id": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "media": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          }
        ],
        "has_more": true,
        "total": null
      },
      "reviews": {
        "results": [
          {
            "id": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "summary": "[trimmed-depth]",
            "score": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "rating_amount": "[trimmed-depth]",
            "created_at": "[trimmed-depth]",
            "updated_at": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "summary": "[trimmed-depth]",
            "score": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "rating_amount": "[trimmed-depth]",
            "created_at": "[trimmed-depth]",
            "updated_at": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "url": "[trimmed-depth]",
            "summary": "[trimmed-depth]",
            "score": "[trimmed-depth]",
            "rating": "[trimmed-depth]",
            "rating_amount": "[trimmed-depth]",
            "created_at": "[trimmed-depth]",
            "updated_at": "[trimmed-depth]",
            "user": "[trimmed-depth]"
          }
        ],
        "has_more": true,
        "total": null
      }
    }
  }
}
Actions

What the AniList API does

ActionDescriptionConcrete use caseKey params
mediaEverything AniList publishes about one anime or manga: every title and synonym, description, format, status, dates, season, episodes / duration / chapters / volumes, source, country, Weighted Score (the page's headline score), Mean Score, popularity, favourites, trending, all-time / yearly / seasonal rankings, score distribution, list-status distribution, genres, every tag with its rank and spoiler flags, studios and producers, trailer, next episode and its air time, external and streaming links, streaming episodes, every related title, and the first page of characters (with voice actors), staff, recommendations and reviews. Look up by AniList id, anilist.co link or MyAnimeList id.Content platforms call media to get everything AniList publishes about one anime or manga.media, mal_id, type, voice_actor_language
media_batchUp to 50 titles in one call by AniList ids or MyAnimeList ids — AniList answers all of them in one request. Ids AniList does not have come back in `not_found_ids`.Research tools call media_batch to get up to 50 titles in one call by AniList ids or MyAnimeList ids.ids, mal_ids, type
search_mediaSearch and browse anime or manga with every filter anilist.co's own browse page has: text, genres and tags (include and exclude), tag category, minimum tag rank, format, airing / publishing status, season and year, a start-date range, country of origin, source material, streaming service, licensed-only, adult content, and ranges for score, popularity, episodes, duration, chapters and volumes; sorted by relevance, popularity, score, trending, favourites, date, title and more. Covers trending, top rated, most popular and seasonal charts (pick the sort / season). AniList serves the first 5000 results of a query. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Community analysts call search_media to search and browse anime or manga with every filter anilist.co's own browse page has.query, type, genres, exclude_genres, tags, ...
media_charactersEvery character of a title, main characters first, each with its voice actors (one language or all dubs). Pages through the full cast. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call media_characters to get every character of a title, main characters first, each with its voice actors (one language o….media, role, voice_actor_language, sort, page, ...
media_staffEvery staff credit of a title (director, original creator, composer, animation director …) with the person's role on it. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call media_staff to get every staff credit of a title (director, original creator, composer, animation director …) wi….media, sort, page, per_page
media_trendsA title's daily trend history as AniList records it: trending score, weighted score, popularity, users watching / reading that day, the episode that aired, and whether it was releasing. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Research tools call media_trends to get a title's daily trend history as AniList records it.media, releasing, sort, page, per_page
media_airing_scheduleEvery episode air time AniList has for an anime (past and upcoming), in episode order. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Community analysts call media_airing_schedule to get every episode air time AniList has for an anime (past and upcoming), in episode order.media, not_yet_aired, page, per_page
airing_scheduleThe airing calendar: every anime episode airing in a time window (default: the next 7 days), soonest first, each with its title. Narrow it to one title with `media`. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call airing_schedule to get the airing calendar.from, to, media, sort, page, ...
reviewsUser reviews with their full text — of one title, by one user, or the newest on the whole site (anilist.co/reviews) — each with its score out of 100, the up-votes (`rating`) out of all votes (`rating_amount`), the reviewer and the title. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call reviews to get user reviews with their full text.media, user, type, sort, page, ...
reviewOne review in full: text, score, votes, reviewer and the title.Research tools call review to get one review in full.review
recommendationsUser recommendations — for one title ("Recommendations" on its page), made by one user, or the newest site-wide (anilist.co/recommendations) — each pair with its vote total (`rating`). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Community analysts call recommendations to get user recommendations.media, user, rating_min, sort, page, ...
characterA character: every name and alias (spoiler aliases flagged separately), description, gender, birthday, age, blood type, favourites, image, and the first page of titles it appears in with its role and voice actors.Media monitors call character to get a character.character
character_mediaEvery title a character appears in, with its role there and the voice actors who played it. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call character_media to get every title a character appears in, with its role there and the voice actors who played it.character, type, sort, page, per_page
search_charactersSearch characters by name (also aliases), or list the characters whose birthday is today; sorted by relevance or favourites. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Research tools call search_characters to search characters by name (also aliases), or list the characters whose birthday is today; sor….query, birthday_today, sort, page, per_page
staffA person (voice actor, director, author, composer …): names, language, occupations, gender, birth / death dates, age, years active, home town, blood type, favourites, description, and the first page of their voice roles and production credits.Community analysts call staff to get a person (voice actor, director, author, composer …).staff
staff_charactersEvery character a voice actor played, grouped by title (anilist.co's "Characters" tab on a staff page): one row per title and role, so a title where they voiced a main and a supporting character comes twice. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call staff_characters to get every character a voice actor played, grouped by title (anilist.co's "Characters" tab on a st….staff, sort, page, per_page
staff_mediaEvery production credit of a person (anilist.co's "Anime / Manga Staff Roles"): title and role. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call staff_media to get every production credit of a person (anilist.co's "Anime / Manga Staff Roles").staff, type, sort, page, per_page
search_staffSearch people (voice actors, directors, authors …) by name, or list those whose birthday is today. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Research tools call search_staff to search people (voice actors, directors, authors …) by name, or list those whose birthday is t….query, birthday_today, sort, page, per_page
studioA studio: name, animation studio or not, favourites, and the first page of its titles.Community analysts call studio to get a studio.studio
studio_mediaEvery title of a studio, newest first by default, with whether it was the main studio. A title can come twice when AniList credits the studio both as main studio and as producer on it (8 of 25 rows on Madhouse's first page, measured; `main_only` keeps the main-studio credit). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call studio_media to get every title of a studio, newest first by default, with whether it was the main studio.studio, main_only, sort, page, per_page
search_studiosSearch studios by name. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call search_studios to search studios by name.query, sort, page, per_page
userA public AniList profile: bio, avatar, banner, join date, donator badge, previous names, list settings (score format, custom lists), anime and manga totals (count, mean score, days watched, episodes, chapters, volumes) and the first page of each favourites list.Research tools call user to get a public AniList profile.user
user_statisticsA user's full anime or manga statistics as their profile's Stats tab shows them: totals plus breakdowns by format, status, score, length, release year, start year, genre, tag, country, voice actor, staff and studio — each with count, mean score and time spent.Community analysts call user_statistics to get a user's full anime or manga statistics as their profile's Stats tab shows them.user, type, per_dimension, include_media_ids
user_favouritesOne of a user's favourites lists (anime, manga, characters, staff or studios), in the user's own order. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call user_favourites to get one of a user's favourites lists (anime, manga, characters, staff or studios), in the user's….user, kind, page, per_page
user_listA user's public anime or manga list: status, score (in the user's own format and out of 100), progress, rewatches, dates, notes, custom lists and the title. A private list is NOT_FOUND. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call user_list to get a user's public anime or manga list.user, type, status, sort, page, ...
user_followersUsers who follow a user. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Research tools call user_followers to get users who follow a user.user, sort, page, per_page
user_followingUsers a user follows. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Community analysts call user_following to get users a user follows.user, sort, page, per_page
search_usersSearch users by name, or rank them by time watched / chapters read. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Media monitors call search_users to search users by name, or rank them by time watched / chapters read.query, sort, page, per_page
activitiesThe activity feed — site-wide (anilist.co's "Global Activity"), one user's, or one title's — status posts, list updates ("watched episode 5 of …") and profile messages, each with likes and reply counts. A page can hold fewer rows than `per_page` (AniList leaves out hidden entries: 22-23 of 25 measured); the next page still continues without overlap. `type` cannot be combined with `media` (AniList answers HTTP 500). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call activities to get the activity feed.user, media, type, has_replies, sort, ...
activityOne activity with every reply and the users who liked it.Research tools call activity to get one activity with every reply and the users who liked it..activity
threadsForum threads — search them, or list a category, a title's discussion threads, or one user's; sorted by last reply, newest, views, replies … `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Community analysts call threads to get forum threads.query, category, media, user, sort, ...
threadOne forum thread: title, full opening post, counts, author, categories and titles it is about.Media monitors call thread to get one forum thread.thread
thread_commentsA thread's comments in order, each with its nested reply tree (as anilist.co shows them). Page 1 can hold more than `per_page` top-level comments: AniList lifts some later comments onto page 1 (22 rows for per_page 10, measured) and does not repeat them on later pages; `total` is given only for a one-page thread.Content platforms call thread_comments to get a thread's comments in order, each with its nested reply tree (as anilist.co shows them).thread, page, per_page
genresEvery genre AniList uses (the values `search_media` `genres` takes).Research tools call genres to get every genre AniList uses (the values `search_media` `genres` takes)..none
tagsAniList's full tag catalogue: name, description, category, adult flag and whether it is a general spoiler (the values `search_media` `tags` and `tag_category` take).Community analysts call tags to get aniList's full tag catalogue.category, adult
streaming_servicesStreaming services and other link sources AniList knows (the values `search_media` `streaming_on` takes).Media monitors call streaming_services to get streaming services and other link sources AniList knows (the values `search_media` `streaming….type, media_type
site_statisticsAniList's own daily site statistics: total count and daily change of users, anime, manga, characters, staff, studios or reviews. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.Content platforms call site_statistics to get aniList's own daily site statistics.kind, page, per_page
Code samples

Call media from your stack

curl -X POST https://api.reefapi.com/anilist/v1/media \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"media":5114}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.anilist.media with {"media":5114}.
Use cases

Who uses this API and why

  • Track score, popularity and favourites of a season's anime every day from its first episode.
  • Build a seasonal or genre chart with search filters and AniList's own rankings.
  • Map MyAnimeList ids to AniList records, 50 at a time.
  • Collect characters, voice actors in every dub and staff credits for a title or a person.
  • Read reviews, recommendations and public user lists for audience and taste research.
FAQ

Questions developers ask before integrating

Do I need an AniList account or API key?

No. Everything is read logged out; you only need a ReefAPI key.

Is the score the same one anilist.co shows?

Yes. weighted_score is the page's Weighted Score and mean_score its Mean Score; both matched the title page on 10 of 10 titles checked in the same minute. popularity and favourites are the page's Popularity and Favorites.

Can I look a title up by its MyAnimeList id?

Yes. media takes mal_id (set type to manga for a MyAnimeList manga id), and media_batch takes up to 50 MyAnimeList ids in one call. Every record also returns mal_id and the MyAnimeList link.

Which search filters are there?

The ones anilist.co's browse page has: text, genres and tags (all of, and none of), tag category, minimum tag rank, format, airing status, season and season year, start year or a start-date range, country of origin (JP, KR, CN, TW), source material, streaming service, licensed only, adult content, and minimum and maximum score, popularity, episodes, episode length, chapters and volumes. Measured on the 127 anime of fall 2025: TV only 46, action 32, isekai 17, score 75 or more 21, on Crunchyroll 42.

How far does a search go?

AniList serves the first 5,000 results of a list (100 pages of 50). Narrow the filters to reach the rest. Consecutive pages had no title in common in every list measured.

Do I get voice actors in every language?

Yes. media_characters returns each character with its voice actors in every dub by default (Fullmetal Alchemist: Brotherhood, first 25 characters: 223 voice actors in 9 languages), or one language with voice_actor_language.

Can I read a user's anime list?

Yes, if the list is public: user_list returns every entry with status, the user's score in their own format and out of 100, progress, rewatches, start and finish dates, notes and custom lists. user_statistics returns the profile's stats by genre, tag, format, year, studio, staff and voice actor. A private list comes back as not found.

When does the next episode air?

media returns next_airing_episode, media_airing_schedule lists every episode air time of a title, and airing_schedule returns the whole calendar for a time window (the next 7 days by default).

What is the AniList API?

AniList API is a ReefAPI endpoint group for anime and manga scores, popularity, rankings, airing schedule, characters and voice actors, staff, studios, reviews and user lists. It returns live JSON through POST requests under /anilist/v1.

Is the AniList API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. AniList calls use the same shared credit balance as every other ReefAPI engine.

Do I need an AniList login or account?

No login to AniList is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the AniList data?

The page example is captured from a live media call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the AniList API use?

AniList actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call AniList from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call anilist actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / anilist

AniList

Anime and manga scores, popularity, rankings, airing schedule, characters and voice actors, staff, studios, reviews and user lists.

base /anilist/v137 endpoints
post/anilist/v1/media1 credit

Everything AniList publishes about one anime or manga: every title and synonym, description, format, status, dates, season, episodes / duration / chapters / volumes, source, country, Weighted Score (the page's headline score), Mean Score, popularity, favourites, trending, all-time / yearly / seasonal rankings, score distribution, list-status distribution, genres, every tag with its rank and spoiler flags, studios and producers, trailer, next episode and its air time, external and streaming links, streaming episodes, every related title, and the first page of characters (with voice actors), staff, recommendations and reviews. Look up by AniList id, anilist.co link or MyAnimeList id.

ParameterAllowed / rangeDescription
mediaoptional—AniList title id or anilist.co/anime/… or /manga/… link. Give this or `mal_id`.
mal_idoptional—MyAnimeList id instead of the AniList id (MAL numbers anime and manga separately — set `type` for a manga; anime is assumed).
typeoptionalanime · mangaWith `mal_id`: anime (default) or manga.
voice_actor_language = japaneseoptionaljapanese · english · korean · italian · spanish · portuguese · french · german · hebrew · hungarian · allVoice actors shown with the character preview (`all` = every dub; `media_characters` pages through every character).
Try in playground →
post/anilist/v1/media_batch1 credit

Up to 50 titles in one call by AniList ids or MyAnimeList ids — AniList answers all of them in one request. Ids AniList does not have come back in `not_found_ids`.

ParameterAllowed / rangeDescription
idsoptional—1-50 AniList title ids (array or comma-separated). Give this or `mal_ids`.
mal_idsoptional—1-50 MyAnimeList ids instead (with `type`).
typeoptionalanime · mangaWith `mal_ids`: anime (default) or manga.
Try in playground →
post/anilist/v1/search_media1 credit

Search and browse anime or manga with every filter anilist.co's own browse page has: text, genres and tags (include and exclude), tag category, minimum tag rank, format, airing / publishing status, season and year, a start-date range, country of origin, source material, streaming service, licensed-only, adult content, and ranges for score, popularity, episodes, duration, chapters and volumes; sorted by relevance, popularity, score, trending, favourites, date, title and more. Covers trending, top rated, most popular and seasonal charts (pick the sort / season). AniList serves the first 5000 results of a query. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
type = animeoptionalanime · mangaAnime or manga (default anime).
genresoptional—Titles carrying ALL of these genres (case does not matter; `genres` lists them).
exclude_genresoptional—Titles carrying none of these genres.
tagsoptional—Titles carrying ALL of these tags (names as in `tags`; case does not matter; an unknown tag is an error, not 0 rows).
exclude_tagsoptional—Titles carrying none of these tags.
tag_categoryoptional—Titles with a tag in this category (as `tags` lists them).
minimum_tag_rankoptional1–100With `tags`: the tag's rank on the title must be at least this (anilist.co's "minimum tag percentage").
formatoptionaltv · tv_short · movie · special · ova · ona · music · manga · novel · one_shotFormat(s); several allowed.
statusoptionalfinished · releasing · not_yet_released · cancelled · hiatusAiring / publishing status; several allowed.
seasonoptionalwinter · spring · summer · fallAnime season (with `season_year`).
season_yearoptional1940–2100Anime season year.
yearoptional1900–2100Started in this year (any season; works for manga too).
start_date_fromoptional—Started on or after this date (YYYY, YYYY-MM or YYYY-MM-DD).
start_date_tooptional—Started on or before this date.
countryoptionalJP · KR · CN · TWCountry of origin (JP, KR, CN, TW).
sourceoptionaloriginal · manga · light_novel · visual_novel · video_game · other · novel · doujinshi · anime · web_novel · live_action · game · comic · multimedia_project · picture_bookSource material; several allowed.
streaming_onoptional—Available on these streaming services (names as `streaming_services` lists them; case does not matter).
licensedoptionaltrue · falsetrue = licensed titles only; false = unlicensed only (manga: anilist.co's "doujin" toggle).
adult = falseoptionalfalse · true · anyAdult content: `false` hides it (anilist.co's default for visitors), `true` = adult only, `any` = both.
score_minoptional0–100Weighted score (as the page shows it) at least this, 0-100. With a score range, titles AniList has not scored yet are left out.
score_maxoptional0–100Weighted score at most this.
popularity_minoptional0–Popularity (users with it on their list) at least this.
popularity_maxoptional0–Popularity at most this.
episodes_minoptional0–At least this many episodes.
episodes_maxoptional0–At most this many episodes.
duration_minoptional0–Episode length at least this many minutes.
duration_maxoptional0–Episode length at most this.
chapters_minoptional0–Manga: at least this many chapters.
chapters_maxoptional0–Manga: at most this many chapters.
volumes_minoptional0–Manga: at least this many volumes.
volumes_maxoptional0–Manga: at most this many volumes.
sortoptionalrelevance · popularity · popularity_asc · score · score_asc · trending · favourites · newest · oldest · end_date · title · title_desc · title_english · title_native · episodes · episodes_asc · chapters · volumes · duration · updated · id · id_descOrder. Default: relevance with `query`, popularity without.
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50Titles per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/media_characters1 credit

Every character of a title, main characters first, each with its voice actors (one language or all dubs). Pages through the full cast. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
mediarequired—AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
roleoptionalmain · supporting · backgroundMain, supporting or background characters only.
voice_actor_language = alloptionaljapanese · english · korean · italian · spanish · portuguese · french · german · hebrew · hungarian · allVoice actors in this language only (`all` = every dub).
sort = roleoptionalrole · relevance · favourites · id · id_descOrder (default: role, then relevance, as anilist.co shows them).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Characters per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/media_staff1 credit

Every staff credit of a title (director, original creator, composer, animation director …) with the person's role on it. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
mediarequired—AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
sort = relevanceoptionalrelevance · role · language · favourites · id · id_descOrder.
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Staff per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/media_airing_schedule1 credit

Every episode air time AniList has for an anime (past and upcoming), in episode order. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
mediarequired—AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
not_yet_airedoptionaltrue · falsetrue = upcoming episodes only; false = aired only.
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Episodes per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/airing_schedule1 credit

The airing calendar: every anime episode airing in a time window (default: the next 7 days), soonest first, each with its title. Narrow it to one title with `media`. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
fromoptional—Window start: ISO date / date-time or unix seconds (default now).
tooptional—Window end (default `from` + 7 days).
mediaoptional—Only rows about this title (AniList id or anilist.co link).
sort = timeoptionaltime · time_desc · episode · episode_desc · media_idOrder (default soonest first).
page = 1optional1–5000Page number, 1-based.
per_page = 50optional1–50Episodes per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/reviews1 credit

User reviews with their full text — of one title, by one user, or the newest on the whole site (anilist.co/reviews) — each with its score out of 100, the up-votes (`rating`) out of all votes (`rating_amount`), the reviewer and the title. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
mediaoptional—Only rows about this title (AniList id or anilist.co link).
useroptional—Only rows by this user (name, id or anilist.co/user/… link).
typeoptionalanime · mangaAnime or manga reviews only.
sort = newestoptionalnewest · oldest · rating · rating_asc · score · score_asc · updatedOrder (default: newest; anilist.co shows a title's reviews by rating).
page = 1optional1–5000Page number, 1-based.
per_page = 10optional1–25Reviews per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/review1 credit

One review in full: text, score, votes, reviewer and the title.

ParameterAllowed / rangeDescription
reviewrequired—AniList review id or anilist.co review link.
Try in playground →
post/anilist/v1/recommendations1 credit

User recommendations — for one title ("Recommendations" on its page), made by one user, or the newest site-wide (anilist.co/recommendations) — each pair with its vote total (`rating`). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
mediaoptional—Only rows about this title (AniList id or anilist.co link).
useroptional—Only rows by this user (name, id or anilist.co/user/… link).
rating_minoptional—Only pairs with more than this many net votes.
sortoptionalrating · rating_asc · newest · oldestOrder (default: highest rated with `media`, newest otherwise).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–50Recommendations per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/character1 credit

A character: every name and alias (spoiler aliases flagged separately), description, gender, birthday, age, blood type, favourites, image, and the first page of titles it appears in with its role and voice actors.

ParameterAllowed / rangeDescription
characterrequired—AniList character id or anilist.co character link.
Try in playground →
post/anilist/v1/character_media1 credit

Every title a character appears in, with its role there and the voice actors who played it. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
characterrequired—AniList character id or anilist.co character link.
typeoptionalanime · mangaAnime or manga appearances only.
sort = popularityoptionalrelevance · popularity · popularity_asc · score · score_asc · trending · favourites · newest · oldest · end_date · title · title_desc · title_english · title_native · episodes · episodes_asc · chapters · volumes · duration · updated · id · id_descOrder (default popularity).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/search_characters1 credit

Search characters by name (also aliases), or list the characters whose birthday is today; sorted by relevance or favourites. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
birthday_todayoptionaltrue · falsetrue = characters whose birthday is today.
sortoptionalrelevance · favourites · id · id_descOrder (default: relevance with `query`, favourites without).
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50Characters per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/staff1 credit

A person (voice actor, director, author, composer …): names, language, occupations, gender, birth / death dates, age, years active, home town, blood type, favourites, description, and the first page of their voice roles and production credits.

ParameterAllowed / rangeDescription
staffrequired—AniList staff id or anilist.co staff link.
Try in playground →
post/anilist/v1/staff_characters1 credit

Every character a voice actor played, grouped by title (anilist.co's "Characters" tab on a staff page): one row per title and role, so a title where they voiced a main and a supporting character comes twice. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
staffrequired—AniList staff id or anilist.co staff link.
sort = newestoptionalrelevance · popularity · popularity_asc · score · score_asc · trending · favourites · newest · oldest · end_date · title · title_desc · title_english · title_native · episodes · episodes_asc · chapters · volumes · duration · updated · id · id_descOrder (default: newest first).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/staff_media1 credit

Every production credit of a person (anilist.co's "Anime / Manga Staff Roles"): title and role. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
staffrequired—AniList staff id or anilist.co staff link.
typeoptionalanime · mangaAnime or manga credits only.
sort = newestoptionalrelevance · popularity · popularity_asc · score · score_asc · trending · favourites · newest · oldest · end_date · title · title_desc · title_english · title_native · episodes · episodes_asc · chapters · volumes · duration · updated · id · id_descOrder (default: newest first).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Credits per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/search_staff1 credit

Search people (voice actors, directors, authors …) by name, or list those whose birthday is today. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
birthday_todayoptionaltrue · falsetrue = people whose birthday is today.
sortoptionalrelevance · favourites · id · id_descOrder (default: relevance with `query`, favourites without).
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50People per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/studio1 credit

A studio: name, animation studio or not, favourites, and the first page of its titles.

ParameterAllowed / rangeDescription
studiorequired—AniList studio id or anilist.co studio link.
Try in playground →
post/anilist/v1/studio_media1 credit

Every title of a studio, newest first by default, with whether it was the main studio. A title can come twice when AniList credits the studio both as main studio and as producer on it (8 of 25 rows on Madhouse's first page, measured; `main_only` keeps the main-studio credit). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
studiorequired—AniList studio id or anilist.co studio link.
main_onlyoptionaltrue · falsetrue = only titles where it was the main studio.
sort = newestoptionalrelevance · popularity · popularity_asc · score · score_asc · trending · favourites · newest · oldest · end_date · title · title_desc · title_english · title_native · episodes · episodes_asc · chapters · volumes · duration · updated · id · id_descOrder (default newest).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/search_studios1 credit

Search studios by name. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
sortoptionalrelevance · name · name_desc · favourites · id · id_descOrder (default: relevance with `query`, favourites without).
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50Studios per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/user1 credit

A public AniList profile: bio, avatar, banner, join date, donator badge, previous names, list settings (score format, custom lists), anime and manga totals (count, mean score, days watched, episodes, chapters, volumes) and the first page of each favourites list.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
Try in playground →
post/anilist/v1/user_statistics1 credit

A user's full anime or manga statistics as their profile's Stats tab shows them: totals plus breakdowns by format, status, score, length, release year, start year, genre, tag, country, voice actor, staff and studio — each with count, mean score and time spent.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
type = animeoptionalanime · mangaAnime or manga.
per_dimensionoptional1–100Rows per breakdown, 1-100 (default 100; AniList serves at most 100 rows per breakdown, measured: 500 → 100).
include_media_ids = falseoptionaltrue · falsetrue = every breakdown row also lists the title ids it counts (large for big lists).
Try in playground →
post/anilist/v1/user_favourites1 credit

One of a user's favourites lists (anime, manga, characters, staff or studios), in the user's own order. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
kind = animeoptionalanime · manga · characters · staff · studiosWhich favourites list.
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Favourites per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/user_list1 credit

A user's public anime or manga list: status, score (in the user's own format and out of 100), progress, rewatches, dates, notes, custom lists and the title. A private list is NOT_FOUND. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
type = animeoptionalanime · mangaAnime or manga list.
statusoptionalcurrent · planning · completed · dropped · paused · repeatingOnly entries with this status (watching / reading = current); several allowed.
sort = updatedoptionalupdated · added · score · score_asc · progress · title · title_english · popularity · started · finished · repeat · priority · media_idOrder (default: last updated first).
page = 1optional1–5000Page number, 1-based.
per_page = 50optional1–50Entries per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/user_followers1 credit

Users who follow a user. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
sort = id_descoptionalrelevance · name · name_desc · watched_time · chapters_read · id · id_descOrder (default: newest account first).
page = 1optional1–5000Page number, 1-based.
per_page = 50optional1–50Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/user_following1 credit

Users a user follows. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
userrequired—AniList user name, numeric user id or anilist.co/user/… link.
sort = id_descoptionalrelevance · name · name_desc · watched_time · chapters_read · id · id_descOrder (default: newest account first).
page = 1optional1–5000Page number, 1-based.
per_page = 50optional1–50Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/search_users1 credit

Search users by name, or rank them by time watched / chapters read. AniList serves the first 5000 results. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
sortoptionalrelevance · name · name_desc · watched_time · chapters_read · id · id_descOrder (default: relevance with `query`, most time watched without).
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/activities1 credit

The activity feed — site-wide (anilist.co's "Global Activity"), one user's, or one title's — status posts, list updates ("watched episode 5 of …") and profile messages, each with likes and reply counts. A page can hold fewer rows than `per_page` (AniList leaves out hidden entries: 22-23 of 25 measured); the next page still continues without overlap. `type` cannot be combined with `media` (AniList answers HTTP 500). `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
useroptional—Only rows by this user (name, id or anilist.co/user/… link).
mediaoptional—Only rows about this title (AniList id or anilist.co link).
typeoptionaltext · anime_list · manga_list · message · media_listActivity type; several allowed (`media_list` = anime and manga list updates).
has_repliesoptionaltrue · falsetrue = only activities with replies.
sort = newestoptionalnewest · oldest · pinnedOrder (default newest).
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–50Activities per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/activity1 credit

One activity with every reply and the users who liked it.

ParameterAllowed / rangeDescription
activityrequired—AniList activity id or anilist.co activity link.
Try in playground →
post/anilist/v1/threads1 credit

Forum threads — search them, or list a category, a title's discussion threads, or one user's; sorted by last reply, newest, views, replies … `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
queryoptional—Search text, matched the way anilist.co's search box matches it.
categoryoptionalanime · manga · light_novels · visual_novels · release_discussion · general · news · music · gaming · site_feedback · bug_reports · site_announcements · list_customisation · recommendations · forum_games · misc · anilist_appsForum category (name or AniList category id).
mediaoptional—Only rows about this title (AniList id or anilist.co link).
useroptional—Only rows by this user (name, id or anilist.co/user/… link).
sortoptionalreplied · newest · oldest · updated · replies · views · title · sticky · relevanceOrder (default: last reply first; relevance with `query`).
page = 1optional1–5000Page number, 1-based.
per_page = 20optional1–50Threads per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/thread1 credit

One forum thread: title, full opening post, counts, author, categories and titles it is about.

ParameterAllowed / rangeDescription
threadrequired—AniList thread id or anilist.co thread link.
Try in playground →
post/anilist/v1/thread_comments1 credit

A thread's comments in order, each with its nested reply tree (as anilist.co shows them). Page 1 can hold more than `per_page` top-level comments: AniList lifts some later comments onto page 1 (22 rows for per_page 10, measured) and does not repeat them on later pages; `total` is given only for a one-page thread.

ParameterAllowed / rangeDescription
threadrequired—AniList thread id or anilist.co thread link.
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–50Comments per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
post/anilist/v1/genresfree

Every genre AniList uses (the values `search_media` `genres` takes).

Try in playground →
post/anilist/v1/tagsfree

AniList's full tag catalogue: name, description, category, adult flag and whether it is a general spoiler (the values `search_media` `tags` and `tag_category` take).

ParameterAllowed / rangeDescription
categoryoptional—Only tags in categories containing this text.
adult = anyoptionalfalse · true · anyAdult tags: false hides them, true = only them, any = all (default).
Try in playground →
post/anilist/v1/streaming_services1 credit

Streaming services and other link sources AniList knows (the values `search_media` `streaming_on` takes).

ParameterAllowed / rangeDescription
type = streamingoptionalstreaming · info · socialLink type (default streaming).
media_type = animeoptionalanime · mangaSources for anime or manga.
Try in playground →
post/anilist/v1/site_statistics1 credit

AniList's own daily site statistics: total count and daily change of users, anime, manga, characters, staff, studios or reviews. `total` is the exact count only on the last page — AniList publishes no exact count while more pages remain (it reports a placeholder there), so `total` is null until then and `total_at_least` says how many exist at minimum.

ParameterAllowed / rangeDescription
kind = usersoptionalusers · anime · manga · characters · staff · studios · reviewsWhich statistic.
page = 1optional1–5000Page number, 1-based.
per_page = 25optional1–25Days per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.