哔哩哔哩 - API 收集整理

野生 API 文档

不断更新中....

本项目旨在对 B 站 WEB、APP、TV 等客户端中，散落在世界各地的野生 API 进行收集整理，研究使用方法并对其进行说明，运用了黑箱法、控制变量法、代码逆向分析、拆包及反编译法、网络抓包法等研究办法

本文档探讨的对象是主站业务接口，官方开放平台 和 直播开放平台 均不属于本项目范畴，请移步

B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接口为 WebSocket；REST API 接口请求数据大多为 url query 表单或 JSON，返回数据大多为 JSON 或 Protobuf，强制使用 https 协议

📖阅读地址：Github Pages

小小的 Demo：av583785685 视频失效原因 (Youtube 备链)

::: warning ⚠️声明

1. 本项目遵守 CC-BY-NC 4.0 协议，禁止一切商业使用，如需转载请注明作者 ID
2. 请勿滥用，本项目仅用于学习和测试！请勿滥用，本项目仅用于学习和测试！请勿滥用，本项目仅用于学习和测试！
3. 利用本项目提供的接口、文档等造成不良影响及后果与本人无关
4. 由于本项目的特殊性，可能随时停止开发或删档
5. 本项目为开源项目，不接受任何形式的催单和索取行为，更不容许存在付费内容
6. 上传任何信息时请注意脱敏，删去账户密码、敏感 cookies 等可能泄漏个人信息的数据（例如 SESSDATA、bili_jct 之类的 cookies）

:::

🌱参与贡献

欢迎各位 dalao 对本项目做出贡献，也希望每个使用者都能提出宝贵的意见

目前本项目存在的问题包括但不限于：

1. 文档二级目录尚未完成
2. 部分文档较旧，修改与更新没有跟进
3. 目前文档使用 markdown 语法编写，不易生成编程语言的 SDK，详见 #604

更多信息请浏览 贡献指南

🍴目录

计划整理分类 & 目录：(文档已完结请选中 checkbox)

• [ ] 接口签名与验证
  • [x] APP API 签名（appkey 与 sign）
  • [x] 已知的 APPKey
  • [x] Wbi 签名（wts与w_rid）
  • [ ] bili_ticket
  • [ ] v_voucher 验证
• [ ] 杂项
  • [x] 获取当前时间戳
  • [x] 公共错误码
  • [x] 图片格式化
  • [x] bvid 说明
  • [ ] 设备唯一标识 BUVID
  • [ ] 获取 buvid3 / buvid4 / b_nut
  • [ ] b23.tv 短链
• [ ] gRPC API 接口定义
• [ ] 登录
  • [x] 登录操作 (人机认证)
    • [x] 短信登录
    • [x] 密码登录
    • [x] 二维码登录
    • [ ] SNS 登录 (QQ & 微信 & 微博)
  • [x] 登录基本信息
  • [ ] 个人中心
  • [ ] 注销登录
  • [x] 登录记录
  • [x] Web 端 Cookie 刷新
• [ ] 消息中心
  • [ ] 通知类消息
  • [ ] 私信
    • [ ] 私信消息类型、内容说明
  • [ ] 设置
• [ ] 用户
  • [x] 基本信息
  • [x] 状态数
  • [x] 关系
  • [ ] 个人空间
  • [x] 检查昵称是否可注册
  • [x] 用户注册
  • [x] 用户认证类型一览
  • [ ] 加入老粉计划
  • [x] 所有粉丝勋章
• [ ] 大会员
  • [ ] 大会员基本信息
  • [ ] 大会员中心
  • [ ] 大会员签到
  • [ ] 大会员操作
• [ ] 视频
  • [x] 视频分区一览 (分区代码)
  • [x] 基本信息
  • [x] 状态数 (已失效)
  • [x] 快照
  • [x] 点赞 & 投币 & 收藏 & 分享
  • [ ] TAG
  • [x] 视频推荐
  • [x] 播放 & 下载地址 (视频流)
  • [ ] 互动视频
  • [x] 高能进度条
  • [ ] 信息上报 (心跳及记录历史)
  • [x] 视频属性数据
  • [x] 视频在线人数
  • [x] 视频 AI 摘要
  • [ ] 稿件投诉
  • [ ] 视频状态数
  • [ ] 视频合集
  • [ ] 播放器
• [ ] 剧集 (番剧、影视)
  • [ ] 基本信息
  • [ ] 播放 & 下载地址（视频流）
  • [ ] 时间轴
  • [ ] 追番相关
  • [ ] 状态数
  • [ ] 操作
• [ ] 视频弹幕
  • [x] protobuf 实时弹幕
  • [x] protobuf 弹幕元数据（BAS 弹幕 / 互动弹幕）
  • [x] xml 实时弹幕
  • [x] 历史弹幕
  • [x] 快照
  • [ ] 弹幕操作
  • [ ] 高级弹幕
  • [ ] 屏蔽管理
  • [ ] 智能防挡弹幕
  • [x] 弹幕个人配置修改
  • [x] 名词解释
  • [x] 点赞查询
