# AniList API — anime and manga scores, popularity, rankings, airing schedule, characters, voice actors, staff, studios, reviews, recommendations and user lists

> 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.
> ReefAPI engine `anilist` · 37 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/anilist/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/anilist/v1/media — 1 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.

**Parameters:**
- `media` (string, optional) — AniList title id or anilist.co/anime/… or /manga/… link. Give this or `mal_id`.
- `mal_id` (integer, optional) — MyAnimeList id instead of the AniList id (MAL numbers anime and manga separately — set `type` for a manga; anime is assumed).
- `type` (enum, optional) — With `mal_id`: anime (default) or manga. [one of: anime, manga]
- `voice_actor_language` (enum, optional, default "japanese") — Voice actors shown with the character preview (`all` = every dub; `media_characters` pages through every character). [one of: japanese, english, korean, italian, spanish, portuguese, french, german, hebrew, hungarian, all]

**Returns:** media{id, mal_id, url, type, format, status, title{romaji, english, native, user_preferred}, synonyms[], description, start_date, end_date, season, season_year, episodes, duration_min, chapters, volumes, country_of_origin, is_licensed, source, genres[], tags[]{name, rank, category, is_spoiler, …}, weighted_score, average_score, mean_score, popularity, favourites, trending, is_adult, hashtag, cover_image{…}, banner_image, next_airing_episode{episode, airing_at, time_until_airing_s}, studios[]{id, name, is_main, is_animation_studio}, main_studios[], producers[], updated_at, trailer{id, site, url}, rankings[]{rank, type, context, year, season, all_time}, score_distribution[]{score, amount}, status_distribution[]{status, amount}, external_links[]{site, url, type, language}, streaming_episodes[]{title, url, site, thumbnail}, relations[]{relation_type, …}, characters{results[]{…, role, voice_actors[]}, has_more}, staff{results[], has_more}, recommendations{results[]{rating, media}, has_more}, reviews{results[]{summary, score, rating}, has_more}}

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/media_batch — 1 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`.

**Parameters:**
- `ids` (array, optional) — 1-50 AniList title ids (array or comma-separated). Give this or `mal_ids`.
- `mal_ids` (array, optional) — 1-50 MyAnimeList ids instead (with `type`).
- `type` (enum, optional) — With `mal_ids`: anime (default) or manga. [one of: anime, manga]

**Returns:** results[]{id, mal_id, url, type, format, status, title{romaji, english, native, user_preferred}, synonyms[], description, start_date, end_date, season, season_year, episodes, duration_min, chapters, volumes, country_of_origin, is_licensed, source, genres[], tags[]{name, rank, category, is_spoiler, …}, weighted_score, average_score, mean_score, popularity, favourites, trending, is_adult, hashtag, cover_image{…}, banner_image, next_airing_episode{episode, airing_at, time_until_airing_s}, studios[]{id, name, is_main, is_animation_studio}, main_studios[], producers[], updated_at} + count + not_found_ids[]

**Example request body:**
```json
{
  "ids": "5114,21,1535"
}
```

### POST https://api.reefapi.com/anilist/v1/search_media — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `type` (enum, optional, default "anime") — Anime or manga (default anime). [one of: anime, manga]
- `genres` (array, optional) — Titles carrying ALL of these genres (case does not matter; `genres` lists them).
- `exclude_genres` (array, optional) — Titles carrying none of these genres.
- `tags` (array, optional) — Titles carrying ALL of these tags (names as in `tags`; case does not matter; an unknown tag is an error, not 0 rows).
- `exclude_tags` (array, optional) — Titles carrying none of these tags.
- `tag_category` (array, optional) — Titles with a tag in this category (as `tags` lists them).
- `minimum_tag_rank` (integer, optional) — With `tags`: the tag's rank on the title must be at least this (anilist.co's "minimum tag percentage").
- `format` (array, optional) — Format(s); several allowed. [one of: tv, tv_short, movie, special, ova, ona, music, manga, novel, one_shot]
- `status` (array, optional) — Airing / publishing status; several allowed. [one of: finished, releasing, not_yet_released, cancelled, hiatus]
- `season` (enum, optional) — Anime season (with `season_year`). [one of: winter, spring, summer, fall]
- `season_year` (integer, optional) — Anime season year.
- `year` (integer, optional) — Started in this year (any season; works for manga too).
- `start_date_from` (string, optional) — Started on or after this date (YYYY, YYYY-MM or YYYY-MM-DD).
- `start_date_to` (string, optional) — Started on or before this date.
- `country` (array, optional) — Country of origin (JP, KR, CN, TW). [one of: JP, KR, CN, TW]
- `source` (array, optional) — Source material; several allowed. [one of: original, manga, light_novel, visual_novel, video_game, other, novel, doujinshi, anime, web_novel, live_action, game, comic, multimedia_project, picture_book]
- `streaming_on` (array, optional) — Available on these streaming services (names as `streaming_services` lists them; case does not matter).
- `licensed` (enum, optional) — true = licensed titles only; false = unlicensed only (manga: anilist.co's "doujin" toggle). [one of: true, false]
- `adult` (enum, optional, default "false") — Adult content: `false` hides it (anilist.co's default for visitors), `true` = adult only, `any` = both. [one of: false, true, any]
- `score_min` (integer, optional) — Weighted 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_max` (integer, optional) — Weighted score at most this.
- `popularity_min` (integer, optional) — Popularity (users with it on their list) at least this.
- `popularity_max` (integer, optional) — Popularity at most this.
- `episodes_min` (integer, optional) — At least this many episodes.
- `episodes_max` (integer, optional) — At most this many episodes.
- `duration_min` (integer, optional) — Episode length at least this many minutes.
- `duration_max` (integer, optional) — Episode length at most this.
- `chapters_min` (integer, optional) — Manga: at least this many chapters.
- `chapters_max` (integer, optional) — Manga: at most this many chapters.
- `volumes_min` (integer, optional) — Manga: at least this many volumes.
- `volumes_max` (integer, optional) — Manga: at most this many volumes.
- `sort` (enum, optional) — Order. Default: relevance with `query`, popularity without. [one of: relevance, 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_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Titles per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, mal_id, url, type, format, status, title{romaji, english, native, user_preferred}, synonyms[], description, start_date, end_date, season, season_year, episodes, duration_min, chapters, volumes, country_of_origin, is_licensed, source, genres[], tags[]{name, rank, category, is_spoiler, …}, weighted_score, average_score, mean_score, popularity, favourites, trending, is_adult, hashtag, cover_image{…}, banner_image, next_airing_episode{episode, airing_at, time_until_airing_s}, studios[]{id, name, is_main, is_animation_studio}, main_studios[], producers[], updated_at} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "season": "fall",
  "season_year": 2025,
  "format": "tv"
}
```

### POST https://api.reefapi.com/anilist/v1/media_characters — 1 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.

**Parameters:**
- `media` (string, required) — AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
- `role` (enum, optional) — Main, supporting or background characters only. [one of: main, supporting, background]
- `voice_actor_language` (enum, optional, default "all") — Voice actors in this language only (`all` = every dub). [one of: japanese, english, korean, italian, spanish, portuguese, french, german, hebrew, hungarian, all]
- `sort` (enum, optional, default "role") — Order (default: role, then relevance, as anilist.co shows them). [one of: role, relevance, favourites, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Characters per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** media{id, title, url} + results[]{id, name, name_native, image, favourites, role, voice_actors[]{id, name, language, role_notes, dub_group, …}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 21
}
```

