ビリビリ(bilibili)動画キーワード検索 API
2026-11-21 時点の仕様に基づく
要点
POST /bilibili/search/task は、キーワードと投稿日の期間(YYYY-MM-DD、UTC+8、当日を含む。既定は直近 7 日)でビリビリの動画を新しい順に検索します。max_pages は 0〜50(0 または省略で 50)、1 ページ 20 本のため、1 回の検索で約 1,000 本まで届きます。GET /bilibili/search/task/{task_id} でポーリングし、DONE になるとレスポンスに task、total_count、data が含まれます(1 ページ最大 100 本)。動画には URL、タイトル、説明文、投稿者名と ID、投稿日時、再生数・いいね数・コメント数、感情ラベル、サムネイル画像が含まれます。データはビリビリで公開されているコンテンツをウェブクローラーで収集したものです。
主な用途
- 製品、ブランド、話題がビリビリの動画でどう取り上げられているかを追い、再生数やいいね数で並べる。
- 市場調査や学術研究のために、テーマごとの動画を日付付きで集める。
- 動画 URL をビリビリのコメント API に渡し、視聴者の反応を見る。
エンドポイント
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /bilibili/search/task |
動画のキーワード検索タスクを作成します。期間とページ上限を指定できます。 |
| GET | /bilibili/search/task/{task_id} |
検索タスクをポーリングします。DONE で動画と total_count を返します(1 ページ最大 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 または省略で既定値。1 ページ 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 |
1 ページあたりの動画数(最大 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
}
制限と注意点
- 1 回の検索で届くのは最大 50 ページ、約 1,000 本です。人気のキーワードでは期間を絞るか分けてください。
- データを含むのは DONE のポーリングだけで、PARTIAL、TIMED_OUT、FAILED はタスクオブジェクトのみを返します。status が DONE で partial と timed_out がともに false の場合を完全な成功として扱ってください。
- data は以前のタスクの結果を含め、その期間に収集済みのデータに一致するものを返すため、total_count が task.completed を上回ることがあります。このタスクで収集した件数は task.completed です。
- 動画の share_count、reply_count、dislike_count は常に 0 です。is_video は現在すべて false ですが、レコードはすべて動画です。
- num_results はビリビリが表示する検索件数で、取得できる件数を上回ることがある推定値です。
- 数値は収集時点のものです。検索中にビリビリが後続ページを一時的に返さないことがあり、その場合タスクは PARTIAL で終わります。遡れる期間はプロジェクトの範囲に応じて確認します。
ほかの ビリビリ(bilibili) API ページ
- 動画のキーワード検索
- コメント
トライアルの申し込み
下の申込フォームにビリビリと明記し、追いたいキーワードや動画、コメントの要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- ビリビリの検索 1 回で何本取得できますか?
- 1 ページ 20 本で最大 50 ページ、約 1,000 本です。それ以上必要な場合は期間を分けて複数のタスクを作成してください。
- ビリビリの検索タスクにはどのくらい時間がかかりますか?
- 検索 1 ページに約 4〜10 秒かかるため、50 ページで約 4〜8 分です。開始前に待ち行列に入ることもあります。3〜5 秒おきにポーリングし、全体の期限を設けてください。
- total_count がこのタスクの収集件数より多いのはなぜですか?
- data は、以前のタスクの分を含め、その期間に収集済みのビリビリ動画に対するキーワード一致だからです。このタスクで収集した件数は task.completed です。
- データはどのように収集していますか?ビリビリの公式 API ですか?
- ビリビリで公開されているコンテンツをウェブクローラーで収集しています。当社はビリビリと提携しておらず、ビリビリ自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。