# Bangumi

> Look up anime, manga, novels, music, games and live-action shows in Bangumi (bgm.tv), the Chinese fan database: search and browse titles, read one with its episodes, characters, staff and related titles, see what airs each day this season, look up characters and people, read a member's public profile, collection and lists, and run a workflow when a new episode airs or a member adds to their collection. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/bangumi

## Actions

### Browse subjects

List one kind of subject on Bangumi, such as TV anime, comics or films, optionally from one year and month, newest or highest ranked first.

**Inputs**

- Kind (`subject_type`, text, required): The kind of subject to list. One of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Category (`category`, text): Only subjects in this category of the kind chosen, e.g. Anime: TV. Leave blank for every category. One of: `tv` (Anime: TV), `ova` (Anime: OVA), `movie` (Anime: Movie), `web` (Anime: Web), `comic` (Book: Comic), `novel` (Book: Novel), `illustration` (Book: Art book), `games` (Game: Game), `software` (Game: Software), `dlc` (Game: Expansion), and 9 more.
- Year (`year`, number): Only subjects first aired or released in this year. From 1900 to 2100.
- Month (`month`, number): Only subjects first aired or released in this month of the year, from 1 to 12. Needs a year. From 1 to 12.
- Order (`sort`, text): Which subjects come first. Highest ranked first lists ranked subjects only. One of: `date` (Newest first), `rank` (Highest ranked first). Default: `date`.
- Subjects per page (`page_size`, number): How many subjects to return, from 1 to 50. Defaults to 30. From 1 to 50. Default: `30`.
- Page (`page`, number): Which page to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `category` (text): The category browsed, or null for every category.
- `count` (number): How many subjects are on this page.
- `has_more` (true/false): True when there is another page.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `sort` (text): The order the results are in.
- `subject_type` (text): The kind of subject browsed.
- `subjects` (list): The subjects on this page.
- `total` (number): How many subjects match in all.

**Example output**

```json
{
  "category": "tv",
  "count": 2,
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 5,
  "sort": "rank",
  "subject_type": "anime",
  "subjects": [
    {
      "air_date": "2023-09-29",
      "chinese_name": "\u846c\u9001\u7684\u8299\u8389\u83b2",
      "episodes": 28,
      "image_url": "https://lain.bgm.tv/pic/cover/l/13/c5/400602_ZI8Y9.jpg",
      "original_name": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3",
      "platform": "TV",
      "rank": 43,
      "rating_count": 36825,
      "score": 8.5,
      "subject_id": 400602,
      "subject_type": "anime",
      "summary": "\u9b54\u6cd5\u4f7f\u8299\u8389\u83b2\u548c\u52c7\u8005\u8f9b\u7f8e\u5c14\u7b49\u4eba\u4e00\u8d77\uff0c\u5386\u7ecf\u5341\u5e74\u7684\u5192\u9669\u4e4b\u540e\u51fb\u8d25\u4e86\u9b54\u738b\uff0c\u4e3a\u4e16\u754c\u5e26\u6765\u4e86\u548c\u5e73\u3002",
      "tags": [
        "\u6cbb\u6108",
        "\u516c\u8def\u7247",
        "\u5947\u5e7b",
        "MADHouse",
        "\u6f2b\u753b\u6539"
      ],
      "url": "https://bgm.tv/subject/400602",
      "volumes": null
    },
    {
      "air_date": "2023-09-02",
      "chinese_name": "\u4e94\u7b49\u5206\u7684\u65b0\u5a18\u223d",
      "episodes": 2,
      "image_url": "https://lain.bgm.tv/pic/cover/l/ce/f7/427233_0eqFL.jpg",
      "original_name": "\u4e94\u7b49\u5206\u306e\u82b1\u5ac1\u223d",
      "platform": "TV",
      "rank": 4778,
      "rating_count": 3056,
      "score": 6.6,
      "subject_id": 427233,
      "subject_type": "anime",
      "summary": "\u300c\u843d\u7b2c\u5bf8\u524d\u300d\u300c\u52c9\u5f37\u5acc\u3044\u300d\u306e\u7f8e\u5c11\u5973\u4e94\u3064\u5b50\u3092\u3001",
      "tags": [
        "\u604b\u7231",
        "\u6f2b\u753b\u6539",
        "\u6821\u56ed",
        "\u515a\u4e89",
        "SHAFT"
      ],
      "url": "https://bgm.tv/subject/427233",
      "volumes": null
    }
  ],
  "total": 9
}
```

### Get airing calendar

See which anime air on each day of the week this season, or on one day, with their names, first air date, score and rank.

**Inputs**

