# MyAnimeList — anime & manga database, characters, people, reviews, seasons, top lists, users

> Everything on an anime's MyAnimeList page: score with the number of voters, rank, popularity, members, favorites, type, episodes, status, aired dates, season, broadcast day and time, producers, licensors, studios, source, genres, themes, demographic, duration, age rating, every title variant, synopsis, background, related anime and manga, opening and ending themes with Spotify / Apple Music / Amazon Music links, streaming platforms, trailer, official links and resources (AniDB, ANN, Wikipedia), the main characters with their Japanese voice actor and the key staff.
> ReefAPI engine `myanimelist` · 60 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/myanimelist/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/myanimelist/v1/anime — 1 credit
Everything on an anime's MyAnimeList page: score with the number of voters, rank, popularity, members, favorites, type, episodes, status, aired dates, season, broadcast day and time, producers, licensors, studios, source, genres, themes, demographic, duration, age rating, every title variant, synopsis, background, related anime and manga, opening and ending themes with Spotify / Apple Music / Amazon Music links, streaming platforms, trailer, official links and resources (AniDB, ANN, Wikipedia), the main characters with their Japanese voice actor and the key staff.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** {id, url, title, title_english, title_japanese, title_synonyms[], titles[{type,title}], image_url, type, status, genres[], explicit_genres[], themes[], demographics[], score, scored_by, rank, popularity, members, favorites, synopsis, background, related[{relation, entries[]}], external_links[], resources[], characters_preview[], episodes, aired{from,to,string}, premiered{season,year}, broadcast{day,time,timezone}, producers[], licensors[], studios[], source, duration, rating, opening_themes[], ending_themes[], streaming[], trailer, staff_preview[]}

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

### POST https://api.reefapi.com/myanimelist/v1/anime_brief — 1 credit
MyAnimeList's own small hover card for an anime: title with year, synopsis excerpt, status, type, episodes, score with voters, rank, popularity, members. The cheapest way to refresh the numbers.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** {url, title_with_year, synopsis_excerpt, status, type, episodes, score, scored_by, rank, popularity, members}

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

### POST https://api.reefapi.com/myanimelist/v1/anime_characters — 3 credits
Every character of an anime (main and supporting, with favorites) and every voice actor for each, per dub language.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `language` (string, optional) — Keep only voice actors of this language (`Japanese`, `English`, `German`, `Portuguese (BR)` …).
- `role` (enum, optional) — Keep only main or supporting characters. [one of: main, supporting]

**Returns:** results[]{character{id,name,url,image_url}, role, favorites, voice_actors[]{id,name,url,language,image_url}} + count + languages[]

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

### POST https://api.reefapi.com/myanimelist/v1/anime_staff — 3 credits
Every staff member of an anime with their positions (director, script, music, animation director, theme song performance …).

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `position` (string, optional) — Keep only staff whose position contains this text.

**Returns:** results[]{person{id,name,url,image_url}, positions[]} + count

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

### POST https://api.reefapi.com/myanimelist/v1/anime_episodes — 1 credit
The episode list: number, English title, romaji and Japanese title, air date, filler / recap flags, the members' episode poll score and the forum discussion. 100 episodes per page.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — 1-based page (100 episodes per page).

**Returns:** results[]{episode, url, title, title_romanji, title_japanese, aired, filler, recap, poll_score, forum_replies, forum_url} + total_episodes + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/anime_episode — 1 credit
One episode: titles, duration, air date, filler / recap flags, synopsis and its forum discussion.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `episode` (integer, required) — Episode number.

**Returns:** {episode, title, title_romanji, title_japanese, duration, aired, filler, recap, synopsis, forum_url, forum_replies}

**Example request body:**
```json
{
  "anime": 5114,
  "episode": 1
}
```

### POST https://api.reefapi.com/myanimelist/v1/anime_stats — 1 credit
Status counts (watching, completed, on-hold, dropped, plan to watch, total), the 1-10 score distribution (percent and votes) and the latest list updates by members (score, status, episodes seen, when). 75 updates per page.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — Page of the recent-updates list (75 per page).

