一、接口基础说明1. 接口基础信息请求地址请求方式GET请求参数bvidBV 号推荐/aidAV 号兼容旧视频二选一必填鉴权游客可查询公开视频私密 / 审核中视频需 Cookie 登录鉴权核心能力输入 BV/AV 号一次性获取视频标题、封面、简介、UP 主信息、分区标签、分 P 列表、播放 / 点赞 / 投币 / 收藏 / 弹幕全套互动数据是 B 站内容分析最核心接口。2. 主流业务场景UP 主数据监控定时抓取视频播放、投币、收藏数据分析账号流量走势爆款内容拆解提取视频标题、标签、简介、互动指标总结爆款创作规律二创素材采集批量获取封面、文案、分区信息用于选题参考分区内容数据分析统计不同分区平均播放、互动率输出行业报表品牌舆情监测检索品牌相关投稿收集用户视频反馈与口碑二、标准成功完整 JSON 返回公开视频完整版{ code: 0, message: 0, ttl: 1, data: { aid: 118923456, bvid: BV1XW4y1Z789, cid: 234567890, videos: 1, tid: 121, tname: 知识科普, copyright: 1, pic: https://i1.hdslb.com/bfs/archive/cover_sample.jpg, title: Python接口开发入门完整教程零基础可学, pubdate: 1746213600, ctime: 1746208900, desc: 本教程从零讲解API接口开发包含请求调试、JSON解析、异常处理适合新手入门附带完整实战代码示例, state: 0, attribute: 167168, duration: 1486, mission_id: 0, dynamic: 零基础接口开发干货分享附源码, owner: { mid: 12345678, name: 程序小栈, face: https://i0.hdslb.com/bfs/face/up_avatar.jpg }, stat: { aid: 118923456, view: 126890, danmaku: 3260, reply: 1890, favorite: 9650, coin: 6230, share: 2160, like: 18620, dislike: 126 }, pages: [ { cid: 234567890, page: 1, from: vupload, part: 第1节 接口基础概念, duration: 1486, vid: , weblink: } ], tags: [ { tag_id: 56789, tag_name: Python, tag_type: normal }, { tag_id: 56790, tag_name: API开发, tag_type: normal }, { tag_id: 56791, tag_name: 编程教程, tag_type: normal } ] } }三、高频异常错误 JSON 示例1. 参数错误aid/bvid 为空或格式错误 code-400{ code: -400, message: 请求错误, ttl: 1, data: null }2. 视频不存在 / 已下架 code-404{ code: -404, message: 不存在该稿件, ttl: 1, data: null }3. 视频仅自己可见 / 私密稿件 code62012{ code: 62012, message: 该视频仅UP主本人可见, ttl: 1, data: null }4. 视频审核中无法查看 code62004{ code: 62004, message: 稿件审核中暂不支持查看, ttl: 1, data: null }5. 调用频率过高限流HTTP 429{ code: -503, message: 请求过于频繁请稍后再试, ttl: 1, data: null }四、核心字段分类释义1. 视频唯一标识bvid新版视频唯一标识推荐优先使用aid旧版 AV 数字 IDcid单分 P 视频资源 ID用于弹幕、播放接口2. 基础元信息title视频标题desc简介文案dynamic动态附带文案pic高清封面图地址pubdate发布时间戳ctime上传提交时间戳duration视频总时长单位秒tid/tname一级分区 ID、分区名称copyright1 原创 / 2 转载3. UP 主信息 owner 对象midUP 主 UIDname昵称face头像链接4. 核心互动数据 statB 站特色指标view播放量danmaku弹幕总数reply评论数like点赞coin投币favorite收藏share转发5. 分集与标签pages分 P 数组多 P 视频包含多条分集信息tags视频标签数组包含标签 ID 与标签名称五、开发接入注意事项时间字段pubdate/ctime为 Unix 时间戳业务展示需手动格式化pages、tags为数组代码必须做空值判断避免解析崩溃无登录 Cookie 时无法访问私密、审核、仅粉丝可见视频接口存在访问频率限制批量采集需增加延时防止触发 429 限流互动数值为数字类型可直接用于互动率计算仅允许合规数据分析禁止批量爬取视频资源、倒卖平台数据。
B 站视频详情接口完整介绍与标准 JSON 返回示例
一、接口基础说明1. 接口基础信息请求地址请求方式GET请求参数bvidBV 号推荐/aidAV 号兼容旧视频二选一必填鉴权游客可查询公开视频私密 / 审核中视频需 Cookie 登录鉴权核心能力输入 BV/AV 号一次性获取视频标题、封面、简介、UP 主信息、分区标签、分 P 列表、播放 / 点赞 / 投币 / 收藏 / 弹幕全套互动数据是 B 站内容分析最核心接口。2. 主流业务场景UP 主数据监控定时抓取视频播放、投币、收藏数据分析账号流量走势爆款内容拆解提取视频标题、标签、简介、互动指标总结爆款创作规律二创素材采集批量获取封面、文案、分区信息用于选题参考分区内容数据分析统计不同分区平均播放、互动率输出行业报表品牌舆情监测检索品牌相关投稿收集用户视频反馈与口碑二、标准成功完整 JSON 返回公开视频完整版{ code: 0, message: 0, ttl: 1, data: { aid: 118923456, bvid: BV1XW4y1Z789, cid: 234567890, videos: 1, tid: 121, tname: 知识科普, copyright: 1, pic: https://i1.hdslb.com/bfs/archive/cover_sample.jpg, title: Python接口开发入门完整教程零基础可学, pubdate: 1746213600, ctime: 1746208900, desc: 本教程从零讲解API接口开发包含请求调试、JSON解析、异常处理适合新手入门附带完整实战代码示例, state: 0, attribute: 167168, duration: 1486, mission_id: 0, dynamic: 零基础接口开发干货分享附源码, owner: { mid: 12345678, name: 程序小栈, face: https://i0.hdslb.com/bfs/face/up_avatar.jpg }, stat: { aid: 118923456, view: 126890, danmaku: 3260, reply: 1890, favorite: 9650, coin: 6230, share: 2160, like: 18620, dislike: 126 }, pages: [ { cid: 234567890, page: 1, from: vupload, part: 第1节 接口基础概念, duration: 1486, vid: , weblink: } ], tags: [ { tag_id: 56789, tag_name: Python, tag_type: normal }, { tag_id: 56790, tag_name: API开发, tag_type: normal }, { tag_id: 56791, tag_name: 编程教程, tag_type: normal } ] } }三、高频异常错误 JSON 示例1. 参数错误aid/bvid 为空或格式错误 code-400{ code: -400, message: 请求错误, ttl: 1, data: null }2. 视频不存在 / 已下架 code-404{ code: -404, message: 不存在该稿件, ttl: 1, data: null }3. 视频仅自己可见 / 私密稿件 code62012{ code: 62012, message: 该视频仅UP主本人可见, ttl: 1, data: null }4. 视频审核中无法查看 code62004{ code: 62004, message: 稿件审核中暂不支持查看, ttl: 1, data: null }5. 调用频率过高限流HTTP 429{ code: -503, message: 请求过于频繁请稍后再试, ttl: 1, data: null }四、核心字段分类释义1. 视频唯一标识bvid新版视频唯一标识推荐优先使用aid旧版 AV 数字 IDcid单分 P 视频资源 ID用于弹幕、播放接口2. 基础元信息title视频标题desc简介文案dynamic动态附带文案pic高清封面图地址pubdate发布时间戳ctime上传提交时间戳duration视频总时长单位秒tid/tname一级分区 ID、分区名称copyright1 原创 / 2 转载3. UP 主信息 owner 对象midUP 主 UIDname昵称face头像链接4. 核心互动数据 statB 站特色指标view播放量danmaku弹幕总数reply评论数like点赞coin投币favorite收藏share转发5. 分集与标签pages分 P 数组多 P 视频包含多条分集信息tags视频标签数组包含标签 ID 与标签名称五、开发接入注意事项时间字段pubdate/ctime为 Unix 时间戳业务展示需手动格式化pages、tags为数组代码必须做空值判断避免解析崩溃无登录 Cookie 时无法访问私密、审核、仅粉丝可见视频接口存在访问频率限制批量采集需增加延时防止触发 429 限流互动数值为数字类型可直接用于互动率计算仅允许合规数据分析禁止批量爬取视频资源、倒卖平台数据。