• [x] 视频笔记
  • [x] 笔记列表
  • [x] 笔记详细信息
  • [x] 笔记操作
• [ ] 专栏
  • [ ] 专栏分类
  • [X] 基本信息
  • [X] 点赞 & 投币 & 收藏 & 分享
  • [X] 文集基本信息
  • [X] 获取用户专栏文章列表
• [ ] 音频
  • [x] 歌曲基本信息
  • [ ] 歌单 & 音频收藏夹详细信息
  • [ ] 状态数
  • [ ] 投币 & 收藏
  • [x] 播放 & 下载地址（音频流）
  • [x] 音频榜单
• [ ] 排行榜 & 最新视频
  • [ ] 排行榜
  • [ ] 热门视频
  • [ ] 最新视频
  • [x] 入站必刷视频
• [ ] 搜索
  • [x] 搜索请求
  • [x] 搜索结果
  • [x] 默认搜索 & 热搜
  • [x] 搜索建议
• [ ] 小黑屋
  • [ ] 基本信息
  • [x] 封禁公示
  • [x] 风纪委员及众裁案件相关
    • [x] 风纪委员基本信息
    • [x] 众裁案件基本信息
    • [x] 裁决操作
• [x] 评论区
  • [x] 评论区明细
  • [x] 操作
• [ ] 表情
  • [x] 表情及表情包信息
  • [x] 操作
• [ ] 创作中心
  • [ ] 投稿
  • [ ] 统计与数据
  • [ ] 列表查询相关
  • [x] 电磁力数据
  • [ ] 合集管理
  • [ ] 视频相关杂项
• [x] 实时广播（通讯协议）
  • [x] 视频内广播
• [ ] 充电
  • [ ] 包月充电
  • [ ] 自定义充电
  • [x] B 币方式充电
  • [x] 微信 & 支付宝方式充电
  • [x] 充电留言
  • [x] 充电列表
• [ ] 动态
  • [ ] 获取动态列表
  • [ ] 获取用户空间动态
  • [ ] 动态基本信息
  • [ ] 动态详细信息字段
  • [ ] 获取动态详情
  • [ ] 动态类型对照
  • [ ] 动态信息
  • [ ] 话题搜索
  • [ ] 发送 & 转载动态
  • [ ] 根据关键字搜索用户（at 别人时的填充列表）
  • [ ] 操作
  • [ ] 动态列表
    • [x] 特定话题动态列表
  • [ ] 动态内容
  • [ ] 导航栏动态
• [ ] 相簿 (已下线)
  • [x] 基本信息
  • [x] 相簿列表
  • [x] 推荐作者
  • [x] 活动列表
  • [x] 操作
  • [ ] 投稿
• [ ] 历史记录 & 稍后再看
  • [x] 历史记录
  • [x] 稍后再看
• [ ] 收藏夹
  • [x] 基本信息
  • [x] 收藏夹内容
  • [ ] 收藏夹操作
• [ ] 课程
  • [x] 课程基本信息
  • [ ] 已购课程
  • [ ] 分区推荐列表
  • [ ] 操作
  • [x] 播放 & 下载地址（视频流）
• [ ] 直播
  • [ ] 直播间基本信息
  • [ ] 直播分区
  • [ ] 直播间管理
  • [ ] 直播间操作
  • [ ] 直播视频流
  • [ ] 直播信息流
  • [ ] 直播红包
  • [ ] 直播间用户实用 API
  • [x] 直播间禁言相关
  • [ ] 关注UP直播情况
  • [ ] 直播心跳上报
• [ ] 活动
  • [ ] 活动列表
  • [ ] 活动主题信息
• [ ] 转正答题
  • [x] 查询信息
  • [x] 拉取题目
  • [x] 操作
• [ ] 青少年守护
  • [x] 青少年模式
  • [ ] 亲子平台
  • [ ] 课堂模式
• [ ] B 币钱包
  • [ ] 基本信息
  • [ ] B 币充值
  • [ ] 贝壳相关
• [ ] 哔哩哔哩漫画
  • [ ] 用户信息
  • [x] 签到
  • [x] 积分商城
  • [x] 漫画操作
  • [ ] 漫画任务操作
  • [x] 漫画赛季
  • [x] 漫读券/已购相关
  • [x] 下载
  • [x] data.index 解析
  • [ ] 获取轻享卡信息
• [ ] 哔哩哔哩游戏
• [ ] 终端网络查询
  • [x] 基于 IP 的地理位置查询
• [ ] 客服中心
  • [ ] 客服消息
• [ ] web 端组件
  • [x] 分区当日投稿数
  • [x] 404 页漫画收集
  • [ ] 首页横幅头图
• [ ] APP 端组件
  • [x] 开屏图片 + 恰饭珍贵录像
  • [ ] 获取最新 APP 版本