- Day (`weekday`, text): The day to list, or the whole week. Today means today in Japan, where the air days are counted. One of: `all` (The whole week), `today` (Today (Japan time)), `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, `sunday`. Default: `all`.

**Outputs**

- `count` (number): How many subjects air on the days listed.
- `days` (list): Each day of the week, Monday first, with what airs on it.
- `weekday` (text): The day asked for, or null for the whole week.

**Example output**

```json
{
  "count": 2,
  "days": [
    {
      "count": 2,
      "subjects": [
        {
          "air_date": "2026-10-02",
          "chinese_name": "\u4e1c\u4eac\u590d\u4ec7\u8005 \u4e09\u5929\u6218\u4e89\u7bc7",
          "episodes": null,
          "image_url": "https://lain.bgm.tv/pic/cover/l/0f/d4/499474_bheyE.jpg",
          "original_name": "\u6771\u4eac\u30ea\u30d9\u30f3\u30b8\u30e3\u30fc\u30ba \u4e09\u5929\u6226\u4e89\u7de8",
          "platform": null,
          "rank": null,
          "rating_count": 48,
          "score": 5.9,
          "subject_id": 499474,
          "subject_type": "anime",
          "summary": null,
          "tags": [],
          "url": "https://bgm.tv/subject/499474",
          "volumes": null
        },
        {
          "air_date": "2026-10-09",
          "chinese_name": "\u67d0\u6697\u90e8\u7684\u5c11\u5973\u5171\u6816",
          "episodes": null,
          "image_url": "https://lain.bgm.tv/pic/cover/l/1c/9b/537738_6rr67.jpg",
          "original_name": "\u3068\u3042\u308b\u6697\u90e8\u306e\u5c11\u5973\u5171\u68f2",
          "platform": null,
          "rank": 2349,
          "rating_count": 608,
          "score": 7.1,
          "subject_id": 537738,
          "subject_type": "anime",
          "summary": null,
          "tags": [],
          "url": "https://bgm.tv/subject/537738",
          "volumes": null
        }
      ],
      "weekday": "Friday",
      "weekday_number": 5
    }
  ],
  "weekday": "Friday"
}
```

### Get character

Get one character from Bangumi: their original and Chinese names, other names, gender, birthday, description and fact sheet.

**Inputs**

- Character (`character`, text, required): The character's Bangumi id or the address of their page, e.g. https://bgm.tv/character/86246.

**Outputs**

- `aliases` (list): Its other names: English, romanized, earlier or fan names.
- `birth_day` (number): The day of the month they were born, when known.
- `birth_month` (number): The month they were born (1 to 12), when known.
- `birth_year` (number): The year they were born, when known.
- `blood_type` (text): Their blood type (A, B, AB or O), when known.
- `character_id` (number): Bangumi's number for the character, e.g. 86246.
- `character_type` (text): What it is: character, mechanic (a robot or vehicle), ship or organization.
- `chinese_name` (text): The character's Chinese name, when Bangumi has one.
- `collected_count` (number): How many members have added the character to favourites.
- `comment_count` (number): How many comments members have left on the character.
- `gender` (text): male or female, when known.
- `image_url` (text): The character's picture.
- `infobox` (list): Bangumi's fact sheet for it, as labelled pairs. Labels are Bangumi's own, in Chinese, e.g. 中文名 (Chinese name), 别名 (other names), 官方网站 (official website).
- `original_name` (text): The character's name in its original language.
- `summary` (text): Bangumi's description of the character.
- `url` (text): The character's page on bgm.tv.

**Example output**

```json
{
  "aliases": [
    "Frieren",
    "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3"
  ],
  "birth_day": null,
  "birth_month": null,
  "birth_year": null,
  "blood_type": null,
  "character_id": 86246,
  "character_type": "character",
  "chinese_name": "\u8299\u8389\u83b2",
  "collected_count": 1045,
  "comment_count": 175,
  "gender": "female",
  "image_url": "https://lain.bgm.tv/pic/crt/l/b5/b6/86246_crt_L0Zmt.jpg",
  "infobox": [
    {
      "label": "\u7b80\u4f53\u4e2d\u6587\u540d",
      "value": "\u8299\u8389\u83b2"
    },
    {
      "label": "\u522b\u540d",
      "value": "\u82f1\u6587\u540d: Frieren, \u6635\u79f0: \u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3"
    },
    {
      "label": "\u6027\u522b",
      "value": "\u5973"
    },
    {
      "label": "\u5f15\u7528\u6765\u6e90",
      "value": "https://frieren-anime.jp/character/chara_group1/1-1/"
    }
  ],
  "original_name": "\u30d5\u30ea\u30fc\u30ec\u30f3",
  "summary": "\u5343\u5e74\u4ee5\u4e0a\u751f\u304d\u308b\u30a8\u30eb\u30d5\u3067\u3001\u52c7\u8005\u30d1\u30fc\u30c6\u30a3\u30fc\u3068\u3057\u3066\u9b54\u738b\u3092\u5012\u3057\u305f\u9b54\u6cd5\u4f7f\u3044\u3002\u9b54\u6cd5\u3067\u3042\u308c\u3070\u3069\u3093\u306a\u3082\u306e\u3067\u3082\u8208\u5473\u3092\u6301\u3064\u9b54\u6cd5\u30aa\u30bf\u30af\u3002\u6027\u683c\u306f\u305a\u307c\u3089\u3067\u30c9\u30e9\u30a4\u3002\u4ef2\u9593\u305f\u3061\u3068\u306e\u65c5\u3092\u7d4c\u3066\u3001\u77e5\u3089\u305a\u77e5\u3089\u305a\u306e\u3046\u3061\u306b\u305d\u306e\u5fc3\u306b\u3082\u5909\u5316\u304c\u73fe\u308c\u308b\u3002",
  "url": "https://bgm.tv/character/86246"
}
```

### Get index

Get a Bangumi index, a list of subjects a member curates: its title, description, author, how many subjects it holds and when it last changed.

**Inputs**

- Index (`index`, text, required): The index's Bangumi id or the address of its page, e.g. https://bgm.tv/index/1. An index is a member's own list of subjects.

**Outputs**

- `collected_count` (number): How many members have added it to favourites.
- `comment_count` (number): How many comments members have left on it.
- `created_at` (text): When it was made (ISO 8601).
- `creator_nickname` (text): The name its author shows.
- `creator_username` (text): Its author's username.
- `description` (text): What the index is about, in its author's words.
- `index_id` (number): Bangumi's number for the index, e.g. 1.
- `subject_count` (number): How many subjects it holds.
- `title` (text): The index's title.
- `updated_at` (text): When it last changed (ISO 8601).
- `url` (text): The index's page on bgm.tv.

**Example output**

```json
{
  "collected_count": 13,
  "comment_count": 2,
  "created_at": "2010-06-05T20:36:14+08:00",
  "creator_nickname": "Sai\ud83d\udd96",
  "creator_username": "sai",
  "description": "Bangumi\u5185\u6838",
  "index_id": 1,
  "subject_count": 9,
  "title": "Chobits \u4eba\u5f62\u7535\u8111\u5929\u4f7f\u5fc3",
  "updated_at": "2025-05-09T22:20:08+08:00",
  "url": "https://bgm.tv/index/1"
}
```

### Get member

Get a Bangumi member's public profile: their nickname, signature, standing and profile picture.

**Inputs**

- Username (`username`, text, required): The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.

**Outputs**

- `avatar_url` (text): Their profile picture.
- `nickname` (text): The name they show.
- `signature` (text): The short line on their profile.
- `url` (text): Their page on bgm.tv.
- `user_group` (text): Their standing on Bangumi, e.g. Member or Wiki editor.
- `user_id` (number): Bangumi's number for the member.
- `username` (text): Their username, as in their page's address.

**Example output**

```json
{
  "avatar_url": "https://lain.bgm.tv/pic/user/l/000/00/00/1_7ZY3S.jpg?r=1755008007&hd=1",
  "nickname": "Sai\ud83d\udd96",
  "signature": "Awesome!",
  "url": "https://bgm.tv/user/sai",
  "user_group": "Administrator",
  "user_id": 1,
  "username": "sai"
}
```

### Get member's collection entry

Check whether a subject is in a Bangumi member's public collection and, if it is, its status, their rating, review, tags and progress.

**Inputs**

- Username (`username`, text, required): The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.
- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.

**Outputs**

- `collected` (true/false): True when the subject is in their public collection. False when it isn't, or they keep it private.
- `comment` (text): Their short review, if any.
- `episodes_done` (number): How many episodes they have marked watched.
- `rating` (number): Their rating, 1 to 10, or null when unrated.
- `status` (text): Where it is in their collection: wish, done, doing, on_hold or dropped.
- `status_label` (text): The status in words, e.g. Wish list or In progress.
- `subject` (object): The subject, as Bangumi lists it, or null when not collected.
- `subject_id` (number): The subject collected.
- `tags` (list): The tags they gave it.
- `updated_at` (text): When they last changed it (ISO 8601).
- `username` (text): Whose collection was checked.
- `volumes_done` (number): How many volumes they have marked read.

**Example output**

```json
{
  "collected": true,
  "comment": null,
  "episodes_done": 0,
  "rating": 8,
  "status": "done",
  "status_label": "Done",
  "subject": {
    "air_date": "2002-04-02",
    "chinese_name": "\u4eba\u5f62\u7535\u8111\u5929\u4f7f\u5fc3",
    "episodes": 27,
    "image_url": "https://lain.bgm.tv/pic/cover/l/c2/0a/12_q23bZ.jpg",
    "original_name": "\u3061\u3087\u3073\u3063\u30c4",
    "platform": null,
    "rank": 945,
    "rating_count": null,
    "score": 7.5,
    "subject_id": 12,
    "subject_type": "anime",
    "summary": "\u5728\u4e0d\u4e45\u7684\u5c06\u6765\uff0c\u7535\u5b50\u6280\u672f\u98de\u901f\u53d1\u5c55\uff0c\u7535\u8111\u6210\u4e3a\u4eba\u4eec\u751f\u6d3b\u4e2d\u4e0d\u53ef\u7f3a\u5c11\u7684\u4e00\u90e8\u5206\u3002\u4e3b\u89d2\u7684\u540d\u5b57\u662f\u672c\u987b\u548c\u79c0\u6811\uff0c\u662f\u4e2a19\u5c81\u7684\u5c11\u5e74\uff0c\u7531\u4e8e\u8003\u8bd5\u5931\u8d25\uff0c\u6765\u5230\u4e1c\u4eac\u4e0a\u8865\u4e60\u73ed\uff0c\u8fc7\u7740\u8d2b\u7a77\u6f66\u5012\u7684\u751f\u6d3b\u2026\u2026",
    "tags": [
      "CLAMP",
      "\u4eba\u5f62\u7535\u8111\u5929\u4f7f\u5fc3",
      "MADHouse",
      "TV",
      "2002"
    ],
    "url": "https://bgm.tv/subject/12",
    "volumes": null
  },
  "subject_id": 12,
  "tags": [],
  "updated_at": "2008-07-14T21:00:52+08:00",
  "username": "sai",
  "volumes_done": 0
}
```

### Get person

Get one person or company from Bangumi: their original and Chinese names, other names, careers, birthday, biography and fact sheet.

**Inputs**

- Person (`person`, text, required): The person's or company's Bangumi id or the address of their page, e.g. https://bgm.tv/person/7575.

**Outputs**

- `aliases` (list): Its other names: English, romanized, earlier or fan names.
- `birth_day` (number): The day of the month they were born, when known.
- `birth_month` (number): The month they were born (1 to 12), when known.
- `birth_year` (number): The year they were born, when known.
- `blood_type` (text): Their blood type (A, B, AB or O), when known.
- `careers` (list): What they do: Voice actor, Producer, Manga artist, Musician, Writer, Illustrator or Actor.
- `chinese_name` (text): Their Chinese name, when Bangumi has one.
- `collected_count` (number): How many members have added them to favourites.
- `comment_count` (number): How many comments members have left on them.
- `gender` (text): male or female, when known.
- `image_url` (text): Their photo or picture.
- `infobox` (list): Bangumi's fact sheet for it, as labelled pairs. Labels are Bangumi's own, in Chinese, e.g. 中文名 (Chinese name), 别名 (other names), 官方网站 (official website).
- `original_name` (text): Their name in its original language.
- `person_id` (number): Bangumi's number for the person, e.g. 7575.
- `person_type` (text): Whether it is an individual, a company or a group.
- `summary` (text): Bangumi's biography of them.
- `url` (text): The person's page on bgm.tv.

**Example output**

```json
{
  "aliases": [
    "\u7a2e\u5d0e\u6566\u7f8e",
    "\u7a2e\ufa11 \u6566\u7f8e",
    "\u305f\u306d\u3056\u304d \u3042\u3064\u307f"
  ],
  "birth_day": 27,
  "birth_month": 9,
  "birth_year": 1990,
  "blood_type": null,
  "careers": [
    "Musician",
    "Voice actor"
  ],
  "chinese_name": "\u79cd\u5d0e\u6566\u7f8e",
  "collected_count": 2965,
  "comment_count": 565,
  "gender": "female",
  "image_url": "https://lain.bgm.tv/pic/crt/l/7a/a7/7575_prsn_8TJlL.jpg?r=1671262190",
  "infobox": [
    {
      "label": "\u7b80\u4f53\u4e2d\u6587\u540d",
      "value": "\u79cd\u5d0e\u6566\u7f8e"
    },
    {
      "label": "\u522b\u540d",
      "value": "\u7a2e\u5d0e\u6566\u7f8e, \u65e5\u6587\u540d: \u7a2e\ufa11 \u6566\u7f8e, \u7eaf\u5047\u540d: \u305f\u306d\u3056\u304d \u3042\u3064\u307f, \u7f57\u9a6c\u5b57: Tanezaki Atsumi, \u6635\u79f0: \u305f\u306d\u3061\u3083\u3093\u30fb\u3042\u3063\u3061\u3083\u3093\uff08\u963f\u9171\uff0c\u53d6\u81eaAtsumi\u7684A\uff09\u30fb\u30b7\u30fc\u30c9\u3055\u3093\u30fb\u305f\u306d\u30d1\u30a4, \u4e2d\u6587\u6635\u79f0: \u534e\u54e5\u3001\u534e\u7237, \u5176\u4ed6\u540d\u4e49: \u3042\u3044\u3053 = \u6850\u8c37\u83ef = \u9ed2\u54b2\u307e\u3064\u308a = \u3068\u307e\u3068\u3042\u3044\u3053 = \u6ca2\u6fa4\u7802\u7fbd = \u6885\u672c\u8a69\u7dd2"
    },
    {
      "label": "\u6027\u522b",
      "value": "\u5973"
    },
    {
      "label": "\u751f\u65e5",
      "value": "1990\u5e749\u670827\u65e5"
    }
  ],
  "original_name": "\u7a2e\ufa11\u6566\u7f8e",
  "person_id": 7575,
  "person_type": "individual",
  "summary": "\u7a2e\ufa11 \u6566\u7f8e\uff08\u305f\u306d\u3056\u304d \u3042\u3064\u307f\u30019\u670827\u65e5 - \uff09\u306f\u65e5\u672c\u306e\u5973\u6027\u58f0\u512a\u3002\u30c8\u30ea\u30c8\u30ea\u30aa\u30d5\u30a3\u30b9\u6240\u5c5e\u3002\u5927\u5206\u770c\u51fa\u8eab\u3002",
  "url": "https://bgm.tv/person/7575"
}
```

### Get subject

Get one anime, book, album, game or show from Bangumi: its original and Chinese names, other names, air date, episodes, score, rank, tags, description, how many members collected it and its full fact sheet.

**Inputs**

- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.

**Outputs**

- `air_date` (text): When it first aired or was released (YYYY-MM-DD), when known.
- `aliases` (list): Its other names: English, romanized, earlier or fan names.
- `chinese_name` (text): Its Chinese name, or null when Bangumi has none.
- `collection_counts` (object): How many members have it in their collection, by status.
- `episodes` (number): How many episodes it has, when known.
- `image_url` (text): Its cover or poster image.
- `infobox` (list): Bangumi's fact sheet for it, as labelled pairs. Labels are Bangumi's own, in Chinese, e.g. 中文名 (Chinese name), 别名 (other names), 官方网站 (official website).
- `is_series` (true/false): True for a book that is a series, not one volume.
- `meta_tags` (list): Bangumi's own tags for it, e.g. TV, 日本 (Japan), 漫画改 (manga adaptation).
- `nsfw` (true/false): True when Bangumi marks it as adult content.
- `original_name` (text): Its name in its original language, often Japanese.
- `platform` (text): Its format as Bangumi files it, e.g. TV, OVA or WEB for anime, or 漫画 (comic) and 小说 (novel) for books.
- `rank` (number): Its place in Bangumi's ranking of its kind (1 is best), or null when unranked.
- `rating_count` (number): How many members have rated it, when given.
- `score` (number): Its average rating from members, out of 10, when rated.
- `subject_id` (number): Bangumi's number for the subject, e.g. 400602.
- `subject_type` (text): What kind of subject it is: anime, book, music, game or real (live-action TV and film).
- `summary` (text): Bangumi's description of it, usually in Chinese.
- `tags` (list): The tags members give it most, up to 10, often in Chinese.
- `total_episodes` (number): How many episodes Bangumi lists for it, specials included.
- `url` (text): The subject's page on bgm.tv.
- `volumes` (number): How many volumes a book has, when known.

**Example output**

```json
{
  "air_date": "2023-09-29",
  "aliases": [
    "Frieren: Beyond Journey's End",
    "Sousou no Frieren",
    "\u846c\u9001\u7684\u8299\u8389\u84ee"
  ],
  "chinese_name": "\u846c\u9001\u7684\u8299\u8389\u83b2",
  "collection_counts": {
    "doing": 11909,
    "done": 55632,
    "dropped": 776,
    "on_hold": 2073,
    "wish": 7164
  },
  "episodes": 28,
  "image_url": "https://lain.bgm.tv/pic/cover/l/13/c5/400602_ZI8Y9.jpg",
  "infobox": [
    {
      "label": "\u4e2d\u6587\u540d",
      "value": "\u846c\u9001\u7684\u8299\u8389\u83b2"
    },
    {
      "label": "\u522b\u540d",
      "value": "Frieren: Beyond Journey's End, Sousou no Frieren, \u846c\u9001\u7684\u8299\u8389\u84ee"
    },
    {
      "label": "\u8bdd\u6570",
      "value": "28"
    },
    {
      "label": "\u653e\u9001\u5f00\u59cb",
      "value": "2023\u5e749\u670829\u65e5"
    }
  ],
  "is_series": false,
  "meta_tags": [
    "TV",
    "\u65e5\u672c",
    "\u5947\u5e7b",
    "\u6f2b\u753b\u6539"
  ],
  "nsfw": false,
  "original_name": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3",
  "platform": "TV",
  "rank": 43,
  "rating_count": 36825,
  "score": 8.5,
  "subject_id": 400602,
  "subject_type": "anime",
  "summary": "\u9b54\u6cd5\u4f7f\u8299\u8389\u83b2\u548c\u52c7\u8005\u8f9b\u7f8e\u5c14\u7b49\u4eba\u4e00\u8d77\uff0c\u5386\u7ecf\u5341\u5e74\u7684\u5192\u9669\u4e4b\u540e\u51fb\u8d25\u4e86\u9b54\u738b\uff0c\u4e3a\u4e16\u754c\u5e26\u6765\u4e86\u548c\u5e73\u3002",
  "tags": [
    "\u6cbb\u6108",
    "\u516c\u8def\u7247",
    "\u5947\u5e7b",
    "MADHouse",
    "\u6f2b\u753b\u6539"
  ],
  "total_episodes": 36,
  "url": "https://bgm.tv/subject/400602",
  "volumes": null
}
```

### List character subjects

List the anime, books, games and other subjects a character appears in, with their part in each.

**Inputs**

- Character (`character`, text, required): The character's Bangumi id or the address of their page, e.g. https://bgm.tv/character/86246.

**Outputs**

- `character_id` (number): The character whose subjects these are.
- `count` (number): How many subjects the character appears in.
- `subjects` (list): The subjects the character appears in.

**Example output**

```json
{
  "character_id": 86246,
  "count": 2,
  "subjects": [
    {
      "chinese_name": "\u6d1b\u5947",
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/f4/a4/1817_g3ODP.jpg",
      "original_name": "\ub9c8\ube44\ub178\uae30",
      "role": "Guest",
      "role_chinese": "\u5ba2\u4e32",
      "subject_id": 1817,
      "subject_type": "game",
      "url": "https://bgm.tv/subject/1817"
    },
    {
      "chinese_name": "\u846c\u9001\u7684\u8299\u8389\u83b2",
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/a1/bd/305429_axzF3.jpg",
      "original_name": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3",
      "role": "Main",
      "role_chinese": "\u4e3b\u89d2",
      "subject_id": 305429,
      "subject_type": "book",
      "url": "https://bgm.tv/subject/305429"
    }
  ]
}
```

### List episodes

List a subject's episodes in order, each with its number, original and Chinese title, the day it aired, its length and description.

**Inputs**

- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.
- Episodes (`episode_type`, text): Which episodes to list. Defaults to the main story. One of: `main` (Main story), `special` (Specials), `opening` (Openings), `ending` (Endings), `trailer` (Trailers and promos), `mad` (Fan edits (MAD)), `other`, `all` (All episodes). Default: `main`.
- Episodes per page (`page_size`, number): How many episodes to return, from 1 to 200. Defaults to 100. From 1 to 200. Default: `100`.
- Page (`page`, number): Which page to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many episodes are on this page.
- `episode_type` (text): The kind of episodes listed, or all.
- `episodes` (list): The episodes on this page.
- `has_more` (true/false): True when there is another page.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `subject_id` (number): The subject whose episodes these are.
- `total` (number): How many episodes match in all.

**Example output**

```json
{
  "count": 2,
  "episode_type": "main",
  "episodes": [
    {
      "air_date": "2023-09-29",
      "chinese_name": "\u5192\u9669\u7ed3\u675f",
      "comment_count": 297,
      "description": "\u9b54\u738b\u3092\u5012\u3057\u738b\u90fd\u3078\u51f1\u65cb\u3057\u305f\u52c7\u8005\u30d2\u30f3\u30e1\u30eb\u4e00\u884c\u3002\u5404\u3005\u304c\u5192\u967a\u3057\u305f10\u5e74\u3092\u632f\u308a\u8fd4\u308a\u306a\u304c\u3089\u3053\u308c\u304b\u3089\u306e\u4eba\u751f\u306b\u60f3\u3044\u3092\u99b3\u305b\u308b\u4e2d\u3001\u30a8\u30eb\u30d5\u306e\u30d5\u30ea\u30fc\u30ec\u30f3\u306f\u611f\u6168\u306b\u3075\u3051\u308b\u3053\u3068\u3082\u306a\u304f\u3001\u307e\u305f\u9b54\u6cd5\u63a2\u6c42\u3078\u3068\u65c5\u7acb\u3063\u3066\u3044\u304f\u300250\u5e74\u5f8c\u3001\u7686\u3068\u306e\u7d04\u675f\u306e\u305f\u3081\u30d5\u30ea\u30fc\u30ec\u30f3\u306f\u518d\u3073\u738b\u90fd\u3078\u3002\u305d\u306e\u518d\u4f1a\u3092\u304d\u3063\u304b\u3051\u306b\u3001\u5f7c\u5973\u306f\u65b0\u305f\u306a\u65c5\u3078\u3068\u5411\u304b\u3046\u3053\u3068\u306b\u2015\u3002",
      "disc": null,
      "duration": "00:26:00",
      "duration_seconds": 1560,
      "episode_id": 1227087,
      "episode_type": "main",
      "number": 1.0,
      "original_name": "\u5192\u967a\u306e\u7d42\u308f\u308a",
      "sort": 1.0,
      "subject_id": 400602,
      "url": "https://bgm.tv/ep/1227087"
    },
    {
      "air_date": "2023-09-29",
      "chinese_name": "\u4e0d\u89c1\u5f97\u4e00\u5b9a\u662f\u9760\u9b54\u6cd5\u2026",
      "comment_count": 137,
      "description": "\u68ee\u6df1\u304f\u306b\u66ae\u3089\u3059\u30cf\u30a4\u30bf\u30fc\u3092\u8a2a\u306d\u305f\u30d5\u30ea\u30fc\u30ec\u30f3\u306f\u3001\u5f7c\u3068\u5171\u306b\u66ae\u3089\u3059\u5b64\u5150\u30d5\u30a7\u30eb\u30f3\u3068\u51fa\u4f1a\u3046\u3002\u30cf\u30a4\u30bf\u30fc\u304b\u3089\u983c\u307e\u308c\u5f7c\u5973\u306b\u9b54\u6cd5\u3092\u6559\u3048\u308b\u30d5\u30ea\u30fc\u30ec\u30f3\u3002\u305d\u3057\u3066\u3042\u308b\u51fa\u6765\u4e8b\u3092\u6a5f\u306b\u3001\u5171\u306b\u65c5\u7acb\u3063\u3066\u3044\u304f\u3002",
      "disc": null,
      "duration": "00:26:00",
      "duration_seconds": 1560,
      "episode_id": 1227088,
      "episode_type": "main",
      "number": 2.0,
      "original_name": "\u5225\u306b\u9b54\u6cd5\u3058\u3083\u306a\u304f\u305f\u3063\u3066\u2026",
      "sort": 2.0,
      "subject_id": 400602,
      "url": "https://bgm.tv/ep/1227088"
    }
  ],
  "has_more": false,
  "next_page": null,
  "page": 1,
  "page_size": 30,
  "subject_id": 400602,
  "total": 28
}
```

### List index subjects

List the subjects in a Bangumi index, in the order they were added, each with the author's note on it.

**Inputs**

- Index (`index`, text, required): The index's Bangumi id or the address of its page, e.g. https://bgm.tv/index/1. An index is a member's own list of subjects.
- Kind (`subject_type`, text): Only subjects of this kind. Leave blank for every kind. One of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Subjects per page (`page_size`, number): How many subjects to return, from 1 to 50. Defaults to 30. From 1 to 50. Default: `30`.
- Page (`page`, number): Which page to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `count` (number): How many subjects are on this page.
- `has_more` (true/false): True when there is another page.
- `index_id` (number): The index these subjects are in.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `subject_type` (text): The kind of subject listed, or null for every kind.
- `subjects` (list): The subjects on this page.
- `total` (number): How many subjects match in all.

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "index_id": 1,
  "next_page": null,
  "page": 1,
  "page_size": 30,
  "subject_type": null,
  "subjects": [
    {
      "added_at": "2010-06-05T20:36:32+08:00",
      "air_date": "2002-04-02",
      "chinese_name": "\u4eba\u5f62\u7535\u8111\u5929\u4f7f\u5fc3",
      "comment": "\u56e0\u4e3a\u7bc7\u5e45\u5173\u7cfb\u52a8\u753b\u5927\u90e8\u5206\u65f6\u95f4\u90fd\u7528\u5728\u5356\u840c\u4e0a\u4e86\uff0c\u7ed3\u5c40\u4e0e\u6f2b\u753b\u5927\u76f8\u5f84\u5ead",
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/c2/0a/12_q23bZ.jpg",
      "original_name": "\u3061\u3087\u3073\u3063\u30c4",
      "platform": null,
      "rank": null,
      "rating_count": null,
      "score": null,
      "subject_id": 12,
      "subject_type": "anime",
      "summary": null,
      "tags": [],
      "url": "https://bgm.tv/subject/12",
      "volumes": null
    },
    {
      "added_at": "2010-06-05T20:36:41+08:00",
      "air_date": "2001-02-06",
      "chinese_name": "\u4eba\u5f62\u7535\u8111\u5929\u4f7f\u5fc3",
      "comment": "\u5927\u5988\u4eec\u9752\u5e74\u6f2b\u753b\u7684\u8bd5\u6c34\u4e4b\u4f5c\uff0c\u6f2b\u753b\u5267\u60c5\u4fdd\u6301\u4e86\u4e00\u8d2f\u7684\u6c34\u51c6",
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/73/80/497_7mGTv.jpg",
      "original_name": "\u3061\u3087\u3073\u3063\u30c4",
      "platform": null,
      "rank": null,
      "rating_count": null,
      "score": null,
      "subject_id": 497,
      "subject_type": "book",
      "summary": null,
      "tags": [],
      "url": "https://bgm.tv/subject/497",
      "volumes": null
    }
  ],
  "total": 7
}
```

