Bangumi

App · 20 actions

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.

Actions

ActionWhat it does
Browse subjectsList one kind of subject on Bangumi, such as TV anime, comics or films, optionally from one year and month, newest or highest ranked first.
Get airing calendarSee which anime air on each day of the week this season, or on one day, with their names, first air date, score and rank.
Get characterGet one character from Bangumi: their original and Chinese names, other names, gender, birthday, description and fact sheet.
Get indexGet a Bangumi index, a list of subjects a member curates: its title, description, author, how many subjects it holds and when it last changed.
Get memberGet a Bangumi member's public profile: their nickname, signature, standing and profile picture.
Get member's collection entryCheck whether a subject is in a Bangumi member's public collection and, if it is, its status, their rating, review, tags and progress.
Get personGet one person or company from Bangumi: their original and Chinese names, other names, careers, birthday, biography and fact sheet.
Get subjectGet 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.
List character subjectsList the anime, books, games and other subjects a character appears in, with their part in each.
List episodesList a subject's episodes in order, each with its number, original and Chinese title, the day it aired, its length and description.
List index subjectsList the subjects in a Bangumi index, in the order they were added, each with the author's note on it.
List member's collectionList 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.
List person's rolesList the characters a voice actor or actor played, each with the subject they played them in and their part in it.
List person's workList the subjects a person or company worked on, with their job on each, optionally only some kinds or jobs.
List related subjectsList 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.
List subject charactersList the characters in a subject, main characters first, each with their part (main, supporting or guest) and who voices or plays them.
List subject staffList 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.
Search charactersFind characters on Bangumi by name, in any language Bangumi lists it in, each with their original and Chinese names, other names and description.
Search peopleFind people and companies on Bangumi by name, such as voice actors, directors, manga artists, musicians or studios, optionally only those with some careers.
Search subjectsFind 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.

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

Kindsubject_typetextRequired
The kind of subject to list.One of: anime, book, music, game, real (Live action).
Categorycategorytext
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.
Yearyearnumber
Only subjects first aired or released in this year.From 1900 to 2100.
Monthmonthnumber
Only subjects first aired or released in this month of the year, from 1 to 12. Needs a year.From 1 to 12.
Ordersorttext
Which subjects come first. Highest ranked first lists ranked subjects only.One of: date (Newest first), rank (Highest ranked first). Default: date.
Subjects per pagepage_sizenumber
How many subjects to return, from 1 to 50. Defaults to 30.From 1 to 50. Default: 30.
Pagepagenumber
Which page to return, from 1.From 1 to 10000. Default: 1.

Outputs

