欢迎访问极媒数据 · 新媒体数据服务平台 登录 免费注册 控制台
新媒体数据
服务平台

视频弹幕 API

B 站¥0.15/次每分钟 60 次

用 BV 号、AV 号、视频链接或分享文案一次取回全部分 P 弹幕,按出现时间排序,返回正文、出现秒数和颜色。

拉取一个 B 站视频某一分 P 的全部弹幕。bvid、aid、视频链接、分享文案四选一,part 指定分 P,默认第 1 P。一次返回全量,按出现秒数升序,不分页。

每条含正文 content、出现时间 time_sec,以及弹幕 ID、发送时间、模式和颜色。

请求地址 POST https://www.xmedi.cn/api/v1/bilibili/videos/danmaku。调用成功才扣费,参数错误、平台侧失败或超时不扣费。

成功响应的 meta 含数据血缘,说明见 鉴权与计费。

适用场景

  • 口碑:统计高能时间点的弹幕原文,看观众在笑点或槽点说了什么。
  • 品牌:检索弹幕里是否出现品牌名或竞品名。
  • 字幕对照:把弹幕时间轴和视频字幕放在一起分析。

请求参数

字段类型必填说明
aid integer 否 AV 号。需要能换成 BV 号,建议直接传 bvid 或视频链接。
bvid string 否 BV 号。与 aid、url、share_text 四选一,优先用它。
part integer 否 分 P 序号,从 1 起,默认 1。
share_text string 否 含视频链接的分享文案。
url string 否 含 BV 号的视频链接。

返回 data 字段

字段类型说明
has_moreboolean一次给全量,恒为 false。
itemsarray<object>弹幕列表,按 time_sec 升序。每条含 content、time_sec(出现秒数,可带小数)、danmaku_id、send_time(UTC)、mode、color(如 #FFFFFF)。
pagenumber
page_sizenumber
totalnumber本次条数。

调用示例

curl -X POST https://www.xmedi.cn/api/v1/bilibili/videos/danmaku \
  -H "X-XMEDI-Key: xm_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"bvid":"BV1Pt5q6SEyc"}'

调试

返回示例

以下为 data 的字段结构示意,实际取值以调用结果为准。

{
  "has_more": false,
  "items": [
    {
      "color": "#FFFFFF",
      "content": "示例弹幕",
      "danmaku_id": "10001",
      "mode": 1,
      "send_time": "2026-01-01T00:00:00Z",
      "time_sec": 12.5
    }
  ],
  "page": 1,
  "page_size": 1,
  "total": 1
}

注意事项

  • 多分 P 视频要按 part 分别请求,默认只有第 1 P。
  • mode:1 到 3 为滚动,4 底部,5 顶部,7 高级弹幕。
  • 弹幕很多的视频响应会比较大,请按视频逐个请求。

常见错误码

codeerror_code含义与处理
40001VALIDATION_ERROR参数校验失败,按返回提示修改请求,不扣费
40100UNAUTHORIZEDAPI Key 缺失、错误或已吊销,到控制台检查 Key
40200INSUFFICIENT_BALANCE余额不足,充值后重试
42900RATE_LIMITED超过每分钟 60 次上限,稍后重试
50000INTERNAL_ERROR服务异常,可稍后重试,不扣费
50300NOT_AVAILABLE接口暂不可用,不扣费

常见问题

能只要某一分钟的弹幕吗?
不能。一次返回该分 P 的全部弹幕,请在本地按 time_sec 筛选。
aid 为什么有时失败?
取弹幕前要先换成 BV 号。失败时改传 bvid 或含 BV 号的链接。
调用失败会扣费吗?
视频不存在或参数无效不扣费。成功返回空列表才会计费。

相关接口

需要接入这个接口?

注册后创建 API Key,或留下联系方式获取方案

免费注册
×

微信号 xmedi369