公開 API

Bangumi 搜尋

GET /api/bgm/search —— 把番劇名對應為 bgmId。結果按比對層級排序,同級按熱度排序。拼寫容錯來自相似度;年份沒有單獨的規則,與其他詞一樣比對。純數字 q 仍依 Bangumi ID 查詢。

GET
/api/bgm/search

查詢參數

q*string

中、英、日或罗马音关键词,也可传纯数字 Bangumi ID;去除首尾空白后 1–100 字符,禁止控制字符。

長度1 <= length <= 100
limit?integer

条数,默认 5,上限 25

範圍1 <= value <= 25
預設5

回應主體

搜索结果

application/json
  1. response
ok*true
值於true
data*array<>
範例請求
curl -X GET 'https://anibt.net/api/bgm/search?q=string'
{  "ok": true,  "data": [    {      "bgmId": 543360,      "name": "上伊那ぼたん、酔へる姿は百合の花",      "nameCn": "上伊那牡丹,酒醉身姿似百合花般",      "date": null,      "image": "https://r2.anibt.net/anime_covers/nh73r0ernee7s0afv9s82f763983gcz7/cbbbd63dd8c9cff7da4b665651347ee5eae20c98567ea5572abbeccf40f8d87a/v4/w240.webp",      "rating": 7.1,      "totalEpisodes": 25,      "url": "https://bgm.tv/subject/543360",      "premiere": null,      "seasonYear": null,      "season": null    }  ]}