哔哩哔哩视频解析API返回JSON格式说明

什么是哔哩哔哩视频解析 API

哔哩哔哩视频解析 API 是一类第三方接口服务，它的作用是把 B 站（bilibili）视频的 BV 号或 AV 号、番剧号等输入进去，自动解析出视频的真实播放地址、封面、分集信息以及字幕等内容，并以 JSON 格式返回给调用方。对于想要在自有���站、小程序或工具中嵌入 B 站视频资源的开发者来说，理解这套 JSON 结构是后续开发与排错的基础。

典型的 JSON 返回结构概览

不同服务商返回的字段名称可能略有差异，但核心结构大体一致。下面是一段经过简化的示例，便于直观理解整体框架：

{   "code": 0,   "message": "success",   "data": {     "bvid": "BV1xx411c7mD",     "aid": 12345678,     "title": "示例视频标题",     "pic": "https://i0.hdslb.com/...jpg",     "duration": 596,     "owner": { "name": "UP主昵称", "mid": 99999999 },     "pages": [       { "cid": 111111, "page": 1, "part": "正片", "duration": 596 }     ],     "playurl": {       "quality": 80,       "format": "mp4",       "url": "https://upos-sz-mirror.../...mp4"     }   }  }

逐字段详细说明

1. 顶层状态字段

• code：整数状态码。常见取值：0 表示成功，非 0 表示失败（如 1 参数错误、404 视频不存在、-101 未登录等）。
• message：字符串，对 code 的文字描述，便于排查问题。
• data：对象或数组，承载真正的解析结果。code 非 0 时通常为 null。

2. 视频基础信息

• bvid：12 位 BV 号，新版视频主标识。
• aid：对应的 AV 号（数字 ID），兼容旧接口。
• title：视频标题。
• pic：封面图 URL，可直接用于前端展示。
• duration：总时长，单位为秒。

3. UP 主信息（owner）

• name：UP 主昵称。
• mid：UP 主 UID，可用于跳转个人空间。

4. 分集信息（pages）

多 P 视频会返回数组，每个元素包含：

• cid：分集 ID，拼接播放地址时必须用到。
• page：分集序号，从 1 开始。
• part：分集标题。
• duration：该分集时长（秒）。

5. 播放地址（playurl）

• quality：画质代码，常见 16（360P）、32（480P）、64（720P）、80（1080P）、112（1080P+）、116（1080P60）、120（4K）。
• format：封装格式，通常为 mp4 或 flv。
• url：可直接播放的 CDN 链接。注意该链接可能带 Referer 防盗链，跨域引用时需要在请求头中携带正确来源。

常见错误码与排查思路

1. code = -400：请求参数缺失或格式错误，检查 BV 号、cid 是否齐全。
2. code = -404：视频不存在或已被删除。
3. code = -403：触发 B 站风控，通常是 IP 被限速或缺少必要 Cookie。
4. code = 62002：大会员专属视频未携带登录态。

排查建议：先用 Postman 或 curl 直接调用一次，确认接口本身可用，再把请求逻辑迁移到代码中；遇到 -403 时可尝试降低并发、补充 UA 与 Referer。

对接示例（伪代码）

GET https://api.example.com/bilibili/parse?bvid=BV1xx411c7mD&cid=111111&qn=80

返回 JSON 后，按以下顺序处理：

1. 判断 code 是否为 0；
2. 读取 data.playurl.url 赋值给 video 标签的 src；
3. 把 data.pic 设置为 poster；
4. 若 pages 长度大于 1，渲染分集切换列表。

使用与合规提示

调用第三方解析 API 时，请确保仅用于学习、测试或个人非商业用途，避免对 B 站官方服务造成过大压力。同时请尊重 UP 主版权，不要将解析出的视频用于二次分发或盈利场景。

温馨提示

本文示例字段基于公开资料整理，不同服务商的实际接口可能略有出入，建议在正式接入前以官方文档为准，并在测试环境充分验证 code、playurl 等关键字段。合理使用接口，才能既享受便利，又规避风险。