Bilibili Scraper — Videos, Comments, Creators & Danmaku

Collect public Bilibili search results, video details, creator profiles and uploads, top-level comments, popular videos, and danmaku (弹幕, bullet comments) through Bilibili's public APIs. No login or user cookies are required.

哔哩哔哩 / B站 视频搜索、评论、弹幕与 UP 主公开数据采集。

Use cases

• Track public video titles, view counts, and engagement.
• Build creator and upload catalogs.
• Analyze comment sentiment and danmaku reactions, memes, and highlight moments by timeSec.
• Create feeds for AI agents / MCP tools, dashboards, and market research.

Inputs

Provide at least one source: searchQueries, videoUrls, creatorUrls, or trending: true.

Input	Description	Default
searchQueries	Keywords for video search	— (prefilled with 原神)
videoUrls	BV/av IDs, video URLs, or b23.tv short links	—
creatorUrls	Creator profile URLs or numeric mids; collects profile and uploads	—
includeComments	Fetch top-level comments for videos with an aid	false
maxCommentsPerVideo	Comment cap per video	20
includeDanmaku	Fetch danmaku (弹幕, bullet comments) for every video found or requested	false
maxDanmakuPerVideo	Maximum sorted page 1 danmaku items per video	1000 (1–5000)
trending	Include videos from the public popular board	false
maxItemsPerSource	Cap per search, creator upload list, and trending source	5
sortBy	relevance, newest, or most played	relevance
fetchFullStats	Fetch details for search and creator uploads to fill available statistics; adds requests	false
proxyConfiguration	Optional Apify proxy settings	{ "useApifyProxy": false }

Example input:

{
  "videoUrls": ["BV1GJ411x7h7"],
  "includeDanmaku": true,
  "maxDanmakuPerVideo": 50
}

The prefilled run searches 原神 and returns up to five video rows. fetchFullStats defaults to false; set it to true to fetch fuller statistics for search and creator uploads. These requests use the shared API pacer.

Output

Charged row types are video, creator, comment, and danmaku. Video rows include IDs, title, description, duration, publish time, creator, engagement stats, tags when available, cover, category, and source. A danmaku row is emitted once per video when enabled. totalInPool counts the XML elements returned by Bilibili; returned and items reflect the sorted, capped results. sentAt is an ISO timestamp, and colors are uppercase six-digit RGB hex values.

Example live search row (trimmed):

{
  "type": "video",
  "bvid": "BV1UGa961Ejt",
  "aid": 117357800330860,
  "title": "ピノキオピー - えねみぃ feat. 初音ミク・重音テト",
  "url": "https://www.bilibili.com/video/BV1UGa961Ejt",
  "owner": { "mid": 203655966, "name": "ピノキオピー_official", "url": "https://space.bilibili.com/203655966" },
  "stats": { "views": 2152613, "likes": null, "danmaku": 43302 },
  "category": "VOCALOID·UTAU",
  "source": "search:原神"
}

Example real danmaku row (trimmed to three items):

{
  "type": "danmaku",
  "bvid": "BV1GJ411x7h7",
  "cid": 137649199,
  "videoTitle": "Never Gonna Give You Up - Rick Astley",
  "totalInPool": 1200,
  "returned": 3,
  "items": [
    { "timeSec": 0, "text": "《哥斯拉大战金刚秘密片段》", "mode": 5, "fontSize": 25, "color": "#FFFFFF", "sentAt": "2021-02-19T11:32:56.000Z", "senderHash": "8c4702e5", "id": "45399252391690247" },
    { "timeSec": 0.601, "text": "我是一万个点赞，正在反复横跳", "mode": 4, "fontSize": 25, "color": "#E70012", "sentAt": "2020-11-07T09:54:55.000Z", "senderHash": "9e5adeaa", "id": "40685126698926083" },
    { "timeSec": 0.978, "text": "非物质文化遗产", "mode": 5, "fontSize": 25, "color": "#FEF102", "sentAt": "2021-02-08T06:31:20.000Z", "senderHash": "94db4968", "id": "44891481389400069" }
  ]
}

Free summary and error rows report outcomes. Danmaku errors are reported as free rows with source danmaku:<bvid>.

Pricing

Charged at $2.50 per 1,000 result rows (item-result events). Summary and error rows are free. A run with comments, danmaku, or creator uploads can produce more charged rows than videos alone.

Limits and FAQ

How many danmaku do I get? The public pool endpoint returns the video's current danmaku pool (for example, 1,200 for a 3.5-minute video), not its full history. maxDanmakuPerVideo controls how many of those items are returned.

Which parts of a multi-part video are included? Only page 1 is fetched.

Does it need an account, login, or my cookies? No. It uses anonymous public endpoints and can acquire an anonymous buvid3 identifier. It never asks for user cookies.

Why might a video be missing? Public endpoints can impose rate limits and risk controls (-412 / -352); some videos are region-locked, deleted, private, or unavailable to anonymous visitors. Retries use backoff and refresh the anonymous identifier, but cannot override access restrictions.

Are all fields always present? No. Search results may omit full descriptions or tags. Fields unavailable from an endpoint are null or empty; video detail rows provide richer metadata.

What comments are included? The first page of top-level replies only. Nested reply threads are not traversed.

How should I use it in an agent workflow? Run with search terms, creator IDs, or video URLs, then pass the dataset rows to your agent or MCP pipeline. The type field identifies videos, creators, comments, danmaku, errors, and summaries.