### List member's collection

List the subjects in a Bangumi member's public collection, most recently updated first, each with its status (wish list, in progress, done, on hold or dropped), their rating, review and progress.

**Inputs**

- Username (`username`, text, required): The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.
- Kind (`subject_type`, text): Only subjects of this kind. Leave blank for every kind. One of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Status (`collection_type`, text): Only subjects with this status. Leave blank for every status. One of: `wish` (Wish list), `done`, `doing` (In progress), `on_hold` (On hold), `dropped`.
- Entries per page (`page_size`, number): How many entries to return, from 1 to 50. Defaults to 30. From 1 to 50. Default: `30`.
- Page (`page`, number): Which page to return, from 1. From 1 to 10000. Default: `1`.

**Outputs**

- `collection_type` (text): The status listed, or null for every status.
- `collections` (list): The collection entries on this page.
- `count` (number): How many collection entries are on this page.
- `has_more` (true/false): True when there is another page.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `subject_type` (text): The kind of subject listed, or null for every kind.
- `total` (number): How many collection entries match in all.
- `username` (text): Whose collection this is.

**Example output**

```json
{
  "collection_type": "done",
  "collections": [
    {
      "comment": "\u6280\u672f\u8001\u662f\u60c5\u6000\uff0c\u6545\u4e8b\u8001\u662f\u6478\u9c7c\u3002",
      "episodes_done": 0,
      "rating": 6,
      "status": "done",
      "status_label": "Done",
      "subject": {
        "air_date": "2026-09-18",
        "chinese_name": "\u5c0f\u7f8a\u8096\u60693\uff1a\u602a\u517d\u6765\u88ad",
        "episodes": 1,
        "image_url": "https://lain.bgm.tv/pic/cover/l/00/40/557818_R3xCC.jpg",
        "original_name": "Shaun the Sheep: The Beast of Mossy Bottom",
        "platform": null,
        "rank": null,
        "rating_count": null,
        "score": 6.0,
        "subject_id": 557818,
        "subject_type": "anime",
        "summary": "\u4e07\u5723\u8282\u524d\u5915\uff0c\u5c0f\u7f8a\u8096\u6069\u6b63\u5e26\u9886\u7f8a\u7fa4\u79d8\u5bc6\u7b79\u5907\u8282\u65e5\u6d3e\u5bf9\u3002\u519c\u592b\u6253\u7b97\u7ea6\u4f1a\u5fc3\u4eea\u7684\u5973\u517d\u533b\uff0c\u672c\u60f3\u7528\u751f\u53d1\u6db2\u6539\u5584\u5f62\u8c61\uff0c\u5374\u56e0\u519c\u573a\u7a81\u53d1\u6df7\u4e71\uff0c\u4e0d\u4ec5\u9519\u5931\u9080\u7ea6\uff0c\u8fd8\u6bc1\u4e86\u7f8a\u7fa4\u6240\u6709\u7684\u5357\u74dc\u3002\u8096\u6069\u4e3a\u8865\u6551\u5316\u8eab\u201c\u75af\u72c2\u79d1\u5b66\u5bb6\u201d\uff0c\u7814\u5236\u51fa\u52a0\u901f\u751f\u957f\u836f\u5242\uff0c\u5374\u610f\u5916\u6df7\u5165\u4e86\u519c\u592b\u7684\u751f\u53d1\u6db2\u3002\u4e0d\u77e5\u60c5\u7684\u519c\u592b\u6d82",
        "tags": [
          "2026",
          "\u82f1\u56fd",
          "\u5b9a\u683c\u52a8\u753b",
          "\u6b27\u7f8e",
          "\u539f\u521b"
        ],
        "url": "https://bgm.tv/subject/557818",
        "volumes": null
      },
      "subject_id": 557818,
      "tags": [
        "2026",
        "\u82f1\u56fd",
        "\u5b9a\u683c\u52a8\u753b"
      ],
      "updated_at": "2026-10-31T21:38:53+08:00",
      "volumes_done": 0
    },
    {
      "comment": "\u5728\u4e3b\u89d2\u56e2\u53ea\u6709\u4e00\u4eba\u80fd\u8bf4\u8bdd\u7684\u60c5\u51b5\u4e0b\u7adf\u80fd\u6491\u8d77\u4e00\u90e8\u5267\u573a\u7248\uff0c\u5173\u952e\u5267\u60c5\u66f4\u662f\u7eaf\u7cb9\u5f71\u50cf\u53d9\u4e8b\u3002\u6bd4\u8d77\u540c\u6863\u671f\u7684\u5f85\u5ba2\u4e4b\u9053\u66f4\u559c\u6b22\u8fd9\u90e8\u9633\u5149\u5965\u5fb7\u8d5b\u3002",
      "episodes_done": 0,
      "rating": 7,
      "status": "done",
      "status_label": "Done",
      "subject": {
        "air_date": "2026-07-24",
        "chinese_name": "\u5267\u573a\u7248 \u5409\u4f0a\u5361\u54c7 \u4eba\u9c7c\u5c9b\u7684\u79d8\u5bc6",
        "episodes": 1,
        "image_url": "https://lain.bgm.tv/pic/cover/l/6e/fc/610494_LCo8L.jpg",
        "original_name": "\u6620\u753b\u3061\u3044\u304b\u308f \u4eba\u9b5a\u306e\u5cf6\u306e\u3072\u307f\u3064",
        "platform": null,
        "rank": 1955,
        "rating_count": null,
        "score": 7.2,
        "subject_id": 610494,
        "subject_type": "anime",
        "summary": "\u67d0\u5929\uff0c\u5f53\u5409\u4f0a\u5361\u54c7\u4e0e\u5c0f\u516b\u732b\u5728\u5e7f\u573a\u4f11\u606f\u65f6\uff0c\u5154\u5154\u7a81\u7136\u8138\u4e0a\u8d34\u7740\u4e00\u5f20\u4f20\u5355\u73b0\u8eab\u3002\u5c0f\u516b\u732b\u786e\u8ba4\u4f20\u5355\u540e\u53d1\u73b0\uff0c\u90a3\u662f\u4e00\u5f20\u5199\u7740\u300c\u7279\u522b\u5c9b\u5c7f\u9080\u8bf7\u51fd\u300d\u7684\u62db\u5f85\u5238\u3002",
        "tags": [
          "\u5267\u573a\u7248",
          "2026",
          "CygamesPictures",
          "\u6f2b\u753b\u6539",
          "\u65e5\u672c"
        ],
        "url": "https://bgm.tv/subject/610494",
        "volumes": null
      },
      "subject_id": 610494,
      "tags": [
        "\u65e5\u672c",
        "\u5267\u573a\u7248",
        "2026"
      ],
      "updated_at": "2026-10-24T01:00:00+08:00",
      "volumes_done": 0
    }
  ],
  "count": 2,
  "has_more": true,
  "next_page": 2,
  "page": 1,
  "page_size": 5,
  "subject_type": "anime",
  "total": 251,
  "username": "sai"
}
```

