AniList API

Scores, rankings, airing times and characters from AniList, no account

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

endpoints
37
credits per call
0–1

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

POST/anilist/v1/media200
  1. 2529
    score
    10
  2. 329
    score
    20
  3. 592
    score
    30
Real result, captured Nov 16, 2026
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

AniList API

5 of 37 endpoints, ready to run

View docs ↗

Everything about one anime or manga

1 credit0 required · 2 optional
POST/anilist/v1/media
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What AniList endpoints does ReefAPI ship?

37 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

37 endpoints

media

1 cr

Everything AniList publishes about one anime or manga.

required
—
optional
media, mal_id, type, voice_actor_language

media_batch

1 cr

Up to 50 titles in one call by AniList ids or MyAnimeList ids.

required
—
optional
ids, mal_ids, type

search_media

1 cr

Search and browse anime or manga with every filter anilist.co's own browse page has.

required
—
optional
query, type, genres, exclude_genres, tags, exclude_tags, tag_category, minimum_tag_rank, format, status, season, season_year, year, start_date_from, start_date_to, country, source, streaming_on, licensed, adult, score_min, score_max, popularity_min, popularity_max, episodes_min, episodes_max, duration_min, duration_max, chapters_min, chapters_max, volumes_min, volumes_max, sort, page, per_page

media_characters

1 cr

