B站评论与弹幕 API:标识与分页指南
用 JustOneAPI 按 BVID 获取视频详情、按 AID 请求普通评论、按 AID 与 CID 请求弹幕,区分游标与页码,保存最多三次请求的响应快照。
已知一个 BVID,怎样获取评论和弹幕?
JustOneAPI 的哔哩哔哩(B站)视频详情 V2 接受 bvid,普通评论 V2 接受 aid,弹幕 V2 接受 aid 和 cid。接入时先确认这些标识对应同一个视频及目标分 P,再分别请求需要的数据。
普通评论是视频评论区的讨论;弹幕是与播放时间关联的文字。视频详情中的评论数或弹幕数是统计指标,不能直接当作已经取得的评论正文或弹幕文本。本指南提供最多三次请求的响应保存示例,帮助你先核对接口和返回内容,再接入内部内容分析。
三个接口分别需要什么标识
- 视频详情 V2:
GET /api/bilibili/get-video-detail/v2,必填token和bvid。 - 视频评论 V2:
GET /api/bilibili/get-video-comment/v2,必填token和aid,可选cursor。 - 视频弹幕 V2:
GET /api/bilibili/get-video-danmu/v2,必填token、aid和cid,可选page。
BVID 是视频标识,AID 是稿件标识,CID 用于这里的目标视频片段请求。不要把整段视频链接直接填入 bvid,也不要把 BVID 当作 AID,或把 AID 当作 CID。多 P 视频应确认你要分析的是哪一个分 P,并取得与之对应的 CID。
只有 BVID 时,可以先请求详情,在实际响应中核对 AID 与目标分 P 的 CID。当前公开 OpenAPI 没有固定这三个接口 data 内的字段结构,因此下面的代码不假设这些标识一定出现在某条 JSON 路径,也不自动进行 BVID 与 AID 的转换。
普通评论用 cursor,弹幕用 page
普通评论接口的可选参数是 cursor。下面的初次评论请求省略它。继续翻页前,需要从实际响应确认下一游标的位置、取值和结束信号;不能把其他接口的 next_cursor、offset 或页码套过来。
弹幕接口的可选参数是 page。本例同样省略它,只保存一次默认请求的响应。当前参数说明没有明确默认页码、每页覆盖的播放时段或总页数,不能由一次请求推断已经取得全片或全部历史弹幕。
这两种分页应各自管理。增加采集范围前,先核对实际返回的列表、稳定记录标识和结束条件,再设置总请求数与去重规则。请求次数、保存文件数和记录条数是不同指标。
示例:按已确认的标识保存响应
在 JustOneAPI 控制台获取 API Token,并分别确认三个接口的权限、价格及可用试用次数。接口文档说明请求方式,实际取数是否成功仍取决于账户权限、目标视频及当时服务状态。
下面的命令适用于 macOS 或 Linux。设置 Token 和已知 BVID;确认 AID、CID 后再按需添加后两项环境变量。代码使用你提供的标识,不会验证它们是否属于同一个视频。
python3 -m pip install requests
export JUSTONEAPI_TOKEN='your_token'
export BILIBILI_BVID='your_known_bvid'
# 可选:先核对同一视频的 AID,才请求普通评论。
# export BILIBILI_AID='your_verified_aid'
# 可选:再核对目标分 P 的 CID,才请求弹幕。
# export BILIBILI_CID='your_verified_cid'保存为 bilibili_comments.py,运行 python3 bilibili_comments.py。只设置 BVID 时请求一次详情;再设置 AID 时增加一次普通评论;同时设置 CID 时增加一次弹幕,单次运行最多三次请求。代码不自动翻页、不重试,也不跟随重定向。
import json
import os
from datetime import datetime, timezone
from pathlib import Path
import requests
BASE_URL = "https://api.justoneapi.com"
TOKEN = os.environ.get("JUSTONEAPI_TOKEN", "").strip()
BVID = os.environ.get("BILIBILI_BVID", "").strip()
AID = os.environ.get("BILIBILI_AID", "").strip()
CID = os.environ.get("BILIBILI_CID", "").strip()
def call_api(path, params):
try:
response = requests.get(
BASE_URL + path,
params={"token": TOKEN, **params},
timeout=120,
allow_redirects=False,
)
except requests.RequestException:
raise RuntimeError("API network error or timeout") from None
if response.status_code != 200:
raise RuntimeError(f"API HTTP {response.status_code}")
try:
result = response.json()
except ValueError:
raise RuntimeError("API response is not JSON") from None
if not isinstance(result, dict):
raise RuntimeError("Unexpected API response")
if type(result.get("code")) is not int or result["code"] != 0:
raise RuntimeError("API business failure; check the docs and account")
if "data" not in result:
raise RuntimeError("Missing data; inspect the current docs")
return {key: value for key, value in result.items() if key != "requestParams"}
def save_snapshot(folder, name, path, params):
result = call_api(path, params)
snapshot = {
"capturedAtUTC": datetime.now(timezone.utc).isoformat(),
"endpoint": path,
"request": params,
"response": result,
}
(folder / name).write_text(
json.dumps(snapshot, ensure_ascii=False, indent=2), encoding="utf-8"
)
print(f"Saved {name}")
def main():
if not TOKEN or TOKEN == "your_token" or not BVID:
raise RuntimeError("Set JUSTONEAPI_TOKEN and BILIBILI_BVID")
if CID and not AID:
raise RuntimeError("Set a verified BILIBILI_AID before using BILIBILI_CID")
run_id = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S%fZ")
folder = Path("bilibili-comments-output") / run_id
folder.mkdir(parents=True, exist_ok=False)
save_snapshot(
folder, "video-detail.json", "/api/bilibili/get-video-detail/v2",
{"bvid": BVID},
)
if AID:
save_snapshot(
folder, "comments-response.json", "/api/bilibili/get-video-comment/v2",
{"aid": AID},
)
if CID:
save_snapshot(
folder, "danmaku-response.json", "/api/bilibili/get-video-danmu/v2",
{"aid": AID, "cid": CID},
)
if __name__ == "__main__":
try:
main()
except RuntimeError as error:
raise SystemExit(str(error)) from None每次运行会在 bilibili-comments-output 下新建时间目录。三个文件分别保存详情、普通评论和弹幕响应;只有配置了对应标识且该次请求成功,才生成相应文件。后续请求失败时,已经保存的文件保留。
HTTP 200 后,代码还会检查业务 code=0 及 data 是否存在。保存时略去顶层回显的 requestParams,并在自建请求元数据中排除 Token;data 原样保留。导出文件不是已经整理好的评论表,也不是全面脱敏结果,分享前应检查实际内容。
如何用于内部内容分析
先确认普通评论与弹幕各自的列表位置、正文、时间和稳定标识,再分别整理。普通评论的发布时间与弹幕在视频中的播放位置并非同一种时间字段,不能未经核对就直接合并。
比较不同视频或分 P 时,保留 BVID、AID、CID、接口版本、采集时间和已请求的分页范围。未取到数据、响应结构未知与确实没有记录应分开保存;不能把请求失败填成“零评论”,也不能用采样记录占比代表全部观众。
常见问题
普通评论和弹幕可以用同一个接口取吗?
这里是两个独立接口:普通评论需要 AID,弹幕需要 AID 与 CID。根据分析目标分别调用、保存和分页。
评论接口会获取全部楼中楼回复吗?
当前公开契约没有证明全量楼中楼覆盖,也没有定义回复树结构。需要先核对实际响应;列表中出现少量回复不等于已经取得整条讨论链。
需要字幕文本时用哪个接口?
字幕属于另一条流程,见视频搜索、详情与字幕提取教程。本篇的普通评论和弹幕响应不替代字幕轨道或语音转写。
可以先打开视频详情文档,在账户权限与预算内确认一个熟悉视频的标识和返回内容,再决定需要分析评论区、弹幕还是字幕。
继续使用 JustOneAPI
登录 Dashboard 获取 Token,查看完整 API 文档,或打开 MCP GitHub 项目了解最新配置。