嗶哩嗶哩(bilibili)影片關鍵字搜尋 API
依 2026-11-21 規格整理
快速解答
POST /bilibili/search/task 以關鍵字與發布日期區間(YYYY-MM-DD,UTC+8,含當日;預設最近 7 天)搜尋 B 站影片,由新到舊。max_pages 為 0 到 50(0 或省略為 50),每頁 20 支影片,一次查詢約可涵蓋 1,000 支影片。以 GET /bilibili/search/task/{task_id} 輪詢,DONE 時回應帶有 task、total_count 與 data,每頁最多 100 支。每支影片有網址、標題、簡介、上傳者名稱與 ID、發布時間、觀看數、按讚數、留言數、情緒標籤與封面圖。資料以網路爬蟲蒐集嗶哩嗶哩公開發布的內容。
常見用途
- 追蹤產品、品牌或話題在 B 站影片中的討論,並依觀看數或按讚數排序。
- 為市場研究或學術研究,建立某個主題、附日期的影片清單。
- 把影片網址交給 B 站留言 API,看觀眾的反應。
端點一覽
Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /bilibili/search/task |
建立影片關鍵字搜尋任務,可指定日期區間與最多爬取頁數。 |
| GET | /bilibili/search/task/{task_id} |
輪詢搜尋任務;DONE 時回傳影片與 total_count,每頁最多 100 筆。 |
請求參數
POST /bilibili/search/task
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
keyword |
body | string | 是 | 搜尋關鍵字,1 到 100 字。 | |
end_date |
body | string | 否 | 迄日,含當日(YYYY-MM-DD,UTC+8)。預設為今天。 | |
max_pages |
body | integer | 否 | 50(最多 50) |
最多爬取的結果頁數;0 或省略時用預設值。每頁 20 支影片。 |
rerun |
body | boolean | 否 | 為了與其他平台一致而接受此參數;每次 POST 都會建立新任務。 | |
start_date |
body | string | 否 | 起日,含當日(YYYY-MM-DD,UTC+8)。預設為 7 天前。 |
GET /bilibili/search/task/{task_id}
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
task_id |
path | string | 是 | 建立任務時回傳的任務 ID。 | |
page |
query | integer | 否 | 1 |
頁碼,從 1 開始。 |
pageSize |
query | integer | 否 | 100 |
每頁影片數,最多 100。 |
回應欄位
| 資料 | 欄位 | 端點 |
|---|---|---|
| 影片(data) | 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) | 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} |
程式碼範例
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}'
curl:以任務 ID 輪詢
curl "https://api.infominer.io/api/v2/bilibili/search/task/$TASK_ID?page=1&pageSize=100" \
-H "auth-header: YOUR_API_KEY"
Python(requests):建立、輪詢、讀取
import time
import requests
BASE_URL = "https://api.infominer.io/api/v2"
HEADERS = {"auth-header": "YOUR_API_KEY"}
# 1. Create the task
resp = requests.post(
f"{BASE_URL}/bilibili/search/task",
headers=HEADERS,
json={
"keyword": "露营装备",
"start_date": "2026-06-01",
"end_date": "2026-06-07",
"max_pages": 3,
},
timeout=30,
)
resp.raise_for_status()
task = resp.json()
# 2. Poll until the task leaves INIT / RUNNING
for _ in range(120):
resp = requests.get(
f"{BASE_URL}/bilibili/search/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"pageSize": 100,
},
timeout=30,
)
resp.raise_for_status()
result = resp.json()
status = result.get("status") or result.get("task", {}).get("status")
if status not in ("INIT", "RUNNING"):
break
time.sleep(15)
else:
raise SystemExit("task still running; poll it again later")
task = result.get("task", result)
if status != "DONE" or task.get("partial") or task.get("timed_out"):
raise SystemExit(f"task ended with status {status}; no complete result")
# 3. Read the records (use page / pageSize to fetch further pages)
for row in result.get("data", []):
print(row.get("url"), (row.get("title") or "")[:60])
示意回應樣本
以下為人工撰寫的示意資料:帳號為 sample_user_n,ID 明顯為假值。欄位依 2026-11-21 規格,範例只列出部分欄位。
任務 DONE 後的輪詢回應(示意資料)
{
"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
}
限制與注意事項
- 一次查詢最多 50 頁,約 1,000 支影片;熱門關鍵字請縮小或拆分日期區間。
- 只有 DONE 的輪詢回應帶資料,PARTIAL、TIMED_OUT 與 FAILED 只回傳任務物件。status 為 DONE 且 partial、timed_out 都是 false,才算完全成功。
- data 是該區間內所有已蒐集資料的比對結果,包含先前任務蒐集的,所以 total_count 可能大於 task.completed;這個任務實際蒐集的筆數是 task.completed。
- B 站影片的 share_count、reply_count、dislike_count 一律為 0;is_video 目前都是 false,但每筆資料都是影片。
- num_results 是 B 站顯示的搜尋筆數,屬於估計值,可能多於實際取得的數量。
- 數值是蒐集當下的值。搜尋途中 B 站有時會暫時不提供後面的頁面,此時任務會以 PARTIAL 結束。可回溯的期間依專案範圍確認。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。
更多 嗶哩嗶哩(bilibili) API 頁面
- 影片關鍵字搜尋
- 留言
申請試用
填寫下方申請表單時,請註明嗶哩嗶哩,並說明要追的關鍵字或影片、是否需要留言,以及預估資料量。我們會確認範圍,並回覆試用與 API 金鑰的安排。
填寫表單申請試用,專人確認範圍後回覆試用與介接安排。
填寫申請表單常見問題
- 一次 B 站搜尋可以拿到幾支影片?
- 每頁 20 支、最多 50 頁,約 1,000 支。需要更多時,請把日期區間拆成多個任務。
- B 站搜尋任務要跑多久?
- 每個搜尋頁約 4 到 10 秒,50 頁約 4 到 8 分鐘,開始前也可能先排隊。請每 3 到 5 秒輪詢一次,並設定整體的等待期限。
- 為什麼 total_count 比這個任務蒐集的數量多?
- 因為 data 是對該日期區間內所有已蒐集 B 站影片的關鍵字比對,包含先前任務蒐集的影片;這個任務實際蒐集的數量是 task.completed。
- 資料是怎麼蒐集的?這是嗶哩嗶哩官方的 API 嗎?
- 資料以網路爬蟲蒐集嗶哩嗶哩公開發布的內容。LargitData 與嗶哩嗶哩沒有隸屬或合作關係,這也不是嗶哩嗶哩自身提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。