# Kitsu API — anime & manga database: search with every filter, full titles (community approval, rating distribution, popularity & rating rank), episodes, chapters, characters & voice cast, staff, studios, streaming links, MAL/AniList/TVDB id mapping, reactions, trending and public user libraries

> Search Kitsu's anime catalogue (22,553 titles on 2026-11-16) by text and every filter Kitsu's API accepts: category, genre, subtype, status, season + season year, start-year range, age rating, community-approval range, user-count range, episode count and length ranges, streaming platform, or up to 20 ids at once. 11 sort orders. Each row is the full anime record. Real paging: 20 per page, `total` is Kitsu's own count, offsets reach the end of the list.
> ReefAPI engine `kitsu` · 29 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/kitsu/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/kitsu/v1/search_anime — 1 credit
Search Kitsu's anime catalogue (22,553 titles on 2026-11-16) by text and every filter Kitsu's API accepts: category, genre, subtype, status, season + season year, start-year range, age rating, community-approval range, user-count range, episode count and length ranges, streaming platform, or up to 20 ids at once. 11 sort orders. Each row is the full anime record. Real paging: 20 per page, `total` is Kitsu's own count, offsets reach the end of the list.

**Parameters:**
- `query` (string, optional) — Free text, matched by Kitsu's own search over every title (English, romaji, Japanese, abbreviations). Combines with every filter below.
- `category` (array, optional) — Kitsu category slug or title (`adventure`, `science-fiction`, `Super Power`); comma = ALL of them (adventure,comedy: 4 152 → 1 519 anime). 218 categories: `categories`. Unknown values are rejected (Kitsu itself silently ignores them).
- `genre` (array, optional) — Kitsu genre slug or name (`action`, `romance`, `slice-of-life`); comma = all of them. 62 genres: `genres`. Unknown values are rejected.
- `status` (array, optional) — current (airing / publishing), finished, tba, unreleased, upcoming; comma = any of. [one of: current, finished, tba, unreleased, upcoming]
- `year_from` (integer, optional) — Start year from (inclusive).
- `year_to` (integer, optional) — Start year to (inclusive). year_from=2010 & year_to=2012: 2 038 anime.
- `rating_min` (number, optional) — Minimum community approval, 0-100 (the page's 'NN% Community Approval'); 80: 811 anime. Kitsu filters on its search index, which trails the live value slightly: 70-71 returned titles now at 68.78-71.42 (measured).
- `rating_max` (number, optional) — Maximum community approval (same index caveat).
- `user_count_min` (integer, optional) — Minimum number of Kitsu users with the title in their library, as of Kitsu's search index (10000: 1,615 anime). The index trails the live count: 1000-2000 returned titles now at 2,021-5,228 users (measured).
- `user_count_max` (integer, optional) — Maximum user count (same index caveat: 0-10 returned titles now at 12-82).
- `ids` (array, optional) — Up to 20 Kitsu ids, comma separated: the records come back in ONE upstream request.
- `subtype` (array, optional) — TV, movie, OVA, ONA, special, music; comma = any of. [one of: TV, movie, OVA, ONA, special, music]
- `season` (string, optional) — Airing season: winter, spring, summer, fall (autumn accepted). [one of: winter, spring, summer, fall, autumn]
- `season_year` (integer, optional) — Airing season year (season_year=2023: 931; with season=spring: 243).
- `age_rating` (array, optional) — G, PG, R; comma = any of. (R18 titles are not served to logged-out clients.) [one of: G, PG, R]
- `streamer` (array, optional) — Only titles with a streaming link on this platform (Crunchyroll: 2 890). 11 platforms: `streamers`.
- `episode_count_min` (integer, optional) — Minimum episode count.
- `episode_count_max` (integer, optional) — Maximum episode count.
- `episode_length_min` (integer, optional) — Minimum episode length in minutes (60: 1,917 anime, all 86-162 min in the sample).
- `episode_length_max` (integer, optional) — Maximum episode length in minutes (5: shorts of 1-5 min).
- `sort` (string, optional) — relevance (default with a query), popularity (default without), rating (approval high → low), rank (rating rank), users, favorites, newest, oldest, updated, added, episodes. [one of: popularity, rating, rank, users, favorites, newest, oldest, updated, added, episodes, relevance]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw, episode_count, episode_length, total_length, youtube_video_id, youtube_url, show_type} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/search_manga — 1 credit
Search Kitsu's manga catalogue (63,354 titles on 2026-11-16: manga, light novels, manhwa, manhua, one-shots, doujin, OEL) by text, category, genre, subtype, status, start-year range, community-approval range, user-count range, chapter-count range or up to 20 ids. 11 sort orders, 20 per page with Kitsu's own total.