**Returns:** summary{watching,completed,on_hold,dropped,plan_to_watch,total} + scores[]{score,percentage,votes} + recent_updates[]{user, score, status, episodes_seen, episodes_total, updated} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/anime_reviews — 1 credit
Member reviews of an anime with the verdict, reviewer's score, progress, reactions and the full text. Sort and filter exactly like the site.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — 1-based page number (20 reviews per page).
- `sort` (enum, optional, default "suggested") — Order: `suggested` (MAL default), `mostvoted`, `newest`, `oldest`. [one of: suggested, mostvoted, newest, oldest]
- `preference` (string, optional) — Only reviews with this verdict: `recommended`, `mixed_feelings`, `not_recommended` (several, comma-separated, must ALL apply).
- `tag` (string, optional) — Only reviews readers tagged: `funny`, `informative`, `well_written`, `creative` (comma-separated, all must apply).
- `exclude` (string, optional) — Leave out reviews with these verdicts / tags (same values as `preference` and `tag`).
- `include_preliminary` (boolean, optional, default true) — Include reviews written before the reviewer finished the title (MAL default: yes).
- `include_spoilers` (boolean, optional, default false) — Include reviews marked as spoilers (MAL default: no).

**Returns:** results[]{id, url, user{username,url,image_url}, date, time, preference, tags[], is_preliminary, progress, is_spoiler, score, reactions{nice,love_it,funny,confusing,informative,well_written,creative}, reactions_total, review} + filtered_total + total + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/anime_recommendations — 3 credits
Anime that members recommend to fans of this one, with every recommender's reason.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** results[]{entry{id,name,url,image_url}, recommendation_url, recommenders_count, recommendations[]{text,user}} + count

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

### POST https://api.reefapi.com/myanimelist/v1/anime_news — 1 credit
News articles about an anime.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** results[]{id, url, title, date, author, image_url, excerpt, comments, forum_url}

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

### POST https://api.reefapi.com/myanimelist/v1/anime_forum — 1 credit
Forum topics about an anime (episode discussions, polls, other).

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `topic` (enum, optional, default "all") — Which topics. [one of: all, episode, other]

**Returns:** results[]{id, url, title, prefix, author, posted, replies, last_post{user,date,url}}

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

### POST https://api.reefapi.com/myanimelist/v1/anime_more_info — 1 credit
The 'More Info' tab of an anime: suggested viewing order, notes on versions, episode counts and other facts editors added.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** {anime_id, more_info}

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

### POST https://api.reefapi.com/myanimelist/v1/anime_pictures — 1 credit
Every official picture (key visuals, covers) of an anime.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.

**Returns:** results[]{image_url, large_image_url} + count

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

### POST https://api.reefapi.com/myanimelist/v1/anime_videos — 1 credit
Videos of an anime: episode pages (40 per page), promotional videos (trailers, PVs, CMs) and music videos (OP / ED) with YouTube ids.