### List person's roles

List the characters a voice actor or actor played, each with the subject they played them in and their part in it.

**Inputs**

- Person (`person`, text, required): The person's or company's Bangumi id or the address of their page, e.g. https://bgm.tv/person/7575.
- Kinds (`subject_types`, list): Only subjects of these kinds. Leave blank for every kind. One or more of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Most results (`limit`, number): The most rows to list, from 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `characters` (list): The roles, in Bangumi's order.
- `count` (number): How many roles are listed.
- `has_more` (true/false): True when more roles match than are listed.
- `person_id` (number): The person who voiced or played these characters.
- `total` (number): How many roles match in all.

**Example output**

```json
{
  "characters": [
    {
      "character_id": 150055,
      "character_name": "\u72ac\u98fc\u3044\u308d\u306f\uff0f\u30ad\u30e5\u30a2\u30d5\u30ec\u30f3\u30c7\u30a3",
      "image_url": "https://lain.bgm.tv/pic/crt/l/39/d4/150055_crt_JHbYt.jpg?r=1718017137",
      "role": "Guest",
      "role_chinese": "\u5ba2\u4e32",
      "subject_chinese_name": "\u8721\u7b14\u5c0f\u65b0",
      "subject_id": 24823,
      "subject_original_name": "\u30af\u30ec\u30e8\u30f3\u3057\u3093\u3061\u3083\u3093",
      "subject_type": "anime",
      "subject_url": "https://bgm.tv/subject/24823",
      "url": "https://bgm.tv/character/150055"
    },
    {
      "character_id": 16653,
      "character_name": "\u590f\u76ee\u3042\u3055\u5b50",
      "image_url": "https://lain.bgm.tv/pic/crt/l/a7/b6/16653_crt_17MOl.jpg",
      "role": "Supporting",
      "role_chinese": "\u914d\u89d2",
      "subject_chinese_name": "\u90bb\u5ea7\u7684\u602a\u540c\u5b66",
      "subject_id": 40533,
      "subject_original_name": "\u3068\u306a\u308a\u306e\u602a\u7269\u304f\u3093",
      "subject_type": "anime",
      "subject_url": "https://bgm.tv/subject/40533",
      "url": "https://bgm.tv/character/16653"
    }
  ],
  "count": 2,
  "has_more": true,
  "person_id": 7575,
  "total": 259
}
```