• [ ] 个性装扮
  • [x] APP 主题
  • [x] 主题色
  • [ ] 装扮/收藏集

✨鸣谢

你们的存在，让社区更美好

📖相关协议基础

HTTP 协议：传送门

JSON 序列格式：传送门

XML 序列格式：传送门

ProtoBuf 序列格式：传送门

💦交流

⚠注意：开源社群欢迎交流探讨，拒绝咨询、不支持合作，黑产号一经发现立即拉黑并举报相关 SRC

• QQ 交流群：邀请链接
• Telegram 交流群：@bilibili_API_collect_community

🧋发电

欢迎来交♂易，大家的支持就是我继续开发的动力！

请可爱的易姐喝杯奶茶

WeChat & Alipay：

OR Aifadian：https://afdian.net/@ShakaiAneE

🔗相关项目推荐

库及文档

• jingyuexing/bilibiliAPI
• fython/BilibiliAPIDocs
• czp3009/bilibili-api
• Vespa314/bilibili-api
• Pengfei00/bili-utils: bilibili 工具箱
• lovelyyoshino/Bilibili-Live-API: Bilibili 直播/番剧 API 文档
• flaribbit/bilibili-manga-spider: Bilibili 漫画爬虫
• simon300000/bili-api: Bilibili Node.js API
• iyear/biligo: Bilibili API SDK in Golang
• bilibili-openplatform/demo: 哔哩哔哩开放平台示例代码库
• ddiu8081/blive-message-listener: Bilibili-live danmu listener with type. Bilibili 直播间弹幕监听库，支持类型输出。
• Nemo2011/bilibili-api: 哔哩哔哩常用API调用。支持视频、番剧、用户、频道、音频等功能。工具齐全。
• CuteReimu/bilibili: 哔哩哔哩API的Go版本SDK

成品

• NullPointerException/AnimePipe: 功能完善的Android流媒体综合客户端，支持Bilibili, Youtube, NicoNico
• 3Shain/Comen: 基于h5的B站直播弹幕姬
• AncientLysine/BiliLocal: 本地弹幕播放器
• zyzsdy/biliroku: bilibili 生放送（直播）录制
• otakustay/danmaku-to-ass: A站B站弹幕转字幕文件
• bilibili-helper/bilibili-helper-o: 哔哩哔哩 (bilibili.com) 辅助工具，可以下载视频，查询弹幕发送人以及一些十分实用的直播区功能。
• apachecn/CDNDrive: 基于B站相簿上传的文件分块索引存储器
• Hsury/BiliDrive: 基于B站相簿上传的文件分块索引存储器
• Tsuk1ko/bilibili-live-chat: 无后端的仿 YouTube Live Chat 风格的简易 Bilibili 弹幕姬
• ironmanic/crawler_target_users_good: 搜索bilibili特定视频，为评论 点赞，关注，私信，一体化服务
• dd-center/DDatElectron: DD@Home 分布式项目, 桌面客户端
• dd-center/vtbs.moe: B站VTB数据中心
• the1812/Bilibili-Evolved: 强大的哔哩哔哩增强脚本: 下载视频、音乐、封面、弹幕 / 简化直播间、评论区、首页 / 自定义顶栏、删除广告、夜间模式 / 触屏设备支持
• xlzy520/bili-short-url: 哔哩哔哩短链生成器
• zjkwdy/bili_app_splash: B站壁纸娘和开屏图自动下载，每天使用Actions自动同步
• Jannchie/BiliOB: BiliOB观测者是一个观测B站UP主及视频数据变化，并予以分析的Web应用程序
• biliob233/biliob233.github.io: 无可奉告
• biliup/biliup: 全自动录播、投稿工具，支持录制直播弹幕，也支持Youtube、twitch直播回放列表自动搬运到B站
• ddiu8081/bilicli: Bilibili-live danmu dashboard in your terminal.
• MotooriKashin/Bilibili-Old: 恢复旧版Bilibili页面，为了那些念旧的人。
• SocialSisterYi/bcut-asr: 使用必剪API的语音字幕识别
• CzJam/Bili_Realtime_Data: Bilibili粉丝与视频实时数据统计
• kingwingfly/fav: 自动同步bili收藏夹、合集视频到本地的CLI工具（Rust实现，并提供一个文档测试完善的Rust风格的用于构建有状态爬虫的核心库）
• linyuye/Bilibili_crawler: 基于bilibili懒加载api爬取b站动态，视频等评论区

其他

• kuresaru/geetest-validator: GeeTest 调试器
• bloomrpc/bloomrpc: GUI Client for GRPC Services
• grpc/grpc: The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
• glideapps/quicktype: quicktype generates strongly-typed models and serializers from JSON, JSON Schema, TypeScript, and GraphQL queries, making it a breeze to work with JSON type-safely in many programming languages. 一键生成多种语言的JSON反序列化所需类，以便于快速反序列化，有网页版