**Parameters:**
- `anime` (string, required) — The MyAnimeList anime id (`5114`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — Page of the episode-video list (40 per page).

**Returns:** episodes[]{episode,url,title,image_url} + promotional[]{title,video_id,youtube_id,url,embed_url,image_url} + music_videos[]{…, song} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/manga — 1 credit
Everything on a manga's MyAnimeList page: score with voters, rank, popularity, members, favorites, type, volumes, chapters, status, published dates, authors with their role, serialization magazine, genres, themes, demographic, every title variant, synopsis, background, related manga and anime, official links and the main characters.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** {id, url, title, title_english, title_japanese, title_synonyms[], titles[{type,title}], image_url, type, status, genres[], explicit_genres[], themes[], demographics[], score, scored_by, rank, popularity, members, favorites, synopsis, background, related[{relation, entries[]}], external_links[], resources[], characters_preview[], volumes, chapters, published{from,to,string}, authors[]{id,name,url,role}, serializations[]}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_brief — 1 credit
MyAnimeList's own small hover card for a manga: title with year, synopsis excerpt, genres, status, volumes, score with voters, rank, popularity, members.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** {url, title_with_year, synopsis_excerpt, genres[], status, volumes, score, scored_by, rank, popularity, members}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_characters — 3 credits
Every character of a manga with role and favorites.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.
- `role` (enum, optional) — Keep only main or supporting characters. [one of: main, supporting]

**Returns:** results[]{character{id,name,url,image_url}, role, favorites} + count

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_stats — 1 credit
Status counts (reading, completed, on-hold, dropped, plan to read, total), the 1-10 score distribution and the latest member list updates (75 per page).

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — Page of the recent-updates list (75 per page).

**Returns:** summary{reading,completed,on_hold,dropped,plan_to_read,total} + scores[] + recent_updates[]{user, score, status, chapters_read, volumes_read, updated} + page + has_next_page

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_reviews — 1 credit
Member reviews of a manga, sorted and filtered like the site.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — 1-based page number (20 reviews per page).
- `sort` (enum, optional, default "suggested") — Order: `suggested` (MAL default), `mostvoted`, `newest`, `oldest`. [one of: suggested, mostvoted, newest, oldest]
- `preference` (string, optional) — Only reviews with this verdict: `recommended`, `mixed_feelings`, `not_recommended` (several, comma-separated, must ALL apply).
- `tag` (string, optional) — Only reviews readers tagged: `funny`, `informative`, `well_written`, `creative` (comma-separated, all must apply).
- `exclude` (string, optional) — Leave out reviews with these verdicts / tags (same values as `preference` and `tag`).
- `include_preliminary` (boolean, optional, default true) — Include reviews written before the reviewer finished the title (MAL default: yes).
- `include_spoilers` (boolean, optional, default false) — Include reviews marked as spoilers (MAL default: no).

**Returns:** results[]{id, url, user{username,url,image_url}, date, time, preference, tags[], is_preliminary, progress, is_spoiler, score, reactions{nice,love_it,funny,confusing,informative,well_written,creative}, reactions_total, review} + filtered_total + total + page + has_next_page

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_recommendations — 1 credit
Manga that members recommend to readers of this one, with every recommender's reason.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** results[]{entry, recommendation_url, recommenders_count, recommendations[]}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_news — 1 credit
News articles about a manga.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** results[]{id, url, title, date, author, excerpt, comments}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_forum — 1 credit
Forum topics about a manga.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.
- `topic` (enum, optional, default "all") — Which topics. [one of: all, chapter, other]

**Returns:** results[]{id, url, title, author, posted, replies, last_post}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_more_info — 1 credit
The 'More Info' tab of a manga: prototypes, one-shots, chapter-count notes and other facts editors added.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** {manga_id, more_info}

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/manga_pictures — 1 credit
Every official picture (covers) of a manga.

**Parameters:**
- `manga` (string, required) — The MyAnimeList manga id (`2`) or its myanimelist.net link.

**Returns:** results[]{image_url, large_image_url} + count

**Example request body:**
```json
{
  "manga": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/character — 1 credit
A character: name, Japanese name, nicknames, member favorites, picture, the full biography (spoiler parts marked), every anime and manga they appear in with their role, and every voice actor with language.

**Parameters:**
- `character` (string, required) — The MyAnimeList character id (`417`) or its myanimelist.net link.

**Returns:** {id, url, name, name_kanji, nicknames[], favorites, image_url, about, anime[]{anime,role}, manga[]{manga,role}, voice_actors[]{person,language}}

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

### POST https://api.reefapi.com/myanimelist/v1/character_pictures — 1 credit
Every picture of a character.

**Parameters:**
- `character` (string, required) — The MyAnimeList character id (`417`) or its myanimelist.net link.

**Returns:** results[]{image_url, large_image_url} + count

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

### POST https://api.reefapi.com/myanimelist/v1/person — 3 credits
A voice actor, staff member or author: given and family name, alternate names, birthday, website, member favorites, picture, biography, every voice role (anime, character, main/supporting), every anime staff position and every published manga. Long lists are sliced with `limit` / `offset`; the totals are always returned.

**Parameters:**
- `person` (string, required) — The MyAnimeList person (voice actor, staff member, author) id (`118`) or its myanimelist.net link.
- `limit` (integer, optional, default 200) — Rows of each role list returned.
- `offset` (integer, optional, default 0) — Rows of each role list skipped.

**Returns:** {id, url, name, given_name, family_name, alternate_names[], birthday, website, favorites, image_url, about, voice_acting_roles[]{anime,character,role,start_date}, anime_staff_positions[]{anime,positions[],score,members}, published_manga[]} + voice_acting_roles_total + anime_staff_positions_total + published_manga_total

**Example request body:**
```json
{
  "person": 118
}
```

### POST https://api.reefapi.com/myanimelist/v1/person_pictures — 1 credit
Every picture of a person.

**Parameters:**
- `person` (string, required) — The MyAnimeList person (voice actor, staff member, author) id (`118`) or its myanimelist.net link.

**Returns:** results[]{image_url, large_image_url} + count

**Example request body:**
```json
{
  "person": 118
}
```

### POST https://api.reefapi.com/myanimelist/v1/producer — 3 credits
A studio, producer or licensor: Japanese name, established, member favorites, about, official links and EVERY anime it worked on with its role (Studio / Producer / Licensor), type, score, members, start date and genres.

**Parameters:**
- `producer` (string, required) — The MyAnimeList studio / producer / licensor id (`4`) or its myanimelist.net link.
- `role` (enum, optional) — Keep only titles where the company had this role. [one of: studio, producer, licensor]
- `type` (enum, optional) — Keep only this anime type. [one of: tv, ova, movie, special, ona, music, other]

**Returns:** {name, japanese_name, established, favorites, about, external_links[], type_counts{}, results[]{id,name,url,image_url,role,media_type,score,members,start_date,genre_ids[]}} + count

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

### POST https://api.reefapi.com/myanimelist/v1/magazine — 1 credit
A manga magazine (serialization): every manga serialized in it with type, year, status, volumes, chapters, score, authors, genres and synopsis. 100 per page.

**Parameters:**
- `magazine` (string, required) — The MyAnimeList magazine (serialization) id (`2`) or its myanimelist.net link.
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** {name, listed_count, results[]{id,name,url,media_type,year,status,volumes,chapters,score,members_display,authors[],genres[],synopsis}} + page + has_next_page

**Example request body:**
```json
{
  "magazine": 2
}
```

### POST https://api.reefapi.com/myanimelist/v1/producers — 1 credit
Every anime studio / producer / licensor on MyAnimeList with its id and title count.

**Parameters:** none

**Returns:** results[]{id, name, count, url} + count

### POST https://api.reefapi.com/myanimelist/v1/magazines — 1 credit
Every manga magazine on MyAnimeList with its id and title count.

**Parameters:** none

**Returns:** results[]{id, name, count, url} + count

### POST https://api.reefapi.com/myanimelist/v1/genres — 1 credit
Every anime or manga genre, theme, demographic and explicit genre with its id and title count.

**Parameters:**
- `type` (enum, optional, default "anime") — Anime or manga genres. [one of: anime, manga]

**Returns:** results[]{id, name, count, url, group} + count

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

### POST https://api.reefapi.com/myanimelist/v1/genre — 3 credits
Every anime or manga in one genre / theme / demographic, most popular first, with score, members, dates, studios or authors, genres and synopsis. 100 per page.

**Parameters:**
- `genre` (string, required) — Genre id (`1`) or name (`Action`, `Isekai`, `Shounen`).
- `type` (enum, optional, default "anime") — Anime or manga. [one of: anime, manga]
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** {name, results[]{…tile fields}} + page + has_next_page

**Example request body:**
```json
{
  "genre": "Action"
}
```

### POST https://api.reefapi.com/myanimelist/v1/search_anime — 1 credit
Search anime like MyAnimeList's advanced search: words, type, status, minimum score, age rating, producer / studio, genres to include and exclude, start and end date window, first letter, sort. 50 per page.

**Parameters:**
- `query` (string, optional) — Title words (3+ characters). Optional when a filter is given.
- `type` (enum, optional) — Anime type. [one of: tv, ova, movie, special, ona, music, cm, pv, tv_special]
- `status` (enum, optional) — Airing status. [one of: airing, finished, not_yet_aired]
- `min_score` (integer, optional) — MAL's score filter (1-10).
- `rating` (enum, optional) — Age rating: g, pg, pg13, r17, r_plus, rx. [one of: g, pg, pg13, r17, r_plus, rx]
- `producer` (integer, optional) — Studio / producer id (see `producers`).
- `genres` (string, optional) — Genre, theme or demographic ids or names (comma-separated); all must apply. MyAnimeList's own search returns nothing when a genre (Action) is combined with a theme (Mecha) — measured: Action+Sci-Fi 950+ results, Action+Mecha 0; one theme alone works.
- `genres_exclude` (string, optional) — Genre ids or names to leave out.
- `start_date` (string, optional) — Started on or after (YYYY, YYYY-MM or YYYY-MM-DD).
- `end_date` (string, optional) — Ended on or before (YYYY, YYYY-MM or YYYY-MM-DD).
- `letter` (string, optional) — Titles starting with this letter (`.` = non-letters).
- `sort` (enum, optional) — Sort column. [one of: title, start_date, score, episodes, end_date, type, members, rating]
- `order` (enum, optional, default "desc") — Sort direction. [one of: desc, asc]
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{id, name, url, image_url, synopsis_excerpt, media_type, episodes, score, start_date, end_date, members, rating} + page + has_next_page + last_page

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

### POST https://api.reefapi.com/myanimelist/v1/search_manga — 1 credit
Search manga like MyAnimeList's advanced search: words, type, status, minimum score, magazine, genres to include and exclude, date window, first letter, sort. 50 per page.

**Parameters:**
- `query` (string, optional) — Title words (3+ characters). Optional when a filter is given.
- `type` (enum, optional) — Manga type. [one of: manga, light_novel, one_shot, doujinshi, manhwa, manhua, novel]
- `status` (enum, optional) — Publishing status. [one of: publishing, finished, not_yet_published, on_hiatus, discontinued]
- `min_score` (integer, optional) — MAL's score filter (1-10).
- `magazine` (integer, optional) — Magazine id (see `magazines`).
- `genres` (string, optional) — Genre ids or names (comma-separated); all must apply.
- `genres_exclude` (string, optional) — Genre ids or names to leave out.
- `start_date` (string, optional) — Started on or after.
- `end_date` (string, optional) — Ended on or before.
- `letter` (string, optional) — Titles starting with this letter.
- `sort` (enum, optional) — Sort column. [one of: title, start_date, score, volumes, end_date, chapters, members, type]
- `order` (enum, optional, default "desc") — Sort direction. [one of: desc, asc]
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{id, name, url, image_url, synopsis_excerpt, media_type, volumes, chapters, score, start_date, end_date, members} + page + has_next_page + last_page

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

### POST https://api.reefapi.com/myanimelist/v1/search_characters — 1 credit
Search characters by name: id, name, alternate names, picture and the anime and manga they appear in. 50 per page.

**Parameters:**
- `query` (string, required) — Search words (MAL needs at least 3 characters for title / name search).
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{id, name, url, image_url, alternate_names[], anime[], manga[]} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/search_people — 1 credit
Search voice actors, staff and authors by name. 50 per page.

**Parameters:**
- `query` (string, required) — Search words (MAL needs at least 3 characters for title / name search).
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{id, name, url, image_url, alternate_names[]} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/search_users — 1 credit
Search MyAnimeList members by username, with the site's location, gender and age filters. 24 per page.

**Parameters:**
- `query` (string, optional) — Username words.
- `location` (string, optional) — Location text on the profile.
- `gender` (enum, optional) — Gender on the profile. [one of: male, female, non_binary]
- `min_age` (integer, optional) — Minimum age.
- `max_age` (integer, optional) — Maximum age.
- `page` (integer, optional, default 1) — 1-based page (24 per page).

**Returns:** results[]{username, url, image_url, last_online} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/autocomplete — 1 credit
MyAnimeList's instant search: the best matches as you type, with type, year, score and status (anime / manga) or favorites (characters, people).

**Parameters:**
- `query` (string, required) — Search words (MAL needs at least 3 characters for title / name search).
- `type` (enum, optional, default "all") — What to search. [one of: all, anime, manga, character, person]

**Returns:** results[]{id, type, name, url, image_url, payload{…}} + count

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

### POST https://api.reefapi.com/myanimelist/v1/top_anime — 1 credit
MyAnimeList's top anime lists: all, airing, upcoming, TV, movies, OVAs, ONAs, specials, most popular, most favorited. 50 per page.

**Parameters:**
- `type` (enum, optional, default "all") — Which list. [one of: all, airing, upcoming, tv, movie, ova, ona, special, bypopularity, favorite]
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{rank, id, name, url, image_url, media_type, episodes, start, end, dates_string, members, score} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/top_manga — 1 credit
MyAnimeList's top manga lists: all, manga, one-shots, doujinshi, light novels, novels, manhwa, manhua, most popular, most favorited. 50 per page.

**Parameters:**
- `type` (enum, optional, default "all") — Which list. [one of: all, manga, oneshots, doujin, lightnovels, novels, manhwa, manhua, bypopularity, favorite]
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{rank, id, name, url, image_url, media_type, volumes, start, end, members, score} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/top_characters — 1 credit
The most favorited characters: rank, name, Japanese name, favorites, anime and manga. 50 per page.

**Parameters:**
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{rank, id, name, url, image_url, name_kanji, favorites, animeography[], mangaography[]} + page + has_next_page

**Example request body:**
```json
{
  "page": 1
}
```

### POST https://api.reefapi.com/myanimelist/v1/top_people — 1 credit
The most favorited voice actors, staff and authors: rank, name, Japanese name, birthday, favorites. 50 per page.

**Parameters:**
- `page` (integer, optional, default 1) — 1-based page (50 per page).

**Returns:** results[]{rank, id, name, url, image_url, name_kanji, birthday, favorites} + page + has_next_page

**Example request body:**
```json
{
  "page": 1
}
```

### POST https://api.reefapi.com/myanimelist/v1/season — 3 credits
Every anime of a season (TV new, TV continuing, ONA, OVA, movies, specials) with start date, episodes, duration, studios, source, genres, themes, demographic, score, members, synopsis and streaming platforms. Without year/season: the current season.

**Parameters:**
- `year` (integer, optional) — Year (with `season`).
- `season` (enum, optional) — winter, spring, summer, fall. [one of: winter, spring, summer, fall]
- `section` (enum, optional) — Keep one section of the page. [one of: tv_new, tv_continuing, ona, ova, movie, special]
- `upcoming` (boolean, optional, default false) — MyAnimeList's 'Later' page: announced anime with no season yet (ignores year / season).

**Returns:** {year, season, results[]{id, name, url, image_url, section, media_type, start_date, episodes, duration, studios[], source, genres[], themes[], demographics[], score, members, synopsis, streaming[]}} + count + section_counts{}

**Example request body:**
```json
{
  "year": 2024
}
```

### POST https://api.reefapi.com/myanimelist/v1/season_archive — 1 credit
Every season MyAnimeList has a page for (year + season), newest first.

**Parameters:** none

**Returns:** results[]{year, season, url} + count

### POST https://api.reefapi.com/myanimelist/v1/schedule — 3 credits
This week's broadcast schedule: every airing anime grouped by weekday (JST), with the same fields as `season`.

**Parameters:**
- `day` (enum, optional) — Keep one day. [one of: monday, tuesday, wednesday, thursday, friday, saturday, sunday, other, unknown]

**Returns:** results[]{…, section(day)} + count + day_counts{}

**Example request body:**
```json
{
  "day": "monday"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_profile — 1 credit
A public member profile: picture, last online, gender, birthday, location, joined, forum posts, reviews, recommendations, blog posts, clubs and friends counts, about text, anime and manga statistics (days, mean score, status counts, episodes / chapters), the last list updates and the profile's RSS feeds.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.

**Returns:** {username, url, image_url, last_online, gender, birthday, location, joined, forum_posts, reviews, recommendations, blog_posts, clubs, friends_count, about, anime_stats{}, manga_stats{}, last_anime_updates[], last_manga_updates[], external_links[]}

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_animelist — 1 credit
A member's public anime list (300 rows per page): status, score, episodes watched, tags, dates, rewatching, priority and the anime's own type, episodes, rating, score, members, popularity, studios, season, genres.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `status` (enum, optional, default "all") — Which list tab. [one of: all, watching, completed, on_hold, dropped, plan_to_watch]
- `sort` (enum, optional, default "default") — Order like the list page. [one of: default, title, finish_date, start_date, score, last_updated, type, rating, progress, priority]
- `offset` (integer, optional, default 0) — Rows to skip (the list serves 300 per request).

**Returns:** results[]{id, title, url, image_url, status, status_name, score, num_watched_episodes, anime_num_episodes, tags, …every field the list sends} + offset + next_offset + has_next_page

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_mangalist — 1 credit
A member's public manga list (300 rows per page): status, score, chapters and volumes read, tags, dates and the manga's own fields.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `status` (enum, optional, default "all") — Which list tab. [one of: all, reading, completed, on_hold, dropped, plan_to_read]
- `sort` (enum, optional, default "default") — Order like the list page. [one of: default, title, finish_date, start_date, score, last_updated, type, rating, progress, priority]
- `offset` (integer, optional, default 0) — Rows to skip (300 per request).

**Returns:** results[]{id, title, url, image_url, status, status_name, score, num_read_chapters, num_read_volumes, …} + offset + next_offset + has_next_page

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_friends — 1 credit
A member's friends: username, picture, last online, friends since. 100 per page.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** results[]{username, url, image_url, last_online, friends_since} + page + has_next_page

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_reviews — 1 credit
Reviews a member wrote (anime and manga), full text. 10 per page.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** results[]{id, url, user{username,url,image_url}, date, time, preference, tags[], is_preliminary, progress, is_spoiler, score, reactions{nice,love_it,funny,confusing,informative,well_written,creative}, reactions_total, entry{id,type,name,url}, review} + page + has_next_page

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_recommendations — 1 credit
Recommendations a member made: liked title → recommended title with the reason.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** results[]{liked, recommended, text, user, date} + page + has_next_page

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_clubs — 1 credit
Clubs a member belongs to.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.

**Returns:** results[]{id, name, url} + count

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_favorites — 1 credit
A member's favorite anime, manga, characters and people.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.

**Returns:** {anime[], manga[], characters[], people[]}

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/user_history — 1 credit
A member's recent list history (last weeks): title and the episode or chapter reached, with time.

**Parameters:**
- `username` (string, required) — A MyAnimeList username (public profile) or its profile link.
- `type` (enum, optional, default "all") — Which history. [one of: all, anime, manga]

**Returns:** results[]{entry{id,type,name,url}, unit, increment, date, day_group} + count

**Example request body:**
```json
{
  "username": "Xinil"
}
```

### POST https://api.reefapi.com/myanimelist/v1/reviews_recent — 1 credit
The newest reviews on MyAnimeList (anime or manga), with the title they review, the verdict, score, reactions and full text. 50 per page.

**Parameters:**
- `type` (enum, optional, default "anime") — Anime or manga reviews. [one of: anime, manga]
- `sort` (enum, optional, default "newest") — Order. [one of: suggested, mostvoted, newest, oldest]
- `preference` (string, optional) — Only this verdict (`recommended`, `mixed_feelings`, `not_recommended`).
- `include_spoilers` (boolean, optional, default false) — Include spoiler reviews.
- `page` (integer, optional, default 1) — 1-based page number.

**Returns:** results[]{id, url, user{username,url,image_url}, date, time, preference, tags[], is_preliminary, progress, is_spoiler, score, reactions{nice,love_it,funny,confusing,informative,well_written,creative}, reactions_total, entry{id,type,name,url,image_url}, review} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/recommendations_recent — 1 credit
The newest member recommendations ("if you liked X, you might like Y") with the reason. 100 per page.

**Parameters:**
- `type` (enum, optional, default "anime") — Anime or manga. [one of: anime, manga]
- `page` (integer, optional, default 1) — 1-based page (100 per page).

**Returns:** results[]{liked, recommended, text, user, date} + page + has_next_page

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

### POST https://api.reefapi.com/myanimelist/v1/watch_episodes — 1 credit
Newly added (or most popular) episode videos on MyAnimeList.

**Parameters:**
- `sort` (enum, optional, default "new") — Just added or most popular. [one of: new, popular]

**Returns:** results[]{anime, image_url, episodes[]{episode,url,title,premium}, region_blocked}

**Example request body:**
```json
{
  "sort": "new"
}
```

### POST https://api.reefapi.com/myanimelist/v1/watch_promos — 1 credit
Newly added (or most popular) promotional videos (trailers, PVs) with YouTube ids.

**Parameters:**
- `sort` (enum, optional, default "new") — Just added or most popular. [one of: new, popular]

**Returns:** results[]{anime, title, video_id, youtube_id, url, embed_url, image_url}

**Example request body:**
```json
{
  "sort": "new"
}
```

## 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=myanimelist
- Human docs page: https://reefapi.com/docs/myanimelist
- Overview page: https://reefapi.com/myanimelist-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