### POST https://api.reefapi.com/anilist/v1/media_staff — 1 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.

**Parameters:**
- `media` (string, required) — AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
- `sort` (enum, optional, default "relevance") — Order. [one of: relevance, role, language, favourites, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Staff per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** media{id, title, url} + results[]{id, name, name_native, language, image, primary_occupations[], favourites, role} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/media_trends — 1 credit
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.

**Parameters:**
- `media` (string, required) — AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
- `releasing` (enum, optional) — true = only the days it was releasing. [one of: true, false]
- `sort` (enum, optional, default "newest") — Order (default newest day first). [one of: newest, oldest, trending, popularity, score, episode, episode_asc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Days per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** media{id, title, url} + results[]{date, trending, weighted_score, average_score, popularity, in_progress, episode, releasing} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/media_airing_schedule — 1 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.

**Parameters:**
- `media` (string, required) — AniList title id (anime or manga) or anilist.co/anime/… or /manga/… link.
- `not_yet_aired` (enum, optional) — true = upcoming episodes only; false = aired only. [one of: true, false]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Episodes per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** media{id, title, url, next_airing_episode} + results[]{id, episode, airing_at, airing_at_unix, time_until_airing_s} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/airing_schedule — 1 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.

**Parameters:**
- `from` (string, optional) — Window start: ISO date / date-time or unix seconds (default now).
- `to` (string, optional) — Window end (default `from` + 7 days).
- `media` (string, optional) — Only rows about this title (AniList id or anilist.co link).
- `sort` (enum, optional, default "time") — Order (default soonest first). [one of: time, time_desc, episode, episode_desc, media_id]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Episodes per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, episode, airing_at, airing_at_unix, time_until_airing_s, media_id, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + from + to + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "from": "2026-11-16"
}
```

### POST https://api.reefapi.com/anilist/v1/reviews — 1 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.

**Parameters:**
- `media` (string, optional) — Only rows about this title (AniList id or anilist.co link).
- `user` (string, optional) — Only rows by this user (name, id or anilist.co/user/… link).
- `type` (enum, optional) — Anime or manga reviews only. [one of: anime, manga]
- `sort` (enum, optional, default "newest") — Order (default: newest; anilist.co shows a title's reviews by rating). [one of: newest, oldest, rating, rating_asc, score, score_asc, updated]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 10) — Reviews per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, url, summary, body, score, rating, rating_amount, created_at, updated_at, user{id, name, url, avatar}, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/review — 1 credit
One review in full: text, score, votes, reviewer and the title.

**Parameters:**
- `review` (string, required) — AniList review id or anilist.co review link.

**Returns:** review{id, url, summary, body, score, rating, rating_amount, private, created_at, updated_at, user{…}, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}}

**Example request body:**
```json
{
  "review": 2369
}
```

### POST https://api.reefapi.com/anilist/v1/recommendations — 1 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.

**Parameters:**
- `media` (string, optional) — Only rows about this title (AniList id or anilist.co link).
- `user` (string, optional) — Only rows by this user (name, id or anilist.co/user/… link).
- `rating_min` (integer, optional) — Only pairs with more than this many net votes.
- `sort` (enum, optional) — Order (default: highest rated with `media`, newest otherwise). [one of: rating, rating_asc, newest, oldest]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Recommendations per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, rating, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}, recommendation{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}, user{…}}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "media": 5114
}
```

### POST https://api.reefapi.com/anilist/v1/character — 1 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.

**Parameters:**
- `character` (string, required) — AniList character id or anilist.co character link.

**Returns:** character{id, url, name, name_first, name_last, name_native, alternative_names[], alternative_names_spoiler[], image, description, gender, date_of_birth, age, blood_type, favourites} + appearances{results[]{role, media{…}, voice_actors[]}, has_more}

**Example request body:**
```json
{
  "character": 40
}
```

### POST https://api.reefapi.com/anilist/v1/character_media — 1 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.

**Parameters:**
- `character` (string, required) — AniList character id or anilist.co character link.
- `type` (enum, optional) — Anime or manga appearances only. [one of: anime, manga]
- `sort` (enum, optional, default "popularity") — Order (default popularity). [one of: relevance, 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_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** character{id, name, url} + results[]{role, name_in_this_title, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}, voice_actors[]} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "character": 40
}
```

### POST https://api.reefapi.com/anilist/v1/search_characters — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `birthday_today` (enum, optional) — true = characters whose birthday is today. [one of: true, false]
- `sort` (enum, optional) — Order (default: relevance with `query`, favourites without). [one of: relevance, favourites, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Characters per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, url, name, name_native, alternative_names[], image, gender, date_of_birth, age, favourites, …} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "query": "fullmetal"
}
```