**Parameters:**
- `query` (string, optional) — Free text, matched by Kitsu's own search over every title (English, romaji, Japanese, abbreviations). Combines with every filter below.
- `category` (array, optional) — Kitsu category slug or title (`adventure`, `science-fiction`, `Super Power`); comma = ALL of them (adventure,comedy: 4 152 → 1 519 anime). 218 categories: `categories`. Unknown values are rejected (Kitsu itself silently ignores them).
- `genre` (array, optional) — Kitsu genre slug or name (`action`, `romance`, `slice-of-life`); comma = all of them. 62 genres: `genres`. Unknown values are rejected.
- `status` (array, optional) — current (airing / publishing), finished, tba, unreleased, upcoming; comma = any of. [one of: current, finished, tba, unreleased, upcoming]
- `year_from` (integer, optional) — Start year from (inclusive).
- `year_to` (integer, optional) — Start year to (inclusive). year_from=2010 & year_to=2012: 2 038 anime.
- `rating_min` (number, optional) — Minimum community approval, 0-100 (the page's 'NN% Community Approval'); 80: 811 anime. Kitsu filters on its search index, which trails the live value slightly: 70-71 returned titles now at 68.78-71.42 (measured).
- `rating_max` (number, optional) — Maximum community approval (same index caveat).
- `user_count_min` (integer, optional) — Minimum number of Kitsu users with the title in their library, as of Kitsu's search index (10000: 1,615 anime). The index trails the live count: 1000-2000 returned titles now at 2,021-5,228 users (measured).
- `user_count_max` (integer, optional) — Maximum user count (same index caveat: 0-10 returned titles now at 12-82).
- `ids` (array, optional) — Up to 20 Kitsu ids, comma separated: the records come back in ONE upstream request.
- `subtype` (array, optional) — manga, novel, manhua, manhwa, oneshot, doujin, oel; comma = any of. [one of: manga, novel, manhua, manhwa, oneshot, doujin, oel]
- `chapter_count_min` (integer, optional) — Minimum chapter count.
- `chapter_count_max` (integer, optional) — Maximum chapter count.
- `sort` (string, optional) — relevance (default with a query), popularity (default without), rating, rank, users, favorites, newest, oldest, updated, added, chapters. [one of: popularity, rating, rank, users, favorites, newest, oldest, updated, added, chapters, relevance]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw, chapter_count, volume_count, serialization, manga_type} + total + page + per_page + total_pages + has_more

**Example request body:**
```json
{
  "category": "romance",
  "subtype": "manhwa"
}
```