categorytext
The category browsed, or null for every category.
countnumber
How many subjects are on this page.
has_moretrue/false
True when there is another page.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
sorttext
The order the results are in.
subject_typetext
The kind of subject browsed.
subjectslist
The subjects on this page.
totalnumber
How many subjects match in all.
Example output
{
  "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

Dayweekdaytext
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

countnumber
How many subjects air on the days listed.
dayslist
Each day of the week, Monday first, with what airs on it.
weekdaytext
The day asked for, or null for the whole week.
Example output
{
  "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

CharactercharactertextRequired
The character's Bangumi id or the address of their page, e.g. https://bgm.tv/character/86246.

Outputs

aliaseslist
Its other names: English, romanized, earlier or fan names.
birth_daynumber
The day of the month they were born, when known.
birth_monthnumber
The month they were born (1 to 12), when known.
birth_yearnumber
The year they were born, when known.
blood_typetext
Their blood type (A, B, AB or O), when known.
character_idnumber
Bangumi's number for the character, e.g. 86246.
character_typetext
What it is: character, mechanic (a robot or vehicle), ship or organization.
chinese_nametext
The character's Chinese name, when Bangumi has one.
collected_countnumber
How many members have added the character to favourites.
comment_countnumber
How many comments members have left on the character.
gendertext
male or female, when known.
image_urltext
The character's picture.
infoboxlist
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_nametext
The character's name in its original language.
summarytext
Bangumi's description of the character.
urltext
The character's page on bgm.tv.
Example output
{
  "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

IndexindextextRequired
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_countnumber
How many members have added it to favourites.
comment_countnumber
How many comments members have left on it.
created_attext
When it was made (ISO 8601).
creator_nicknametext
The name its author shows.
creator_usernametext
Its author's username.
descriptiontext
What the index is about, in its author's words.
index_idnumber
Bangumi's number for the index, e.g. 1.
subject_countnumber
How many subjects it holds.
titletext
The index's title.
updated_attext
When it last changed (ISO 8601).
urltext
The index's page on bgm.tv.
Example output
{
  "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

UsernameusernametextRequired
The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.

Outputs

avatar_urltext
Their profile picture.
nicknametext
The name they show.
signaturetext
The short line on their profile.
urltext
Their page on bgm.tv.
user_grouptext
Their standing on Bangumi, e.g. Member or Wiki editor.
user_idnumber
Bangumi's number for the member.
usernametext
Their username, as in their page's address.
Example output
{
  "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

UsernameusernametextRequired
The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.
SubjectsubjecttextRequired
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

collectedtrue/false
True when the subject is in their public collection. False when it isn't, or they keep it private.
commenttext
Their short review, if any.
episodes_donenumber
How many episodes they have marked watched.
ratingnumber
Their rating, 1 to 10, or null when unrated.
statustext
Where it is in their collection: wish, done, doing, on_hold or dropped.
status_labeltext
The status in words, e.g. Wish list or In progress.
subjectobject
The subject, as Bangumi lists it, or null when not collected.
subject_idnumber
The subject collected.
tagslist
The tags they gave it.
updated_attext
When they last changed it (ISO 8601).
usernametext
Whose collection was checked.
volumes_donenumber
How many volumes they have marked read.
Example output
{
  "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

PersonpersontextRequired
The person's or company's Bangumi id or the address of their page, e.g. https://bgm.tv/person/7575.

Outputs

aliaseslist
Its other names: English, romanized, earlier or fan names.
birth_daynumber
The day of the month they were born, when known.
birth_monthnumber
The month they were born (1 to 12), when known.
birth_yearnumber
The year they were born, when known.
blood_typetext
Their blood type (A, B, AB or O), when known.
careerslist
What they do: Voice actor, Producer, Manga artist, Musician, Writer, Illustrator or Actor.
chinese_nametext
Their Chinese name, when Bangumi has one.
collected_countnumber
How many members have added them to favourites.
comment_countnumber
How many comments members have left on them.
gendertext
male or female, when known.
image_urltext
Their photo or picture.
infoboxlist
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_nametext
Their name in its original language.
person_idnumber
Bangumi's number for the person, e.g. 7575.
person_typetext
Whether it is an individual, a company or a group.
summarytext
Bangumi's biography of them.
urltext
The person's page on bgm.tv.
Example output
{
  "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

SubjectsubjecttextRequired
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_datetext
When it first aired or was released (YYYY-MM-DD), when known.
aliaseslist
Its other names: English, romanized, earlier or fan names.
chinese_nametext
Its Chinese name, or null when Bangumi has none.
collection_countsobject
How many members have it in their collection, by status.
episodesnumber
How many episodes it has, when known.
image_urltext
Its cover or poster image.
infoboxlist
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_seriestrue/false
True for a book that is a series, not one volume.
meta_tagslist
Bangumi's own tags for it, e.g. TV, 日本 (Japan), 漫画改 (manga adaptation).
nsfwtrue/false
True when Bangumi marks it as adult content.
original_nametext
Its name in its original language, often Japanese.
platformtext
Its format as Bangumi files it, e.g. TV, OVA or WEB for anime, or 漫画 (comic) and 小说 (novel) for books.
ranknumber
Its place in Bangumi's ranking of its kind (1 is best), or null when unranked.
rating_countnumber
How many members have rated it, when given.
scorenumber
Its average rating from members, out of 10, when rated.
subject_idnumber
Bangumi's number for the subject, e.g. 400602.
subject_typetext
What kind of subject it is: anime, book, music, game or real (live-action TV and film).
summarytext
Bangumi's description of it, usually in Chinese.
tagslist
The tags members give it most, up to 10, often in Chinese.
total_episodesnumber
How many episodes Bangumi lists for it, specials included.
urltext
The subject's page on bgm.tv.
volumesnumber
How many volumes a book has, when known.
Example output
{
  "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

CharactercharactertextRequired
The character's Bangumi id or the address of their page, e.g. https://bgm.tv/character/86246.

Outputs

character_idnumber
The character whose subjects these are.
countnumber
How many subjects the character appears in.
subjectslist
The subjects the character appears in.
Example output
{
  "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

SubjectsubjecttextRequired
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.
Episodesepisode_typetext
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 pagepage_sizenumber
How many episodes to return, from 1 to 200. Defaults to 100.From 1 to 200. Default: 100.
Pagepagenumber
Which page to return, from 1.From 1 to 10000. Default: 1.

Outputs

countnumber
How many episodes are on this page.
episode_typetext
The kind of episodes listed, or all.
episodeslist
The episodes on this page.
has_moretrue/false
True when there is another page.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
subject_idnumber
The subject whose episodes these are.
totalnumber
How many episodes match in all.
Example output
{
  "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

IndexindextextRequired
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.
Kindsubject_typetext
Only subjects of this kind. Leave blank for every kind.One of: anime, book, music, game, real (Live action).
Subjects per pagepage_sizenumber
How many subjects to return, from 1 to 50. Defaults to 30.From 1 to 50. Default: 30.
Pagepagenumber
Which page to return, from 1.From 1 to 10000. Default: 1.

Outputs

countnumber
How many subjects are on this page.
has_moretrue/false
True when there is another page.
index_idnumber
The index these subjects are in.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
subject_typetext
The kind of subject listed, or null for every kind.
subjectslist
The subjects on this page.
totalnumber
How many subjects match in all.
Example output
{
  "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

UsernameusernametextRequired
The member's username, as in their profile's address, or the address itself, e.g. https://bgm.tv/user/sai.
Kindsubject_typetext
Only subjects of this kind. Leave blank for every kind.One of: anime, book, music, game, real (Live action).
Statuscollection_typetext
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 pagepage_sizenumber
How many entries to return, from 1 to 50. Defaults to 30.From 1 to 50. Default: 30.
Pagepagenumber
Which page to return, from 1.From 1 to 10000. Default: 1.

Outputs

collection_typetext
The status listed, or null for every status.
collectionslist
The collection entries on this page.
countnumber
How many collection entries are on this page.
has_moretrue/false
True when there is another page.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
subject_typetext
The kind of subject listed, or null for every kind.
totalnumber
How many collection entries match in all.
usernametext
Whose collection this is.
Example output
{
  "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

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

Outputs

characterslist
The roles, in Bangumi's order.
countnumber
How many roles are listed.
has_moretrue/false
True when more roles match than are listed.
person_idnumber
The person who voiced or played these characters.
totalnumber
How many roles match in all.
Example output
{
  "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

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

Outputs

countnumber
How many subjects are listed.
has_moretrue/false
True when more subjects match than are listed.
person_idnumber
The person whose work this is.
subjectslist
The subjects, in Bangumi's order.
totalnumber
How many subjects match in all.
Example output
{
  "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 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

SubjectsubjecttextRequired
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

countnumber
How many related subjects there are.
subject_idnumber
The subject the others are related to.
subjectslist
The related subjects.
Example output
{
  "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

SubjectsubjecttextRequired
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.
Partsroleslist
Only characters with these parts. Leave blank for all.One or more of: main, supporting, guest.
Most resultslimitnumber
The most rows to list, from 1 to 1000. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

characterslist
The characters, in Bangumi's order.
countnumber
How many characters are listed.
has_moretrue/false
True when more characters match than are listed.
subject_idnumber
The subject whose characters these are.
totalnumber
How many characters match in all.
Example output
{
  "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

SubjectsubjecttextRequired
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 containsroletext
Only credits whose job contains this text, in English or Chinese, e.g. director or 导演. Leave blank for every job.
Most resultslimitnumber
The most rows to list, from 1 to 1000. Defaults to 100.From 1 to 1000. Default: 100.

Outputs

countnumber
How many staff credits are listed.
has_moretrue/false
True when more staff credits match than are listed.
roletext
The job the list was filtered to, or null for every job.
stafflist
The staff credits, in Bangumi's order.
subject_idnumber
The subject whose staff these are.
totalnumber
How many staff credits match in all.
Example output
{
  "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

NamekeywordtextRequired
The character's name or part of it, e.g. Frieren.
Characters per pagepage_sizenumber
How many characters to return, from 1 to 20. Defaults to 10.From 1 to 20. Default: 10.
Pagepagenumber
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

characterslist
The characters on this page.
countnumber
How many characters are on this page.
has_moretrue/false
True when there is another page.
keywordtext
The name searched for.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
totalnumber
How many characters match in all.
Example output
{
  "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

NamekeywordtextRequired
The name or part of it, e.g. Miyazaki or 宮崎駿.
Careerscareerslist
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 pagepage_sizenumber
How many people to return, from 1 to 20. Defaults to 10.From 1 to 20. Default: 10.
Pagepagenumber
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

countnumber
How many people are on this page.
has_moretrue/false
True when there is another page.
keywordtext
The name searched for.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
personslist
The people on this page.
totalnumber
How many people match in all.
Example output
{
  "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 textkeywordtext
Words in the name, in any language Bangumi lists it in, e.g. Frieren or 葬送のフリーレン. Leave blank to find by filters alone.
Kindssubject_typeslist
Only subjects of these kinds. Leave blank for every kind.One or more of: anime, book, music, game, real (Live action).
Tagstagslist
Only subjects carrying all these tags, as members write them, mostly in Chinese, e.g. 奇幻 (fantasy) or 原创 (original).
Aired on or afterair_date_fromdate
Only subjects first aired or released on or after this day.
Aired on or beforeair_date_todate
Only subjects first aired or released on or before this day.
Lowest scoremin_scorenumber
Only subjects members rate at least this, out of 10.From 0 to 10.
Highest scoremax_scorenumber
Only subjects members rate at most this, out of 10.From 0 to 10.
Rated by at leastmin_rating_countnumber
Only subjects at least this many members have rated, so a score means something, e.g. 1000.At least 0.
Ranked in the toptop_ranknumber
Only subjects ranked this high or higher among their kind, e.g. 100 for the top 100.At least 1.
Ordersorttext
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 pagepage_sizenumber
How many subjects to return, from 1 to 20. Defaults to 10.From 1 to 20. Default: 10.
Pagepagenumber
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

countnumber
How many subjects are on this page.
has_moretrue/false
True when there is another page.
keywordtext
The words searched for, or null for a search by filters.
next_pagenumber
The next page's number, or null on the last.
pagenumber
This page's number, from 1.
page_sizenumber
The most results a page holds.
sorttext
The order the results are in.
subjectslist
The subjects on this page.
totalnumber
How many subjects match in all; Bangumi stops counting at 1,000.
Example output
{
  "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
}

On this page