### POST https://api.reefapi.com/anilist/v1/staff — 1 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.

**Parameters:**
- `staff` (string, required) — AniList staff id or anilist.co staff link.

**Returns:** staff{id, url, name, name_native, alternative_names[], language, image, description, primary_occupations[], gender, date_of_birth, date_of_death, age, years_active[], home_town, blood_type, favourites} + voice_roles{results[], has_more} + production_roles{results[], has_more}

**Example request body:**
```json
{
  "staff": 95075
}
```

### POST https://api.reefapi.com/anilist/v1/staff_characters — 1 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.

**Parameters:**
- `staff` (string, required) — AniList staff id or anilist.co staff link.
- `sort` (enum, optional, default "newest") — Order (default: newest first). [one of: relevance, 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_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** staff{id, name, url} + results[]{media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}, role, characters[]{id, name, image, …}}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "staff": 95075
}
```

### POST https://api.reefapi.com/anilist/v1/staff_media — 1 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.

**Parameters:**
- `staff` (string, required) — AniList staff id or anilist.co staff link.
- `type` (enum, optional) — Anime or manga credits only. [one of: anime, manga]
- `sort` (enum, optional, default "newest") — Order (default: newest first). [one of: relevance, 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_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Credits per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** staff{id, name, url} + results[]{role, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "staff": 95075
}
```

