嗶哩嗶哩(bilibili)API:影片關鍵字搜尋與留言

依 2026-11-21 規格整理

快速解答

嗶哩嗶哩(bilibili)API 有兩種非同步任務。POST /bilibili/search/task 以關鍵字與發布日期區間(預設最近 7 天)搜尋 B 站影片,每頁 20 支、最多 50 頁,一次查詢約可取得 1,000 支影片。POST /bilibili/pushs/task 蒐集單支影片的留言與留言底下的回覆。兩者都以 GET 輪詢,DONE 時同一個回應帶回資料,由新到舊排列。每支影片有網址、標題、簡介、上傳者、發布時間、觀看數、按讚數、留言數與封面圖。留言蒐集有上限:一個任務最多蒐集該影片最熱門的 3 則第一層留言,以及每則底下的前 20 則回覆。資料以網路爬蟲蒐集嗶哩嗶哩公開發布的內容。

依功能分類的 API 頁面

可取得的資料

欄位依 2026-11-21 規格。任務還沒 DONE 時,輪詢只回傳任務物件;DONE 後同一個回應帶回 task、total_count、data、page 與 pageSize。資料列可能帶有表列以外的欄位,meta_keywords、location、icon_url 等描述欄位可能是空值。

資料欄位端點
關鍵字搜尋的影片 id, url, title, content, tm, datetime, tm_crawler, tm_update, author, author_id, type, ctype, source, sentiment, view_count, like_count, comment_count, metadata_img GET /bilibili/search/task/{task_id}
搜尋任務的狀態與計數 task: id, keyword, status, start_date, end_date, max_pages, created_at, total, completed, pages_crawled, partial, timed_out, failed_pages, failed_articles, failed_ranges, num_results GET /bilibili/search/task/{task_id}
影片留言與回覆 id, post_id, author_id, author, push_type, region, content, tm, tm_crawler, sentiment GET /bilibili/pushs/task/{task_id}
留言任務的狀態與計數 task: id, post_url, status, crawl_second_layer, created_at, total, completed, pages_crawled, reported_total, partial, timed_out, failed_pages, failed_batches, bvid GET /bilibili/pushs/task/{task_id}

端點一覽

Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。主要參數中標示 * 者為必填。

方法路徑說明主要參數
POST /bilibili/search/task 建立影片關鍵字搜尋任務,可指定日期區間與最多爬取頁數。 keyword* end_date max_pages rerun start_date
GET /bilibili/search/task/{task_id} 輪詢搜尋任務;DONE 時回傳影片與 total_count,每頁最多 100 筆。 task_id* page pageSize
POST /bilibili/pushs/task 以 /video/BV... 網址建立留言任務,可一併蒐集回覆。 post_url* crawl_second_layer max_pages rerun
GET /bilibili/pushs/task/{task_id} 輪詢留言任務;DONE 時回傳留言,每頁最多 1000 筆。 task_id* page pageSize

取資料流程

  1. POST /bilibili/search/task 帶 keyword(1 到 100 字),可選 start_date、end_date(YYYY-MM-DD,UTC+8,含當日;預設最近 7 天)與 max_pages(0 到 50;0 或省略為 50,每頁 20 支影片)。回應是帶任務 id、狀態為 INIT 的任務物件。
  2. GET /bilibili/search/task/{task_id} 輪詢。每 3 到 5 秒輪詢一次,並設定整體的等待期限。狀態有 INIT、RUNNING、DONE、PARTIAL、TIMED_OUT(超過 600 秒沒有進度)與 FAILED。只有 DONE 的回應帶資料,其他狀態只回傳任務物件;DONE 之前讀 status,DONE 之後讀 task.status。status 為 DONE 且 partial、timed_out 都是 false,才算完全成功。
  3. DONE 後以 page、pageSize(每頁最多 100 筆)讀取 data 裡的影片。num_results 是 B 站顯示的搜尋筆數,屬於估計值,可能多於實際取得的數量。
  4. 要看某支影片的留言時,以 /video/BV... 網址 POST /bilibili/pushs/task;crawl_second_layer(預設 true)會一併蒐集留言底下的回覆。再以 GET /bilibili/pushs/task/{task_id} 輪詢,pageSize 最多 1000;reported_total 是 B 站顯示的留言數。

