AniList API & Scraper
This API reads AniList, the anime and manga database, as JSON with no account and no AniList key.
🤖 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.
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.
| Field | What it holds |
|---|---|
| weighted_score | The 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_score | AniList'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_score | The page's "Mean Score": the plain average of user scores. Equal to the page on 10 of 10 titles. |
| popularity | The 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). |
| favourites | The page's "Favorites". Equal to the page on 10 of 10 titles. |
| main_studios, producers | anilist.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_spoiler | Every tag is returned, including the ones anilist.co hides as spoilers; is_general_spoiler and is_media_spoiler say which kind. |
| rankings | The "#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_episode | Episode number, air time (UTC and unix) and seconds until it airs, for titles that are airing. |
| total, total_at_least | AniList 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.
Real request and response JSON
Captured from the indexed primary action, media, on .
{
"method": "POST",
"url": "https://api.reefapi.com/anilist/v1/media",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"media": 5114
}
}{
"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
}
}
}
}What the AniList API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| media | 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. | Content platforms call media to get everything AniList publishes about one anime or manga. | media, mal_id, type, voice_actor_language |
| media_batch | 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`. | 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_media | 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. | 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_characters | 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. | 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_staff | 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. | 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_trends | A 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_schedule | 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. | 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_schedule | 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. | Media monitors call airing_schedule to get the airing calendar. | from, to, media, sort, page, ... |
| reviews | 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. | Content platforms call reviews to get user reviews with their full text. | media, user, type, sort, page, ... |
| review | One review in full: text, score, votes, reviewer and the title. | Research tools call review to get one review in full. | review |
| recommendations | 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. | Community analysts call recommendations to get user recommendations. | media, user, rating_min, sort, page, ... |
| character | 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. | Media monitors call character to get a character. | character |
| character_media | 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. | 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_characters | 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. | 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 |
| staff | 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. | Community analysts call staff to get a person (voice actor, director, author, composer …). | staff |
| staff_characters | 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. | 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_media | 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. | 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_staff | 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. | 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 |
| studio | A studio: name, animation studio or not, favourites, and the first page of its titles. | Community analysts call studio to get a studio. | studio |
| studio_media | 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. | 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_studios | 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. | Content platforms call search_studios to search studios by name. | query, sort, page, per_page |
| user | 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. | Research tools call user to get a public AniList profile. | user |
| user_statistics | 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. | 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_favourites | 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. | 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_list | 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. | Content platforms call user_list to get a user's public anime or manga list. | user, type, status, sort, page, ... |
| user_followers | 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. | Research tools call user_followers to get users who follow a user. | user, sort, page, per_page |
| user_following | 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. | Community analysts call user_following to get users a user follows. | user, sort, page, per_page |
| search_users | 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. | Media monitors call search_users to search users by name, or rank them by time watched / chapters read. | query, sort, page, per_page |
| activities | 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. | Content platforms call activities to get the activity feed. | user, media, type, has_replies, sort, ... |
| activity | One 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 |
| threads | 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. | Community analysts call threads to get forum threads. | query, category, media, user, sort, ... |
| thread | One 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_comments | 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. | 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 |
| genres | Every 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 |
| tags | 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). | Community analysts call tags to get aniList's full tag catalogue. | category, adult |
| streaming_services | Streaming 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_statistics | 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. | Content platforms call site_statistics to get aniList's own daily site statistics. | kind, page, per_page |
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}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/anilist/v1/media",
headers={"x-api-key": REEF_KEY},
json={
"media": 5114
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/anilist/v1/media", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"media": 5114
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.anilist.media with {"media":5114}.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.
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.