### POST https://api.reefapi.com/anilist/v1/search_staff — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `birthday_today` (enum, optional) — true = people whose birthday is today. [one of: true, false]
- `sort` (enum, optional) — Order (default: relevance with `query`, favourites without). [one of: relevance, favourites, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — People per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, url, name, name_native, language, primary_occupations[], gender, date_of_birth, age, favourites, …} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "query": "fullmetal"
}
```

### POST https://api.reefapi.com/anilist/v1/studio — 1 credit
A studio: name, animation studio or not, favourites, and the first page of its titles.

**Parameters:**
- `studio` (string, required) — AniList studio id or anilist.co studio link.

**Returns:** studio{id, name, url, is_animation_studio, favourites} + media{results[], has_more}

**Example request body:**
```json
{
  "studio": 4
}
```

### POST https://api.reefapi.com/anilist/v1/studio_media — 1 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.

**Parameters:**
- `studio` (string, required) — AniList studio id or anilist.co studio link.
- `main_only` (enum, optional) — true = only titles where it was the main studio. [one of: true, false]
- `sort` (enum, optional, default "newest") — Order (default newest). [one of: relevance, 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_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Titles per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** studio{id, name, url} + results[]{is_main_studio, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "studio": 4
}
```

### POST https://api.reefapi.com/anilist/v1/search_studios — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `sort` (enum, optional) — Order (default: relevance with `query`, favourites without). [one of: relevance, name, name_desc, favourites, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Studios per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, name, url, is_animation_studio, favourites} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "query": "fullmetal"
}
```

### POST https://api.reefapi.com/anilist/v1/user — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.

**Returns:** user{id, name, url, about, avatar, banner_image, created_at, donator_tier, donator_badge, previous_names[], score_format, anime_custom_lists[], …} + anime_stats{count, mean_score, minutes_watched, days_watched, episodes_watched, …} + manga_stats{…} + favourites{anime[], manga[], characters[], staff[], studios[]}

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/user_statistics — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.
- `type` (enum, optional, default "anime") — Anime or manga. [one of: anime, manga]
- `per_dimension` (integer, optional) — Rows per breakdown, 1-100 (default 100; AniList serves at most 100 rows per breakdown, measured: 500 → 100).
- `include_media_ids` (enum, optional, default "false") — true = every breakdown row also lists the title ids it counts (large for big lists). [one of: true, false]

**Returns:** user{id, name, url} + type + totals{…} + formats[] + statuses[] + scores[] + lengths[] + release_years[] + start_years[] + genres[] + tags[] + countries[] + voice_actors[] + staff[] + studios[]  (each {key, count, mean_score, minutes_watched, chapters_read, media_ids[]?})

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/user_favourites — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.
- `kind` (enum, optional, default "anime") — Which favourites list. [one of: anime, manga, characters, staff, studios]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Favourites per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** user{id, name, url} + kind + results[]{favourite_order, …} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/user_list — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.
- `type` (enum, optional, default "anime") — Anime or manga list. [one of: anime, manga]
- `status` (array, optional) — Only entries with this status (watching / reading = current); several allowed. [one of: current, planning, completed, dropped, paused, repeating]
- `sort` (enum, optional, default "updated") — Order (default: last updated first). [one of: updated, added, score, score_asc, progress, title, title_english, popularity, started, finished, repeat, priority, media_id]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Entries per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** user{name} + results[]{id, media_id, status, score, score_100, progress, progress_volumes, repeat, priority, notes, custom_lists[], advanced_scores, started_at, completed_at, updated_at, created_at, media{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/user_followers — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.
- `sort` (enum, optional, default "id_desc") — Order (default: newest account first). [one of: relevance, name, name_desc, watched_time, chapters_read, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** user{id, name, url} + results[]{id, name, url, avatar, donator_badge, …} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/user_following — 1 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.

**Parameters:**
- `user` (string, required) — AniList user name, numeric user id or anilist.co/user/… link.
- `sort` (enum, optional, default "id_desc") — Order (default: newest account first). [one of: relevance, name, name_desc, watched_time, chapters_read, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 50) — Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** user{id, name, url} + results[]{id, name, url, avatar, …} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/search_users — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `sort` (enum, optional) — Order (default: relevance with `query`, most time watched without). [one of: relevance, name, name_desc, watched_time, chapters_read, id, id_desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Users per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, name, url, avatar, donator_tier, donator_badge} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "query": "fullmetal"
}
```

### POST https://api.reefapi.com/anilist/v1/activities — 1 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.