curl 範例

建立關鍵字搜尋任務

curl -X POST https://api.infominer.io/api/v2/bilibili/search/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "露营装备", "start_date": "2026-06-01", "end_date": "2026-06-07", "max_pages": 3}'

以任務 ID 輪詢

curl "https://api.infominer.io/api/v2/bilibili/search/task/$TASK_ID?page=1&pageSize=100" \
  -H "auth-header: YOUR_API_KEY"

以影片網址建立留言任務

curl -X POST https://api.infominer.io/api/v2/bilibili/pushs/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://www.bilibili.com/video/BV1000000001/", "crawl_second_layer": true}'

示意 JSON 樣本

以下為人工撰寫的示意資料:帳號為 sample_user_n,ID 為明顯的假值,不是真實貼文。

建立任務的回應(示意資料)

{
  "id": "00000000-0000-4000-8000-000000000001",
  "keyword": "露营装备",
  "status": "INIT",
  "start_date": "2026-06-01",
  "end_date": "2026-06-07",
  "max_pages": 3,
  "created_at": 1780880400,
  "total": 0,
  "completed": 0,
  "pages_crawled": 0,
  "num_results": null,
  "timed_out": false,
  "partial": false,
  "failed_pages": 0,
  "failed_articles": 0,
  "failed_ranges": 0
}

任務完成後的輪詢回應(示意資料)

{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "keyword": "露营装备",
    "status": "DONE",
    "start_date": "2026-06-01",
    "end_date": "2026-06-07",
    "max_pages": 3,
    "created_at": 1780880400,
    "total": 2,
    "completed": 2,
    "pages_crawled": 1,
    "num_results": 2,
    "timed_out": false,
    "partial": false,
    "failed_pages": 0,
    "failed_articles": 0,
    "failed_ranges": 0
  },
  "total_count": 2,
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "url": "https://www.bilibili.com/video/BV1000000001/",
      "title": "新手露营装备清单,第一次出门带这些就够了",
      "content": "新手露营装备清单,第一次出门带这些就够了",
      "tm": 1780666200,
      "datetime": "2026-06-05 21:30:00",
      "tm_crawler": 1780880405,
      "tm_update": 1780880405,
      "author": "sample_user_1",
      "author_id": "0000000001",
      "type": [
        "sample_user_1"
      ],
      "ctype": [
        "sample_user_1"
      ],
      "source": "bilibili",
      "sentiment": "Positive",
      "view_count": 5230,
      "like_count": 318,
      "comment_count": 46,
      "metadata_img": [
        "https://i0.hdslb.com/bfs/archive/sample_cover_1.jpg"
      ]
    },
    {
      "id": "00000000-0000-4000-8000-000000000002",
      "url": "https://www.bilibili.com/video/BV1000000002/",
      "title": "三款轻量帐篷实测:下雨天的表现差别很大",
      "content": "露营装备里最难选的是帐篷,同一个周末在山上搭了三款,记录了防水和通风的情况",
      "tm": 1780452000,
      "datetime": "2026-06-03 10:00:00",
      "tm_crawler": 1780880409,
      "tm_update": 1780880409,
      "author": "sample_user_2",
      "author_id": "0000000002",
      "type": [
        "sample_user_2"
      ],
      "ctype": [
        "sample_user_2"
      ],
      "source": "bilibili",
      "sentiment": "Neutral",
      "view_count": 1870,
      "like_count": 95,
      "comment_count": 21,
      "metadata_img": [
        "https://i0.hdslb.com/bfs/archive/sample_cover_2.jpg"
      ]
    }
  ],
  "page": 1,
  "pageSize": 100
}