### POST https://api.reefapi.com/kitsu/v1/anime — 1 credit
One anime in full, in one upstream request: every title, synopsis, community approval (the page's 'NN.NN% Community Approval') with the full rating distribution, popularity and rating rank, user and favourite counts, age rating and guide, subtype, status, start / end / next-release dates, episode count and length, total length, poster and cover images, YouTube trailer, plus its categories, genres, studios / producers / licensors, streaming links (platform, URL, subtitle and dub languages) and external ids (MyAnimeList, AniList, AniDB, TheTVDB, Trakt…).

**Parameters:**
- `anime` (string, required) — Anime id (`1`), slug (`cowboy-bebop`) or kitsu.app/anime/… link.

**Returns:** id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw, episode_count, episode_length, total_length, youtube_video_id, youtube_url, show_type, categories[]{id, slug, title, description, total_media_count, nsfw, child_count}, genres[]{id, slug, name}, anime_productions[]{role, producer{id, slug, name}}, streaming_links[]{url, subs[], dubs[], streamer{id, site_name, streaming_links_count}}, mappings[]{external_site, external_id}, external_ids{site: id}

**Example request body:**
```json
{
  "anime": "cowboy-bebop"
}
```

### POST https://api.reefapi.com/kitsu/v1/manga — 1 credit
One manga / light novel / manhwa in full, in one upstream request: titles, synopsis, community approval with rating distribution, popularity and rating rank, user and favourite counts, subtype, status, dates, chapter and volume counts, serialization magazine, poster and cover images, plus categories, genres and external ids (MyAnimeList, AniList, MangaUpdates…).

**Parameters:**
- `manga` (string, required) — Manga id (`38`), slug (`one-piece`) or kitsu.app/manga/… link.

**Returns:** id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw, chapter_count, volume_count, serialization, manga_type, categories[], genres[], mappings[], external_ids{site: id}

**Example request body:**
```json
{
  "manga": "one-piece"
}
```

### POST https://api.reefapi.com/kitsu/v1/episodes — 1 credit
Every episode of an anime, 20 per page in airing order (or newest first): number, season number, titles, synopsis, air date, length and thumbnail. `number` returns one episode. Kitsu's own total (One Piece: 1,410 episodes).

**Parameters:**
- `media` (string, required) — Anime id, slug or kitsu.app/anime/… link.
- `number` (integer, optional) — Only this episode number.
- `order` (string, optional, default "asc") — asc (default) or desc. [one of: asc, desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, number, season_number, relative_number, canonical_title, titles{}, synopsis, description, airdate, length, thumbnail{original, meta}, created_at, updated_at} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/chapters — 1 credit
Chapters of a manga as Kitsu lists them, 20 per page: number, volume number, titles, synopsis, publish date, length, thumbnail. Kitsu's chapter rows are often bare numbers without titles (One Piece: 5,000 placeholder rows with volume 1) — returned exactly as published.

**Parameters:**
- `media` (string, required) — Manga id, slug or kitsu.app/manga/… link.
- `order` (string, optional, default "asc") — asc (default) or desc. [one of: asc, desc]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, number, volume_number, canonical_title, titles{}, synopsis, published, length, thumbnail} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/characters — 1 credit
The characters of an anime or manga, 20 per page with Kitsu's total (Cowboy Bebop: 125): role (main / supporting), the character (names in every language, other names, description, image, MAL id) and every voice actor with dub language (Japanese, English, French, German…).

**Parameters:**
- `media` (string, required) — Kitsu id (`1`), slug (`cowboy-bebop`) or a kitsu.app/anime/… or /manga/… link. Ids are per kind: anime 1 and manga 1 are different works.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, role, character{id, slug, url, name, canonical_name, names{}, other_names[], description, image{}, mal_id}, voices[]{id, locale, person{id, name, description, image{}}}} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/voice_cast — 2 credits
The voice cast of an anime for ONE dub language, the way the kitsu.app page shows it: featured characters first, each row = character + voice actor. `languages` lists the dub languages Kitsu has for that title (Cowboy Bebop: 8; Japanese cast 103 rows, English 93).

**Parameters:**
- `media` (string, required) — Anime id, slug or kitsu.app/anime/… link.
- `language` (string, optional, default "Japanese") — Dub language as Kitsu names it (Japanese default, English, French, German, Spanish, Italian, Korean, Portuguese…). An unknown one is rejected with the title's own list.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, role, voice_actor, featured, language, character{…}, person{id, name, description, image{}}} + languages[] + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/staff — 1 credit
The staff of an anime or manga, 20 per page with Kitsu's total (Cowboy Bebop: 62): role (Director, Music, Original Creator, Producer…) and the person (name, description, image).

**Parameters:**
- `media` (string, required) — Kitsu id (`1`), slug (`cowboy-bebop`) or a kitsu.app/anime/… or /manga/… link. Ids are per kind: anime 1 and manga 1 are different works.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, role, person{id, name, description, image{}, mal_id}} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/relations — 1 credit
Works related to an anime or manga — sequel, prequel, side story, spin-off, adaptation, summary, alternative version / setting, parent / full story, character crossover — each with the related work's full record. 20 per page with Kitsu's total (One Piece anime: 89). Filter by role.