Every character of a title, main characters first, each with its voice actors (one language o…

required
media
optional
role, voice_actor_language, sort, page, per_page

media_staff

1 cr

Every staff credit of a title (director, original creator, composer, animation director …) wi…

required
media
optional
sort, page, per_page

media_trends

1 cr

A title's daily trend history as AniList records it.

required
media
optional
releasing, sort, page, per_page

media_airing_schedule

1 cr

Every episode air time AniList has for an anime (past and upcoming), in episode order.

required
media
optional
not_yet_aired, page, per_page

airing_schedule

1 cr

The airing calendar.

required
—
optional
from, to, media, sort, page, per_page

reviews

1 cr

User reviews with their full text.

required
—
optional
media, user, type, sort, page, per_page

review

1 cr

One review in full.

required
review
optional
—

recommendations

1 cr

User recommendations.

required
—
optional
media, user, rating_min, sort, page, per_page

character

1 cr

A character.

required
character
optional
—

character_media

1 cr

Every title a character appears in, with its role there and the voice actors who played it.

required
character
optional
type, sort, page, per_page

search_characters

1 cr

Search characters by name (also aliases), or list the characters whose birthday is today.

required
—
optional
query, birthday_today, sort, page, per_page

staff

1 cr

A person (voice actor, director, author, composer …).

required
staff
optional
—

staff_characters

1 cr

Every character a voice actor played, grouped by title (anilist.co's "Characters" tab on a st…

required
staff
optional
sort, page, per_page

staff_media

1 cr

Every production credit of a person (anilist.co's "Anime / Manga Staff Roles").

required
staff
optional
type, sort, page, per_page

search_staff

1 cr

Search people (voice actors, directors, authors …) by name, or list those whose birthday is t…

required
—
optional
query, birthday_today, sort, page, per_page

studio

1 cr

A studio.

required
studio
optional
—

studio_media

1 cr

Every title of a studio, newest first by default, with whether it was the main studio.

required
studio
optional
main_only, sort, page, per_page

search_studios

1 cr

Search studios by name.

required
—
optional
query, sort, page, per_page

user

1 cr

A public AniList profile.

required
user
optional
—

user_statistics

1 cr

A user's full anime or manga statistics as their profile's Stats tab shows them.

required
user
optional
type, per_dimension, include_media_ids

user_favourites

1 cr

One of a user's favourites lists (anime, manga, characters, staff or studios), in the user's…

required
user
optional
kind, page, per_page

user_list

1 cr

A user's public anime or manga list.

required
user
optional
type, status, sort, page, per_page

user_followers

1 cr

Users who follow a user.

required
user
optional
sort, page, per_page

user_following

1 cr

Users a user follows.

required
user
optional
sort, page, per_page

search_users

1 cr

Search users by name, or rank them by time watched / chapters read.

required
—
optional
query, sort, page, per_page

activities

1 cr

The activity feed.

required
—
optional
user, media, type, has_replies, sort, page, per_page

activity

1 cr

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

required
activity
optional
—

threads

1 cr

Forum threads.

required
—
optional
query, category, media, user, sort, page, per_page

thread

1 cr

One forum thread.

required
thread
optional
—

thread_comments

1 cr

A thread's comments in order, each with its nested reply tree (as anilist.co shows them).

required
thread
optional
page, per_page

genres

0 cr

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

required
—
optional
—

tags

0 cr

AniList's full tag catalogue.

required
—
optional
category, adult

streaming_services

1 cr

Streaming services and other link sources AniList knows (the values search_media streaming_on…

required
—
optional
type, media_type

site_statistics

1 cr

AniList's own daily site statistics.

required
—
optional
kind, page, per_page

Every parameter, every allowed value →

Missing a AniList endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the AniList API works

AniList is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /anilist/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 1 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From this season's chart to each title's audience

Rank the season, read each title in full, then follow its score and popularity day by day.

01search_media?season=fall&season_year=2025&sort=popularity&per_page=50
GET/anilist/v1/search_media?season=fall&season_year=2025&sort=popularity&per_page=50

The season's titles, most popular first, with scores, popularity, studios, tags and next episode.

02media_batch?ids=<id1>,<id2>,…
GET/anilist/v1/media_batch?ids=<id1>,<id2>,…

Up to 50 titles again in one call, to re-read their numbers the next day.

03media?media=<id>
GET/anilist/v1/media?media=<id>

Rankings, score and status distributions, characters, staff, relations and streaming links of one title.

04media_trends?media=<id>&releasing=true
GET/anilist/v1/media_trends?media=<id>&releasing=true

AniList's own daily history of trending, score, popularity and users watching, per episode.

A dated season chart with each title's score, popularity and audience curve, from AniList's own numbers.

request
curl -X POST https://api.reefapi.com/anilist/v1/media \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"media":5114}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "anilist",
    "endpoint": "media",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

Coverage

AniList coverage, measured

Every number below was read from live AniList on 2026-11-16, across the 37 actions.

Titles

Weighted Score, Mean Score, Popularity and Favorites equal to the title page on 10, 10, 9 and 10 of 10 titles read in the same minute (the tenth page was a cached render). Score, popularity, favourites, tags and cover on 400 of 400 search rows across 8 formats; genres on 399, description on 398.

Anime

Episodes on 249 of 250 rows across TV, movie, ONA, OVA and special; episode length 250 of 250; studios 248 of 250; season 242 of 250.

Manga and novels

Chapters on 116 of 150 and volumes on 70 of 150 rows (titles still running have none yet); MyAnimeList id on 136 of 150.

Search

Up to 50 rows per page, the first 5,000 results of a list. Fall 2025 anime: 127; TV 46; releasing 13; action 32; action and fantasy 11; isekai 17; Crunchyroll 42; score 75 or more 21; score 60 or less 23. Anime ONA started in 2024: 286, Chinese 155.

Characters and staff

Every character of a title with voice actors in up to 9 languages; ONE PIECE's cast read 25 per page past page 21. Staff credits, voice roles and production roles page through in full.

Community

Reviews with full text, recommendations, activity feed, forum threads and comment trees, public user lists, statistics, favourites, followers and following.

Paging

Three consecutive pages of 17 lists had no row in common. AniList publishes an exact total only on the last page of a list; earlier pages say how many exist at least.

Limits

5,000 results per list. Characters, staff, trends and favourites come 25 per page, other lists 50. Private user lists are not readable. A title's activity cannot be filtered by type.

Use cases

What people build with AniList

The jobs this data is most often used for.

37

endpoints

0/1

credits per call

01

Track score, popularity and favourites of a season's anime every day from its first episode.

02

Build a seasonal or genre chart with search filters and AniList's own rankings.

03

Map MyAnimeList ids to AniList records, 50 at a time.

04

Collect characters, voice actors in every dub and staff credits for a title or a person.

Pricing

What AniList data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/anilist/v1/media \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"media":5114}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up AniList.

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.

Same key

43 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling AniList, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.