视频弹幕 API
用 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_more | boolean | 一次给全量,恒为 false。 |
items | array<object> | 弹幕列表,按 time_sec 升序。每条含 content、time_sec(出现秒数,可带小数)、danmaku_id、send_time(UTC)、mode、color(如 #FFFFFF)。 |
page | number | |
page_size | number | |
total | number | 本次条数。 |
调用示例
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 高级弹幕。
- 弹幕很多的视频响应会比较大,请按视频逐个请求。
常见错误码
| code | error_code | 含义与处理 |
|---|---|---|
| 40001 | VALIDATION_ERROR | 参数校验失败,按返回提示修改请求,不扣费 |
| 40100 | UNAUTHORIZED | API Key 缺失、错误或已吊销,到控制台检查 Key |
| 40200 | INSUFFICIENT_BALANCE | 余额不足,充值后重试 |
| 42900 | RATE_LIMITED | 超过每分钟 60 次上限,稍后重试 |
| 50000 | INTERNAL_ERROR | 服务异常,可稍后重试,不扣费 |
| 50300 | NOT_AVAILABLE | 接口暂不可用,不扣费 |
常见问题
- 能只要某一分钟的弹幕吗?
- 不能。一次返回该分 P 的全部弹幕,请在本地按 time_sec 筛选。
- aid 为什么有时失败?
- 取弹幕前要先换成 BV 号。失败时改传 bvid 或含 BV 号的链接。
- 调用失败会扣费吗?
- 视频不存在或参数无效不扣费。成功返回空列表才会计费。
相关接口
需要接入这个接口?
免费注册
注册后创建 API Key,或留下联系方式获取方案