**Parameters:**
- `media` (string, required) — Kitsu id (`1`), slug (`cowboy-bebop`) or a kitsu.app/anime/… or /manga/… link. Ids are per kind: anime 1 and manga 1 are different works.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `role` (array, optional) — Only these relations (sequel, prequel, side_story, spinoff, adaptation, summary, alternative_setting, alternative_version, parent_story, full_story, character, other); comma = any of. [one of: sequel, prequel, alternative_setting, alternative_version, side_story, parent_story, summary, full_story, spinoff, adaptation, character, other]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, role, destination{id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw…}} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/reactions — 2 credits
Community reactions (Kitsu's short reviews, up to 140 characters) for an anime or manga — or everything one user posted — most up-voted first or newest first, with the author's public profile. Kitsu's total (Cowboy Bebop: 520).

**Parameters:**
- `media` (string, optional) — Anime / manga id, slug or link. Either media or user is required.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `user` (string, optional) — Instead of a title: one user's reactions (user id, slug or profile link).
- `sort` (string, optional, default "popular") — popular (default) or recent. [one of: popular, recent]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, reaction, up_votes_count, created_at, updated_at, held_reason, user{id, slug, name, url, avatar…}, anime{…}|manga{…} (by user)} + total + page + per_page + total_pages + has_more

**Example request body:**
```json
{
  "media": "cowboy-bebop"
}
```

### POST https://api.reefapi.com/kitsu/v1/reviews — 1 credit
Kitsu's long-form reviews (the legacy review system, 13,006 reviews site-wide) for an anime or manga — or by one user — with the full text (plain and HTML), rating, likes, spoiler flag and the author's public profile. Most liked, newest or highest rated first.

**Parameters:**
- `media` (string, optional) — Anime / manga id, slug or link. Either media or user is required.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `user` (string, optional) — Instead of a title: one user's reviews.
- `sort` (string, optional, default "likes") — likes (default), newest or rating. [one of: likes, newest, rating]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, content, content_html, rating, likes_count, progress, source, spoiler, created_at, updated_at, user{…}, media{…} (by user)} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/posts — 2 credits
The community posts feed of an anime or manga (what the kitsu.app page shows under the title): post text (plain and HTML), spoiler / NSFW flags, like and comment counts, edit time, embeds and the author's public profile. Cursor paging: pass `cursor` from the previous page.

**Parameters:**
- `media` (string, required) — Kitsu id (`1`), slug (`cowboy-bebop`) or a kitsu.app/anime/… or /manga/… link. Ids are per kind: anime 1 and manga 1 are different works.
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `cursor` (string, optional) — next_cursor from the previous page.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, content, content_html, post_likes_count, comments_count, top_level_comments_count, spoiler, nsfw, created_at, edited_at, embed, embed_url, user{…}, uploads[], activity_time} + next_cursor + has_more

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

### POST https://api.reefapi.com/kitsu/v1/trending — 1 credit
Kitsu's trending anime or manga right now, full records, in Kitsu's trending order. Kitsu serves trending as one list (no paging; offsets are ignored, measured): `limit` 1-50.

**Parameters:**
- `kind` (string, optional, default "anime") — anime (default) or manga. Inferred from a kitsu.app link or from passing `manga`. [one of: anime, manga]
- `limit` (integer, optional, default 20) — Rows, 1-50 (default 20).

**Returns:** results[]{id, type, slug, url, canonical_title, titles{en, en_jp, ja_jp…}, abbreviated_titles[], synopsis, description, average_rating (0-100), rating_frequencies{2..20: count}, ratings_count, user_count, favorites_count, popularity_rank, rating_rank, start_date, end_date, next_release, tba, age_rating, age_rating_guide, subtype, status, poster_image{tiny…original, meta}, cover_image{…}, cover_image_top_offset, created_at, updated_at, nsfw…} + count

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

### POST https://api.reefapi.com/kitsu/v1/categories — 1 credit
Kitsu's category tree (218 categories): title, slug, description, how many titles carry it, NSFW flag, number of sub-categories and the parent. Use the slugs in `search_anime` / `search_manga`.