### List person's work

List the subjects a person or company worked on, with their job on each, optionally only some kinds or jobs.

**Inputs**

- Person (`person`, text, required): The person's or company's Bangumi id or the address of their page, e.g. https://bgm.tv/person/7575.
- Kinds (`subject_types`, list): Only subjects of these kinds. Leave blank for every kind. One or more of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Job contains (`role`, text): Only credits whose job contains this text, in English or Chinese, e.g. director or 导演. Leave blank for every job.
- Most results (`limit`, number): The most rows to list, from 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many subjects are listed.
- `has_more` (true/false): True when more subjects match than are listed.
- `person_id` (number): The person whose work this is.
- `subjects` (list): The subjects, in Bangumi's order.
- `total` (number): How many subjects match in all.

**Example output**

```json
{
  "count": 2,
  "has_more": true,
  "person_id": 7575,
  "subjects": [
    {
      "chinese_name": null,
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/f1/25/548519_ImPlM.jpg",
      "original_name": "THE IDOLM@STER M@STERS OF IDOL WORLD!!!!! 2023\u3000\u660e\u65e5\u304d\u307f\u306bJewel",
      "role": "Artist",
      "role_chinese": "\u827a\u672f\u5bb6",
      "subject_id": 548519,
      "subject_type": "music",
      "url": "https://bgm.tv/subject/548519"
    },
    {
      "chinese_name": "\u5927\u56fe\u4e66\u9986\u7684\u7267\u7f8a\u4eba",
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/7c/53/24796_m5i8U.jpg",
      "original_name": "\u5927\u56f3\u66f8\u9928\u306e\u7f8a\u98fc\u3044",
      "role": "Inserted Song Performance",
      "role_chinese": "\u63d2\u5165\u6b4c\u6f14\u51fa",
      "subject_id": 24796,
      "subject_type": "game",
      "url": "https://bgm.tv/subject/24796"
    }
  ],
  "total": 154
}
```