**Parameters:**
- `user` (string, optional) — Only rows by this user (name, id or anilist.co/user/… link).
- `media` (string, optional) — Only rows about this title (AniList id or anilist.co link).
- `type` (array, optional) — Activity type; several allowed (`media_list` = anime and manga list updates). [one of: text, anime_list, manga_list, message, media_list]
- `has_replies` (enum, optional) — true = only activities with replies. [one of: true, false]
- `sort` (enum, optional, default "newest") — Order (default newest). [one of: newest, oldest, pinned]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Activities per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, kind (text|list|message), type, url, created_at, user{…}, text, status, progress, media{…}, recipient{…}, reply_count, like_count, is_pinned} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "user": "killkill"
}
```

### POST https://api.reefapi.com/anilist/v1/activity — 1 credit
One activity with every reply and the users who liked it.

**Parameters:**
- `activity` (string, required) — AniList activity id or anilist.co activity link.

**Returns:** activity{id, kind, type, url, created_at, user, text, media, reply_count, like_count, liked_by[]} + replies[]{id, text, like_count, created_at, user, liked_by[]}

**Example request body:**
```json
{
  "activity": 1204425236
}
```

### POST https://api.reefapi.com/anilist/v1/threads — 1 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.

**Parameters:**
- `query` (string, optional) — Search text, matched the way anilist.co's search box matches it.
- `category` (enum, optional) — Forum category (name or AniList category id). [one of: anime, manga, light_novels, visual_novels, release_discussion, general, news, music, gaming, site_feedback, bug_reports, site_announcements, list_customisation, recommendations, forum_games, misc, anilist_apps]
- `media` (string, optional) — Only rows about this title (AniList id or anilist.co link).
- `user` (string, optional) — Only rows by this user (name, id or anilist.co/user/… link).
- `sort` (enum, optional) — Order (default: last reply first; relevance with `query`). [one of: replied, newest, oldest, updated, replies, views, title, sticky, relevance]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Threads per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** results[]{id, url, title, body, reply_count, view_count, like_count, is_sticky, is_locked, created_at, replied_at, user, last_reply_user, categories[], media[]{id, mal_id, type, format, status, title{…}, cover_image, start_date, season, season_year, episodes, chapters, volumes, weighted_score, average_score, mean_score, popularity, favourites, is_adult, url}} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "query": "fullmetal"
}
```

### POST https://api.reefapi.com/anilist/v1/thread — 1 credit
One forum thread: title, full opening post, counts, author, categories and titles it is about.

**Parameters:**
- `thread` (string, required) — AniList thread id or anilist.co thread link.

**Returns:** thread{id, url, title, body, reply_count, view_count, like_count, is_locked, is_sticky, created_at, updated_at, replied_at, user, last_reply_user, categories[], media[]}

**Example request body:**
```json
{
  "thread": 94078
}
```

### POST https://api.reefapi.com/anilist/v1/thread_comments — 1 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.

**Parameters:**
- `thread` (string, required) — AniList thread id or anilist.co thread link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Comments per page, 1-50 — 50 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** thread_id + results[]{id, url, comment, like_count, created_at, user, replies[]{…}, reply_count_nested} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "thread": 94078
}
```

### POST https://api.reefapi.com/anilist/v1/genres — 0 credits
Every genre AniList uses (the values `search_media` `genres` takes).

**Parameters:** none

**Returns:** results[] + count

### POST https://api.reefapi.com/anilist/v1/tags — 0 credits
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).

**Parameters:**
- `category` (string, optional) — Only tags in categories containing this text.
- `adult` (enum, optional, default "any") — Adult tags: false hides them, true = only them, any = all (default). [one of: false, true, any]

**Returns:** results[]{id, name, description, category, is_adult, is_general_spoiler} + categories[] + count

**Example request body:**
```json
{
  "category": "Theme-Action"
}
```

### POST https://api.reefapi.com/anilist/v1/streaming_services — 1 credit
Streaming services and other link sources AniList knows (the values `search_media` `streaming_on` takes).

**Parameters:**
- `type` (enum, optional, default "streaming") — Link type (default streaming). [one of: streaming, info, social]
- `media_type` (enum, optional, default "anime") — Sources for anime or manga. [one of: anime, manga]

**Returns:** results[]{id, site, type, language, icon, color, is_disabled} + count

**Example request body:**
```json
{
  "type": "streaming"
}
```

### POST https://api.reefapi.com/anilist/v1/site_statistics — 1 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.

**Parameters:**
- `kind` (enum, optional, default "users") — Which statistic. [one of: users, anime, manga, characters, staff, studios, reviews]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 25) — Days per page, 1-25 — 25 is AniList's own ceiling for this list (asking for more returns this many, measured).

**Returns:** kind + results[]{date, count, change} + page + per_page + has_next_page + total + total_at_least

**Example request body:**
```json
{
  "kind": "users"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=anilist
- Human docs page: https://reefapi.com/docs/anilist
- Overview page: https://reefapi.com/anilist-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