**Parameters:**
- `parent` (string, optional) — Only the sub-categories of this category (id or slug).
- `slug` (array, optional) — Only these categories (slug or title, comma separated).
- `sort` (string, optional, default "popular") — popular (most titles first, default) or title. [one of: popular, title]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, slug, title, description, total_media_count, nsfw, child_count, parent{id, slug, title}} + total + page + per_page + total_pages + has_more

**Example request body:**
```json
{
  "parent": "action"
}
```

### POST https://api.reefapi.com/kitsu/v1/genres — 1 credit
Kitsu's genre list (62 genres): name, slug, description. Use the slugs in the search `genre` filter.

**Parameters:**
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, slug, name, description} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/streamers — 1 credit
The 11 streaming platforms Kitsu links to (Hulu, Crunchyroll, Funimation, Netflix, CONtv, HIDIVE, TubiTV, Amazon, YouTube, AnimeLab, VRV) with Kitsu's own streaming_links_count per platform (Hulu 760, Crunchyroll 742 on 2026-11-16; Kitsu prints 0 for several platforms whose links exist).

**Parameters:** none

**Returns:** results[]{id, site_name, streaming_links_count} + total

### POST https://api.reefapi.com/kitsu/v1/character — 2 credits
One character: names in every language, other names, full description, image, MAL id, and every anime / manga the character appears in (role main / supporting) with the voice actors per language.

**Parameters:**
- `character` (string, required) — Character id (`1`), slug (`spike-spiegel`) or a kitsu.app/character/… link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** id, slug, url, name, canonical_name, names{}, other_names[], description, image{}, mal_id, appearances[]{id, role, media{…}, voices[]{locale, person{id, name, image}}} + appearances_total

**Example request body:**
```json
{
  "character": "spike-spiegel"
}
```

### POST https://api.reefapi.com/kitsu/v1/search_characters — 1 credit
Search Kitsu's characters by name (any language, other names included): 'spike' → 541, 'luffy' → 118. Full character records, 20 per page with Kitsu's total.

**Parameters:**
- `query` (string, required) — Character name.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, slug, url, name, canonical_name, names{}, other_names[], description, image{}, mal_id} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/person — 1 credit
One voice actor / staff member: name, description, image and the full credit list in ONE upstream request — every voice role (character + anime + dub language) and every staff role (role + work). Kitsu has no person search; person ids come from `characters`, `voice_cast`, `staff` and `lookup`.

**Parameters:**
- `person` (string, required) — Kitsu person id (numeric).

**Returns:** id, name, description, image{}, mal_id, voices[]{id, locale, media_character{role, character{id, slug, canonical_name, names, image}, media{id, type, slug, canonical_title, subtype, start_date…}}}, staff[]{id, role, media{…}}, voice_roles_count, staff_roles_count

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

### POST https://api.reefapi.com/kitsu/v1/producers — 1 credit
Kitsu's studios / producers / licensors (1,984), 20 per page, by name or newest; `slug` returns one.

**Parameters:**
- `slug` (string, optional) — Only this producer slug.
- `sort` (string, optional, default "name") — name (default) or newest. [one of: name, newest]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, slug, name, created_at, updated_at} + total + page + per_page + total_pages + has_more

**Example request body:**
```json
{
  "slug": "sunrise"
}
```

### POST https://api.reefapi.com/kitsu/v1/producer — 2 credits
One studio / producer / licensor and its anime, 20 per page with Kitsu's total (Sunrise: 916 credits): role (studio, producer, licensor) + the anime's full record.

**Parameters:**
- `producer` (string, required) — Producer id (`1`) or slug (`sunrise`, `production-i-g`).
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** producer{id, slug, name}, results[]{id, role, anime{…}} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/lookup — 1 credit
Translate another site's id into Kitsu: MyAnimeList, AniList, AniDB, TheTVDB, Trakt, MangaUpdates, Anime News Network, Hulu… → the Kitsu record (anime, manga, character, person or producer), in one request. Without `site`, every mapping with that external id is returned.