### List related subjects

List the subjects related to one: sequels and prequels, the manga or novel it adapts, spin-offs, soundtracks and theme songs, each with how it is related.

**Inputs**

- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.

**Outputs**

- `count` (number): How many related subjects there are.
- `subject_id` (number): The subject the others are related to.
- `subjects` (list): The related subjects.

**Example output**

```json
{
  "count": 2,
  "subject_id": 400602,
  "subjects": [
    {
      "chinese_name": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/22/90/459398_7N2k1.jpg",
      "original_name": "TV\u30a2\u30cb\u30e1\u300e\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3\u300f\u516c\u5f0f\u30b9\u30bf\u30fc\u30c6\u30a3\u30f3\u30b0\u30ac\u30a4\u30c9",
      "relation": "Other",
      "relation_chinese": "\u5176\u4ed6",
      "subject_id": 459398,
      "subject_type": "book",
      "url": "https://bgm.tv/subject/459398"
    },
    {
      "chinese_name": null,
      "image_url": "https://lain.bgm.tv/pic/cover/l/9f/b4/660333_21tpZ.jpg",
      "original_name": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3\uff0f\u30df\u30e5\u30fc\u30b8\u30c3\u30af\u30fb\u30b3\u30ec\u30af\u30b7\u30e7\u30f3",
      "relation": "Book",
      "relation_chinese": "\u4e66\u7c4d",
      "subject_id": 660333,
      "subject_type": "book",
      "url": "https://bgm.tv/subject/660333"
    }
  ]
}
```

### List subject characters

List the characters in a subject, main characters first, each with their part (main, supporting or guest) and who voices or plays them.

**Inputs**

- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.
- Parts (`roles`, list): Only characters with these parts. Leave blank for all. One or more of: `main`, `supporting`, `guest`.
- Most results (`limit`, number): The most rows to list, from 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `characters` (list): The characters, in Bangumi's order.
- `count` (number): How many characters are listed.
- `has_more` (true/false): True when more characters match than are listed.
- `subject_id` (number): The subject whose characters these are.
- `total` (number): How many characters match in all.

**Example output**

```json
{
  "characters": [
    {
      "character_id": 86246,
      "character_type": "character",
      "image_url": "https://lain.bgm.tv/pic/crt/l/b5/b6/86246_crt_L0Zmt.jpg",
      "original_name": "\u30d5\u30ea\u30fc\u30ec\u30f3",
      "role": "Main",
      "role_chinese": "\u4e3b\u89d2",
      "summary": "\u5343\u5e74\u4ee5\u4e0a\u751f\u304d\u308b\u30a8\u30eb\u30d5\u3067\u3001\u52c7\u8005\u30d1\u30fc\u30c6\u30a3\u30fc\u3068\u3057\u3066\u9b54\u738b\u3092\u5012\u3057\u305f\u9b54\u6cd5\u4f7f\u3044\u3002\u9b54\u6cd5\u3067\u3042\u308c\u3070\u3069\u3093\u306a\u3082\u306e\u3067\u3082\u8208\u5473\u3092\u6301\u3064\u9b54\u6cd5\u30aa\u30bf\u30af\u3002\u6027\u683c\u306f\u305a\u307c\u3089\u3067\u30c9\u30e9\u30a4\u3002\u4ef2\u9593\u305f\u3061\u3068\u306e\u65c5\u3092\u7d4c\u3066\u3001\u77e5\u3089\u305a\u77e5\u3089\u305a\u306e\u3046\u3061\u306b\u305d\u306e\u5fc3\u306b\u3082\u5909\u5316\u304c\u73fe\u308c\u308b\u3002",
      "url": "https://bgm.tv/character/86246",
      "voice_actors": [
        {
          "image_url": "https://lain.bgm.tv/pic/crt/l/7a/a7/7575_prsn_8TJlL.jpg?r=1671262190",
          "original_name": "\u7a2e\ufa11\u6566\u7f8e",
          "person_id": 7575,
          "url": "https://bgm.tv/person/7575"
        },
        {
          "image_url": "https://lain.bgm.tv/pic/crt/l/de/c8/40218_prsn_zS44f.jpg?r=1606409079",
          "original_name": "\u674e\u8749\u5983",
          "person_id": 40218,
          "url": "https://bgm.tv/person/40218"
        }
      ]
    },
    {
      "character_id": 86247,
      "character_type": "character",
      "image_url": "https://lain.bgm.tv/pic/crt/l/38/6d/86247_crt_K4gRr.jpg",
      "original_name": "\u30d5\u30a7\u30eb\u30f3",
      "role": "Main",
      "role_chinese": "\u4e3b\u89d2",
      "summary": "\u30d5\u30ea\u30fc\u30ec\u30f3\u306e\u5f1f\u5b50\u3068\u3057\u3066\u5171\u306b\u65c5\u3092\u3059\u308b\u3053\u3068\u306b\u306a\u308b\u9b54\u6cd5\u4f7f\u3044\u3002\u30cf\u30a4\u30bf\u30fc\u306b\u80b2\u3066\u3089\u308c\u305f\u6226\u707d\u5b64\u5150\u3002\u51b7\u9759\u306a\u5c11\u5973\u3067\u3001\u751f\u6d3b\u9762\u3067\u305a\u307c\u3089\u306a\u30d5\u30ea\u30fc\u30ec\u30f3\u306e\u304a\u6bcd\u3055\u3093\u5f79\u3002",
      "url": "https://bgm.tv/character/86247",
      "voice_actors": [
        {
          "image_url": "https://lain.bgm.tv/pic/crt/l/eb/38/31136_prsn_BfZxJ.jpg?r=1737363637",
          "original_name": "\u5e02\u30ce\u702c\u52a0\u90a3",
          "person_id": 31136,
          "url": "https://bgm.tv/person/31136"
        },
        {
          "image_url": "https://lain.bgm.tv/pic/crt/l/d1/1a/39785_prsn_GvdrW.jpg",
          "original_name": "\u82cf\u5a49",
          "person_id": 39785,
          "url": "https://bgm.tv/person/39785"
        }
      ]
    }
  ],
  "count": 2,
  "has_more": false,
  "subject_id": 400602,
  "total": 6
}
```

### List subject staff

List the people and companies who made a subject, each with their job on it in English and Chinese, such as director, original creator or animation studio.

**Inputs**

