ビリビリ(bilibili)API:動画のキーワード検索とコメント

2026-11-21 時点の仕様に基づく

要点

ビリビリ(bilibili)API には 2 種類の非同期タスクがあります。POST /bilibili/search/task はキーワードと投稿日の期間(既定は直近 7 日)でビリビリの動画を検索し、1 ページ 20 本で最大 50 ページ、1 回の検索で約 1,000 本まで収集します。POST /bilibili/pushs/task は 1 本の動画のコメントと、その下の返信を収集します。どちらも GET でポーリングし、DONE になると同じレスポンスに新しい順のレコードが含まれます。動画には URL、タイトル、説明文、投稿者、投稿日時、再生数・いいね数・コメント数、サムネイル画像が含まれます。コメントの収集には制限があり、1 つのタスクで集められるのは動画の人気上位 3 件の第 1 階層コメントと、それぞれの最初の 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 です。API キーは auth-header リクエストヘッダーで送信します。* の付いたパラメーターは必須です。

メソッドパス説明主なパラメーター
POST /bilibili/search/task 動画のキーワード検索タスクを作成します。期間とページ上限を指定できます。 keyword* end_date max_pages rerun start_date
GET /bilibili/search/task/{task_id} 検索タスクをポーリングします。DONE で動画と total_count を返します(1 ページ最大 100 件)。 task_id* page pageSize
POST /bilibili/pushs/task /video/BV... の URL からコメントタスクを作成します。返信も収集できます。 post_url* crawl_second_layer max_pages rerun
GET /bilibili/pushs/task/{task_id} コメントタスクをポーリングします。DONE でコメントを返します(1 ページ最大 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、1 ページ 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 になったら data から動画を page と pageSize(1 ページ最大 100 件)で読みます。num_results はビリビリが表示する検索件数で、取得できる件数を上回ることがある推定値です。
  4. コメントが必要な動画は、/video/BV... の URL で POST /bilibili/pushs/task を作成します。crawl_second_layer(既定 true)で各コメントの返信も収集します。GET /bilibili/pushs/task/{task_id} でポーリングし、pageSize 最大 1000 でコメントを読みます。reported_total はビリビリが表示するコメント数です。

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"

動画 URL からコメントタスクを作成

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
}

投稿とコメントの関連付け

コメントタスクは動画 URL から作成します。各コメントの post_id は動画のドキュメント ID で、検索結果での同じ動画の id と一致します。push_type は第 1 階層のコメントが comment、コメントへの返信が reply です。コメントタスクのオブジェクトには動画の BV ID(bvid)が含まれます。data にはその動画について収集済みのすべてのコメント(以前のタスクの分を含む)が入るため、total_count と task.completed は一致しないことがあります。

取得期間と制限

  • 1 回の検索で取得できるのは最大 50 ページ、約 1,000 本です。人気のキーワードでは期間を絞るか、複数のタスクに分けてください。
  • コメントタスクで収集できるのは、動画の人気上位 3 件の第 1 階層コメントと、それぞれの最初の 20 件の返信までです。completed が reported_total を大きく下回るのは想定どおりで、失敗ではありません。
  • ビリビリのコメントの region(IP 所在地)は常に空です。
  • 動画の share_count、reply_count、dislike_count は常に 0 です。is_video は現在すべて false ですが、レコードはすべて動画です。
  • post_url は bilibili.com の /video/BV... の URL に限ります。av の URL や b23.tv の短縮リンクは受け付けないため、先に展開してください。
  • data はその期間に収集済みのデータに対するキーワード一致で、以前のタスクの結果も含むため、total_count が task.completed を上回ることがあります。このタスクで収集した件数は task.completed です。いいね数・コメント数・再生数は収集時点の値です。収集した数値は後日、不定期に更新されます。
  • 短時間に多数のタスクを作成すると、タスクが待ち行列に入ったり、ビリビリにリクエストを拒否されて PARTIAL や FAILED で終わったりします。検索中にビリビリが後続ページを一時的に返さないことがあり、その場合タスクは PARTIAL で終わります。検索で遡れる期間はプロジェクトの範囲に応じて確認します。
収集方法:各プラットフォームで公開されているコンテンツをウェブクローラーで収集しています。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。

納品形式

JSON で返します。検索とコメントのタスクは DONE になるとポーリングレスポンスにレコードが含まれ、page と pageSize でページングします(検索は 1 ページ最大 100 件、コメントは最大 1000 件)。バッチファイルなどその他の納品方法はプロジェクトの範囲に応じて確認します。

トライアルの申し込み

下の申込フォームにビリビリと明記し、追いたいキーワードや動画、コメントの要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。

フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。

申込フォームに記入する

よくある質問

ビリビリの動画のコメントをすべて取得できますか?
いいえ。1 つのコメントタスクで収集できるのは、動画の人気上位 3 件の第 1 階層コメントと、それぞれの最初の 20 件の返信までです。task.completed と reported_total を比べると収集できた割合がわかります。
ビリビリの検索 1 回で何本の動画を取得できますか?
1 ページ 20 本で最大 50 ページ、約 1,000 本です。それ以上必要な場合は、期間を分けて複数のタスクを作成してください。
b23.tv の短縮リンクや av の URL は使えますか?
使えません。https://www.bilibili.com/video/BV.../ の形式に展開してから指定してください。この形式の URL にトラッキング用パラメータが付いていても構いません。
HTTP エラーコードの意味は?
HTTP 400 はリクエストの形式エラー(keyword がない、start_date が end_date より後など)、401 はキーがないか無効、403 はこのプラットフォームへのアクセス権がないキー、404 は存在しないタスク ID、422 はクローラー側が受け付けなかったリクエスト(別サイトの URL、範囲外の max_pages など)で、タスクは作成されません。500 と 502 は間隔を空けて再試行し、503 は Retry-After の後に再試行します。
ビリビリのスクレイピング API ですか?データはどのように収集していますか?
はい。ビリビリで公開されているコンテンツを LargitData がウェブクローラーで収集し、API から JSON で返します。お客様側でスクレイパーを運用する必要はありません。当社はビリビリと提携しておらず、ビリビリ自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。