**Parameters:**
- `external_id` (string, required) — The other site's id.
- `site` (string, optional) — Kitsu's mapping site name: myanimelist/anime, myanimelist/manga, myanimelist/character, myanimelist/people, myanimelist/producer, anilist/anime, anilist/manga, anidb, thetvdb, thetvdb/series, thetvdb/season, trakt, mangaupdates, animenewsnetwork, hulu, aozora… (`mal` = myanimelist/anime, `anilist` = anilist/anime).

**Returns:** results[]{id, external_site, external_id, item{id, type, slug, url, …full record}} + total

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

### POST https://api.reefapi.com/kitsu/v1/search_users — 1 credit
Search Kitsu's public user profiles by name ('josh' → 447). Full public profile per row.

**Parameters:**
- `query` (string, required) — User name or part of it.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, slug, url, name, past_names[], about, location, waifu_or_husbando, followers_count, following_count, life_spent_on_anime, birthday, gender, comments_count, favorites_count, likes_given_count, likes_received_count, reviews_count, posts_count, ratings_count, media_reactions_count, pro_tier, title, website, avatar{}, cover_image{}, created_at, updated_at…} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/user — 1 credit
One public Kitsu profile: name, past names, bio, location, waifu / husbando, follower / following counts, time spent on anime, ratings / reactions / posts counts, birthday and gender when public, PRO tier, avatar and cover, profile links (Twitter, GitHub, website…), the waifu character and the statistics Kitsu computes (anime / manga consumed with percentiles, category breakdown, favourite years, activity history).

**Parameters:**
- `user` (string, required) — User id (`2`), profile slug (`Josh`) or kitsu.app/users/… link.

**Returns:** id, slug, url, name, about, location, … counts …, avatar{}, cover_image{}, profile_links[]{url, profile_link_site{name}}, waifu{…}, stats[]{kind, stats_data{}}

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

### POST https://api.reefapi.com/kitsu/v1/user_library — 2 credits
A user's public library: every anime / manga entry with status, progress, rating (5-point and 20-point), rewatch count, start / finish / last-progress dates, notes, plus the title's full record. Filter by kind and status; `status_counts` gives the per-status totals. Private entries are not served by Kitsu.

**Parameters:**
- `user` (string, required) — User id, slug or profile link.
- `kind` (string, optional) — anime or manga (default both). [one of: anime, manga]
- `status` (string, optional) — current, planned, completed, on_hold, dropped (watching / plan_to_watch accepted). [one of: current, planned, completed, on_hold, dropped]
- `sort` (string, optional, default "updated") — updated (default), progressed, added or rating. [one of: updated, progressed, added, rating]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, status, progress, volumes_owned, reconsuming, reconsume_count, notes, private, rating, rating_twenty, started_at, finished_at, progressed_at, created_at, updated_at, media{…full anime / manga record}} + status_counts{} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/user_favorites — 1 credit
A user's favourites in their own order: anime, manga and characters, each with the full record. Filter by item type.

**Parameters:**
- `user` (string, required) — User id, slug or profile link.
- `item_type` (string, optional) — anime, manga or character (Kitsu favourites hold no people: 0 site-wide, measured). [one of: anime, manga, character]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, fav_rank, created_at, item{…anime | manga | character}} + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/user_follows — 1 credit
Who follows a user, or whom the user follows, newest first, with each profile. Kitsu's total (Josh: 4,098 followers).

**Parameters:**
- `user` (string, required) — User id, slug or profile link.
- `direction` (string, optional, default "followers") — followers (default) or following. [one of: followers, following]
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, created_at, user{…public profile}} + direction + total + page + per_page + total_pages + has_more

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

### POST https://api.reefapi.com/kitsu/v1/user_activity — 1 credit
A user's library history, newest first: each progress / status / rating change with the changed values (before → after) and the title.

**Parameters:**
- `user` (string, required) — User id, slug or profile link.
- `page` (integer, optional, default 1) — Page number, 1-based.
- `per_page` (integer, optional, default 20) — Rows per page, 1-20 (Kitsu's own maximum page size is 20, measured).

**Returns:** results[]{id, kind, changed_data{field: [before, after]}, created_at, anime{…}|manga{…}} + total + page + per_page + total_pages + has_more

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

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