- Subject (`subject`, text, required): The anime, book, album, game or show: pick one airing this season, or give any subject's Bangumi id or the address of its page, e.g. https://bgm.tv/subject/400602.
- Job contains (`role`, text): Only credits whose job contains this text, in English or Chinese, e.g. director or 导演. Leave blank for every job.
- Most results (`limit`, number): The most rows to list, from 1 to 1000. Defaults to 100. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many staff credits are listed.
- `has_more` (true/false): True when more staff credits match than are listed.
- `role` (text): The job the list was filtered to, or null for every job.
- `staff` (list): The staff credits, in Bangumi's order.
- `subject_id` (number): The subject whose staff these are.
- `total` (number): How many staff credits match in all.

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "role": "director",
  "staff": [
    {
      "careers": [
        "Producer"
      ],
      "episodes": null,
      "image_url": "https://lain.bgm.tv/pic/crt/l/e5/65/35947_prsn_r7GZh.jpg",
      "original_name": "\u5ca9\u6fa4\u4ea8",
      "person_id": 35947,
      "person_type": "individual",
      "role": "Action Director",
      "role_chinese": "\u52a8\u4f5c\u5bfc\u6f14",
      "url": "https://bgm.tv/person/35947"
    },
    {
      "careers": [
        "Producer"
      ],
      "episodes": null,
      "image_url": null,
      "original_name": "\u6c60\u7530\u8cb4\u535a",
      "person_id": 71968,
      "person_type": "individual",
      "role": "Music Director",
      "role_chinese": "\u97f3\u4e50\u76d1\u7763",
      "url": "https://bgm.tv/person/71968"
    }
  ],
  "subject_id": 400602,
  "total": 9
}
```

### Search characters

Find characters on Bangumi by name, in any language Bangumi lists it in, each with their original and Chinese names, other names and description. Returns a page of up to 20.

**Inputs**

- Name (`keyword`, text, required): The character's name or part of it, e.g. Frieren.
- Characters per page (`page_size`, number): How many characters to return, from 1 to 20. Defaults to 10. From 1 to 20. Default: `10`.
- Page (`page`, number): Which page to return, from 1. Only the first 1,000 results of a search can be paged through. From 1 to 1000. Default: `1`.

**Outputs**

- `characters` (list): The characters on this page.
- `count` (number): How many characters are on this page.
- `has_more` (true/false): True when there is another page.
- `keyword` (text): The name searched for.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `total` (number): How many characters match in all.

**Example output**

```json
{
  "characters": [
    {
      "aliases": [
        "Frieren",
        "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3"
      ],
      "birth_day": null,
      "birth_month": null,
      "birth_year": null,
      "blood_type": null,
      "character_id": 86246,
      "character_type": "character",
      "chinese_name": "\u8299\u8389\u83b2",
      "collected_count": 1045,
      "comment_count": 175,
      "gender": "female",
      "image_url": "https://lain.bgm.tv/pic/crt/l/b5/b6/86246_crt_L0Zmt.jpg",
      "infobox": [
        {
          "label": "\u7b80\u4f53\u4e2d\u6587\u540d",
          "value": "\u8299\u8389\u83b2"
        },
        {
          "label": "\u522b\u540d",
          "value": "\u82f1\u6587\u540d: Frieren, \u6635\u79f0: \u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3"
        },
        {
          "label": "\u6027\u522b",
          "value": "\u5973"
        },
        {
          "label": "\u5f15\u7528\u6765\u6e90",
          "value": "https://frieren-anime.jp/character/chara_group1/1-1/"
        }
      ],
      "original_name": "\u30d5\u30ea\u30fc\u30ec\u30f3",
      "summary": "\u5343\u5e74\u4ee5\u4e0a\u751f\u304d\u308b\u30a8\u30eb\u30d5\u3067\u3001\u52c7\u8005\u30d1\u30fc\u30c6\u30a3\u30fc\u3068\u3057\u3066\u9b54\u738b\u3092\u5012\u3057\u305f\u9b54\u6cd5\u4f7f\u3044\u3002\u9b54\u6cd5\u3067\u3042\u308c\u3070\u3069\u3093\u306a\u3082\u306e\u3067\u3082\u8208\u5473\u3092\u6301\u3064\u9b54\u6cd5\u30aa\u30bf\u30af\u3002\u6027\u683c\u306f\u305a\u307c\u3089\u3067\u30c9\u30e9\u30a4\u3002\u4ef2\u9593\u305f\u3061\u3068\u306e\u65c5\u3092\u7d4c\u3066\u3001\u77e5\u3089\u305a\u77e5\u3089\u305a\u306e\u3046\u3061\u306b\u305d\u306e\u5fc3\u306b\u3082\u5909\u5316\u304c\u73fe\u308c\u308b\u3002",
      "url": "https://bgm.tv/character/86246"
    },
    {
      "aliases": [],
      "birth_day": null,
      "birth_month": null,
      "birth_year": null,
      "blood_type": null,
      "character_id": 92249,
      "character_type": "character",
      "chinese_name": null,
      "collected_count": 0,
      "comment_count": 0,
      "gender": null,
      "image_url": "https://lain.bgm.tv/pic/crt/l/b0/5a/92249_crt_yZZZN.jpg",
      "infobox": [
        {
          "label": "\u6027\u522b",
          "value": "\u2642"
        }
      ],
      "original_name": "\u30d5\u30ea\u30fc",
      "summary": "\u30b7\u30b7\u7d44\u306e\u7d44\u54e1\u306e\u30a4\u30f3\u30c9\u30e9\u30a4\u30aa\u30f3\u3067\u3001\u9854\u306b\u5f15\u3063\u304b\u304d\u50b7\u304c\u3042\u308b\u3002\u8840\u306e\u6c17\u304c\u591a\u304f\u3001\u6297\u4e89\u306a\u3069\u306e\u6226\u95d8\u6642\u306b\u306f\u5148\u9663\u5207\u3063\u3066\u4e57\u308a\u8fbc\u3093\u3067\u3044\u304f\u51f6\u66b4\u306a\u6027\u683c\u3060\u304c\u3001\u304a\u3061\u3083\u3089\u3051\u305f\u4e00\u9762\u3082\u6301\u3064\u3002\u5b9f\u306f\u8eab\u4f53\u306b\u300e\u732b\u90aa\u7f85\u6b7b\u300f\u3068\u66f8\u304b\u308c\u305f\u523a\u9752\u3092\u5165\u308c\u3066\u3044\u308b\u3089\u3057\u3044\u3002\u30a4\u30d6\u30ad\u3068\u306f\u9055\u3044\u3001\u65b0\u3057\u3044\u7d44\u9577\u306e\u3053\u3068\u3092\u8a8d\u3081\u308b\u3053\u3068\u304c\u3067\u304d\u305a\u306b\u3044\u308b\u3002",
      "url": "https://bgm.tv/character/92249"
    }
  ],
  "count": 2,
  "has_more": true,
  "keyword": "\u30d5\u30ea\u30fc\u30ec\u30f3",
  "next_page": 2,
  "page": 1,
  "page_size": 10,
  "total": 44
}
```

### Search people

Find people and companies on Bangumi by name, such as voice actors, directors, manga artists, musicians or studios, optionally only those with some careers. Returns a page of up to 20.

**Inputs**

- Name (`keyword`, text, required): The name or part of it, e.g. Miyazaki or 宮崎駿.
- Careers (`careers`, list): Only people with all these careers. Leave blank for anyone. One or more of: `seiyu` (Voice actor), `producer`, `mangaka` (Manga artist), `artist` (Musician), `writer`, `illustrator`, `actor`.
- People per page (`page_size`, number): How many people to return, from 1 to 20. Defaults to 10. From 1 to 20. Default: `10`.
- Page (`page`, number): Which page to return, from 1. Only the first 1,000 results of a search can be paged through. From 1 to 1000. Default: `1`.

**Outputs**

- `count` (number): How many people are on this page.
- `has_more` (true/false): True when there is another page.
- `keyword` (text): The name searched for.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `persons` (list): The people on this page.
- `total` (number): How many people match in all.

**Example output**

```json
{
  "count": 2,
  "has_more": false,
  "keyword": "\u7a2e\ufa11\u6566\u7f8e",
  "next_page": null,
  "page": 1,
  "page_size": 10,
  "persons": [
    {
      "aliases": [
        "\u7a2e\u5d0e\u6566\u7f8e",
        "\u7a2e\ufa11 \u6566\u7f8e",
        "\u305f\u306d\u3056\u304d \u3042\u3064\u307f"
      ],
      "birth_day": 27,
      "birth_month": 9,
      "birth_year": 1990,
      "blood_type": null,
      "careers": [
        "Musician",
        "Voice actor"
      ],
      "chinese_name": "\u79cd\u5d0e\u6566\u7f8e",
      "collected_count": 2965,
      "comment_count": 565,
      "gender": "female",
      "image_url": "https://lain.bgm.tv/pic/crt/l/7a/a7/7575_prsn_8TJlL.jpg?r=1671262190",
      "infobox": [
        {
          "label": "\u7b80\u4f53\u4e2d\u6587\u540d",
          "value": "\u79cd\u5d0e\u6566\u7f8e"
        },
        {
          "label": "\u522b\u540d",
          "value": "\u7a2e\u5d0e\u6566\u7f8e, \u65e5\u6587\u540d: \u7a2e\ufa11 \u6566\u7f8e, \u7eaf\u5047\u540d: \u305f\u306d\u3056\u304d \u3042\u3064\u307f, \u7f57\u9a6c\u5b57: Tanezaki Atsumi, \u6635\u79f0: \u305f\u306d\u3061\u3083\u3093\u30fb\u3042\u3063\u3061\u3083\u3093\uff08\u963f\u9171\uff0c\u53d6\u81eaAtsumi\u7684A\uff09\u30fb\u30b7\u30fc\u30c9\u3055\u3093\u30fb\u305f\u306d\u30d1\u30a4, \u4e2d\u6587\u6635\u79f0: \u534e\u54e5\u3001\u534e\u7237, \u5176\u4ed6\u540d\u4e49: \u3042\u3044\u3053 = \u6850\u8c37\u83ef = \u9ed2\u54b2\u307e\u3064\u308a = \u3068\u307e\u3068\u3042\u3044\u3053 = \u6ca2\u6fa4\u7802\u7fbd = \u6885\u672c\u8a69\u7dd2"
        },
        {
          "label": "\u6027\u522b",
          "value": "\u5973"
        },
        {
          "label": "\u751f\u65e5",
          "value": "1990\u5e749\u670827\u65e5"
        }
      ],
      "original_name": "\u7a2e\ufa11\u6566\u7f8e",
      "person_id": 7575,
      "person_type": "individual",
      "summary": "\u7a2e\ufa11 \u6566\u7f8e\uff08\u305f\u306d\u3056\u304d \u3042\u3064\u307f\u30019\u670827\u65e5 - \uff09\u306f\u65e5\u672c\u306e\u5973\u6027\u58f0\u512a\u3002\u30c8\u30ea\u30c8\u30ea\u30aa\u30d5\u30a3\u30b9\u6240\u5c5e\u3002\u5927\u5206\u770c\u51fa\u8eab\u3002",
      "url": "https://bgm.tv/person/7575"
    },
    {
      "aliases": [
        "\u7a2e\u7530 \u68a8\u6c99",
        "\u305f\u306d\u3060 \u308a\u3055",
        "Taneda Risa"
      ],
      "birth_day": 12,
      "birth_month": 7,
      "birth_year": 1988,
      "blood_type": "A",
      "careers": [
        "Voice actor"
      ],
      "chinese_name": "\u79cd\u7530\u68a8\u6c99",
      "collected_count": 1166,
      "comment_count": 289,
      "gender": "female",
      "image_url": "https://lain.bgm.tv/pic/crt/l/07/06/8138_prsn_azY4i.jpg?r=1581916191",
      "infobox": [
        {
          "label": "\u7b80\u4f53\u4e2d\u6587\u540d",
          "value": "\u79cd\u7530\u68a8\u6c99"
        },
        {
          "label": "\u522b\u540d",
          "value": "\u65e5\u6587\u540d: \u7a2e\u7530 \u68a8\u6c99, \u7eaf\u5047\u540d: \u305f\u306d\u3060 \u308a\u3055, \u7f57\u9a6c\u5b57: Taneda Risa, \u6635\u79f0: seed\u541b\u3001\u305f\u306d\u3061\u3083\u3093"
        },
        {
          "label": "\u6027\u522b",
          "value": "\u5973"
        },
        {
          "label": "\u751f\u65e5",
          "value": "1988-07-12"
        }
      ],
      "original_name": "\u7a2e\u7530\u68a8\u6c99",
      "person_id": 8138,
      "person_type": "individual",
      "summary": "\u521d\u4e2d\u4e00\u5e74\u7ea7\u7684\u65f6\u5019\u6253\u7b97\u6210\u4e3a\u4e00\u540d\u58f0\u4f18\u662f\u56e0\u4e3a\u300a\u54c8\u5229\u00b7\u6ce2\u7279\u300b\u7684\u5f71\u54cd\uff0c\u60f3\u505a\u6709\u5173\u7cfb\u7684\u5de5\u4f5c\u3002\u4f46\u4e2d\u5b66\u3001\u9ad8\u4e2d\u7684\u65f6\u5019\u7981\u6b62\u4e00\u5207\u827a\u80fd\u6d3b\u52a8\uff0c\u901a\u8fc7\u81ea\u5b66\u5b66\u4e60\u4e86\u8868\u6f14\u7684\u7ecf\u9a8c\u6280\u672f\u3002",
      "url": "https://bgm.tv/person/8138"
    }
  ],
  "total": 9
}
```

### Search subjects

Find anime, books, music, games and live-action shows on Bangumi by name and filters: kind, tags, air date, score, rank and how many members rated them. Each comes with its original and Chinese names, air date, score and rank. Returns a page of up to 20.

**Inputs**

- Search text (`keyword`, text): Words in the name, in any language Bangumi lists it in, e.g. Frieren or 葬送のフリーレン. Leave blank to find by filters alone.
- Kinds (`subject_types`, list): Only subjects of these kinds. Leave blank for every kind. One or more of: `anime`, `book`, `music`, `game`, `real` (Live action).
- Tags (`tags`, list): Only subjects carrying all these tags, as members write them, mostly in Chinese, e.g. 奇幻 (fantasy) or 原创 (original).
- Aired on or after (`air_date_from`, date): Only subjects first aired or released on or after this day.
- Aired on or before (`air_date_to`, date): Only subjects first aired or released on or before this day.
- Lowest score (`min_score`, number): Only subjects members rate at least this, out of 10. From 0 to 10.
- Highest score (`max_score`, number): Only subjects members rate at most this, out of 10. From 0 to 10.
- Rated by at least (`min_rating_count`, number): Only subjects at least this many members have rated, so a score means something, e.g. 1000. At least 0.
- Ranked in the top (`top_rank`, number): Only subjects ranked this high or higher among their kind, e.g. 100 for the top 100. At least 1.
- Order (`sort`, text): Which subjects come first. Highest ranked first lists ranked subjects only. One of: `match` (Best match first), `heat` (Most collected first), `rank` (Highest ranked first), `score` (Highest rated first). Default: `match`.
- Subjects per page (`page_size`, number): How many subjects to return, from 1 to 20. Defaults to 10. From 1 to 20. Default: `10`.
- Page (`page`, number): Which page to return, from 1. Only the first 1,000 results of a search can be paged through. From 1 to 1000. Default: `1`.

**Outputs**

- `count` (number): How many subjects are on this page.
- `has_more` (true/false): True when there is another page.
- `keyword` (text): The words searched for, or null for a search by filters.
- `next_page` (number): The next page's number, or null on the last.
- `page` (number): This page's number, from 1.
- `page_size` (number): The most results a page holds.
- `sort` (text): The order the results are in.
- `subjects` (list): The subjects on this page.
- `total` (number): How many subjects match in all; Bangumi stops counting at 1,000.

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "keyword": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3",
  "next_page": null,
  "page": 1,
  "page_size": 5,
  "sort": "match",
  "subjects": [
    {
      "air_date": "2023-09-29",
      "chinese_name": "\u846c\u9001\u7684\u8299\u8389\u83b2",
      "episodes": 28,
      "image_url": "https://lain.bgm.tv/pic/cover/l/13/c5/400602_ZI8Y9.jpg",
      "original_name": "\u846c\u9001\u306e\u30d5\u30ea\u30fc\u30ec\u30f3",
      "platform": "TV",
      "rank": 43,
      "rating_count": 36825,
      "score": 8.5,
      "subject_id": 400602,
      "subject_type": "anime",
      "summary": "\u9b54\u6cd5\u4f7f\u8299\u8389\u83b2\u548c\u52c7\u8005\u8f9b\u7f8e\u5c14\u7b49\u4eba\u4e00\u8d77\uff0c\u5386\u7ecf\u5341\u5e74\u7684\u5192\u9669\u4e4b\u540e\u51fb\u8d25\u4e86\u9b54\u738b\uff0c\u4e3a\u4e16\u754c\u5e26\u6765\u4e86\u548c\u5e73\u3002",
      "tags": [
        "\u6cbb\u6108",
        "\u516c\u8def\u7247",
        "\u5947\u5e7b",
        "MADHouse",
        "\u6f2b\u753b\u6539"
      ],
      "url": "https://bgm.tv/subject/400602",
      "volumes": null
    }
  ],
  "total": 1
}
```