貼文與留言如何關聯

留言任務以影片網址建立。每筆留言的 post_id 是影片的文件 ID,與搜尋結果中同一支影片的 id 相同。push_type 為 comment 是第一層留言,reply 是留言底下的回覆。留言任務物件帶有影片的 BV 號(bvid)。data 包含這支影片所有已蒐集的留言(含先前任務蒐集的),所以 total_count 與 task.completed 不一定相同。

歷史範圍與限制

  • 一次搜尋最多 50 頁,約 1,000 支影片。熱門關鍵字請縮小日期區間,或拆成多個任務。
  • 一個留言任務最多蒐集影片最熱門的 3 則第一層留言,以及每則底下的前 20 則回覆,因此 completed 遠低於 reported_total 是正常的,不代表任務失敗。
  • B 站留言的 region(IP 所在地)一律為空值。
  • 影片的 share_count、reply_count、dislike_count 一律為 0。is_video 目前都是 false,但每筆資料都是影片。
  • post_url 必須是 bilibili.com 的 /video/BV... 網址;不接受 av 號網址與 b23.tv 短網址,請先展開。
  • data 是對該日期區間內所有已蒐集資料的關鍵字比對,包含先前任務的結果,所以 total_count 可能大於 task.completed;這個任務實際蒐集的筆數是 task.completed。按讚數、留言數與觀看數是蒐集當下的數值。已蒐集的數值會在之後不定時更新。
  • 短時間建立大量任務,可能讓任務排隊,或在 B 站拒絕請求時以 PARTIAL、FAILED 結束;搜尋途中 B 站有時會暫時不提供後面的頁面,此時任務會以 PARTIAL 結束。搜尋可回溯的期間依專案範圍確認。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。

交付格式

API 回應為 JSON。搜尋與留言任務在 DONE 後由輪詢回應帶回資料,以 page、pageSize 分頁(搜尋每頁最多 100 筆,留言最多 1000 筆)。批次檔案或其他交付方式,依專案範圍確認。

申請試用

填寫下方申請表單時,請註明嗶哩嗶哩,並說明要追的關鍵字或影片、是否需要留言,以及預估資料量。我們會確認範圍,並回覆試用與 API 金鑰的安排。

填寫表單申請試用,專人確認範圍後回覆試用與介接安排。

填寫申請表單

常見問題

可以拿到 B 站影片的全部留言嗎?
不行。一個留言任務最多蒐集影片最熱門的 3 則第一層留言,以及每則底下的前 20 則回覆。比對 task.completed 與 reported_total,可以知道蒐集到的比例。
一次 B 站搜尋可以拿到幾支影片?
每頁 20 支、最多 50 頁,約 1,000 支影片。需要更多時,請把日期區間拆成多個任務。
可以用 b23.tv 短網址或 av 號網址嗎?
不行。請先展開成 https://www.bilibili.com/video/BV.../ 的網址;這個網址帶有追蹤參數沒有關係。
HTTP 錯誤碼代表什麼?
HTTP 400 是請求格式錯誤(例如缺少 keyword,或 start_date 晚於 end_date);401 是金鑰缺漏或無效;403 是金鑰沒有這個平台的存取權;404 是任務 ID 不存在;422 是爬蟲服務不接受這個請求(例如網址不是該平台,或 max_pages 超出範圍),任務不會建立。500 與 502 請間隔一段時間重試,503 請在 Retry-After 之後重試。
這是 B 站爬蟲 API 嗎?資料是怎麼蒐集的?
是。資料由大數軟體以網路爬蟲蒐集嗶哩嗶哩公開發布的內容,再透過 API 以 JSON 回傳,您不需要自行維護爬蟲。大數軟體與嗶哩嗶哩沒有隸屬或合作關係,這也不是嗶哩嗶哩自己提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。