旧站的内容可能已过时。您可以前往“真魂”分站查看本页面,那里的内容将会定期同步。
哔哩哔哩API详解
我已经很长时间未能更新本文,由于 API 文档具有一定的时效性,本文内容的准确性可能有待验证。不过,仍然希望本文对您有帮助。在本提示从本页移除前,本文档目前的内容以 CC0 协议提供给大家,使用本文内容无需经过我同意。DGCK81LNN 2022年8月2日 (二) 17:32 (CST)
此页面的内容不完整,将来应该会将其补完。
此页面正在重新排版中,部分内容尚不能正常显示
API输出结果中无法理解/重复出现的信息已删去
格式示例
节点格式:类型 键: 说明
类型:N=数字 S=字符串 B=布尔值 A=数组 O=对象
- O: 根对象
- N code: 一个数字
- A data: 出现数组时,只举其中一项为例
- O: 数组里的一个对象
- S name: 一个字符串
- O: 数组里的一个对象
- B status: 一个布尔值
如果某个节点的说明后面标有“(?)”标记,表示这段说明只是笔者的猜测,如有错误欢迎在评论区指出
通用报错格式
未特殊说明的API均使用以下格式报错:
- O: 根对象
- N code: 错误代码,没有错误则为0
- S message: 错误信息
- O data: 正文
有时message
会变成msg
目录 |
主站
视频信息
视频基本信息
栗子 | |
---|---|
|
查看 查询 |
av106 | 查看 查询 |
* 查看 = 在哔哩哔哩查看,查询 = 调用这个API |
https://api.bilibili.com/x/web-interface/view?bvid=【BV号】
https://api.bilibili.com/x/web-interface/view?aid=【AV号】
- O: 根对象
- O data
- S bvid: BV号
- N aid: AV号
- N videos: 分P数量
- S tname: 分区名
- N copyright: 类型 1自制 2转载
- S pic: 封面URL
- S title: 标题
- N pubdate: 发布时间
- (时间未特殊说明的一律是1574695956这样的时间戳)
- N ctime: 过审时间
- S desc: 简介
- N duration: 时长
- (时长未特殊说明的一律按秒计算,后略)
- O rights: 视频属性
- N download: 是否允许缓存(版权限制)(0=不允许 1=允许)
- N movie: 是否是电影(0=否 1=是)
- N pay: 是否仅限大会员观看(0=否 1=是)
- N no_reprint: 是否显示“未经作者授权,禁止转载”字样(0=不显示 1=显示)
- N is_cooperation: 是否是联合投稿(0=否 1=是)
- O owner: UP主信息
- N mid: UID
- S name: 昵称
- S face: 头像URL
- O stat: 统计数据
- N view: 播放量
- N danmaku: 弹幕数
- N reply: 评论数
- N favorite: 收藏数
- N coin: 硬币数
- N share: 转发数
- N now_rank: 全站排行(没有的为0)
- N his_rank: 历史最高全站排行(没有的为0)
- N like: 点赞数
- S dynamic: 动态内容
- A pages: 分P列表
- O
- N page: 序号
- S part: 标题
- N duration: 时长
- O
- A staff: 联合投稿信息(非联合投稿没有此节点)
- O
- N mid: UID
- S title: 类型描述,如“UP主”“参演”“后期”
- S name: 昵称
- S face: 头像URL
- O vip: 大会员状态
- N type: 0非大会员 1大会员 2年度大会员
- O official: bilibili认证信息
- N type: -1无 0个人认证 1机构认证
- S title: 认证说明
- N follower: 关注数
- O
- O data
视频标签
栗子 | |
---|---|
|
查看 查询 |
av107[1] | 查看 查询 |
https://api.bilibili.com/x/tag/archive/tags?bvid=【BV号】
https://api.bilibili.com/x/tag/archive/tags?aid=【AV号】
- O: 根对象
- A data
- O
- N tag_id: 标签ID
- S tag_name: 标签名
- S cover: 标签图标
- S head_cover: 标签封面
- S content: 标签简介
- S short_content: 短简介
- O count
- N atten: 订阅数
- O
- A data
收藏夹信息
栗子 | |
---|---|
ml829913747 | 查看 查询 |
https://api.bilibili.com/x/v3/fav/resource/list?media_id=【ML号】&pn=【页码】&ps=【每页几个】
页码未特殊说明的均从1开始
- O: 根对象
- O data
- O info: 收藏夹基本信息
- N id: ML号
- N mid: 创建者UID
- S title: 收藏夹名
- S cover: 收藏夹封面
- O upper: UP主信息
- N mid: 创建者UID
- S name: 创建者昵称
- S face: 创建者头像
- N attr: 属性
- 0=普通 9=已被UP主删除 16=互动视频 待补充……
- O cnt_info: 统计数据
- N collect: 收藏数
- N play: 播放数
- N thumb_up: 点赞数
- N share: 转发数
- S intro: 简介
- N ctime: 创建时间
- N mtime: 修改时间
- N media_count: 视频数量
- A medias: 收藏夹内容
- O
- N id: AV号
- S title: 标题
- S cover: 封面
- S intro: 简介
- N page: 分P数
- N duration: 时长
- O upper: UP主信息
- N mid: UID
- S name: 昵称
- O cnt_info: 统计数据
- N collect: 收藏数
- N play: 播放数
- N danmaku: 弹幕数
- N ctime: 过审时间
- N pubtime: 发布时间
- N fav_time: 收藏时间
- S bvid: BV号
- O
- O info: 收藏夹基本信息
- O data
专栏信息
栗子 | |
---|---|
cv3593887 | 查看 查询 |
https://api.bilibili.com/x/article/view?id=【CV号】
- O: 根对象
- O data
- N id: CV号
- O category: 分区
- N id: 分区ID
- N parent_id: 父分区的ID(顶级分区为0)
- S name: 分区名
- A categories: 详细分区信息(两级,一个父分区一个子分区)
- O
- N id
- N parent_id
- S name
- O
- S title: 标题
- S summary: 预览
- S banner_url: 头图URL
- O author: UP主信息
- N mid: UID
- S name: 昵称
- S face: 头像URL
- O pendant: 头像挂件信息
- O official_verify: bilibili认证信息
- O nameplate
- O vip: 大会员信息
- B original: 是否为原创(?)
- N reprint: 是否允许规范转载(?)
- A image_urls: 封面列表(最多三个)
- S 封面URL
- A origin_image_urls: 封面原图列表(最多三个)
- S 封面原图URL
- N publish_time: 发布时间
- N ctime: 过审时间(?)
- O stats: 统计数据
- N view: 阅读数
- N favorite: 收藏数
- N like: 点赞数
- N reply: 评论数
- N share: 分享数
- N coin: 硬币数
- A tags: 标签列表
- O
- N tid: 标签ID
- S name: 标签名
- O
- N words: 字数
- S dynamic: 动态内容
- O list: 所属文集信息
- N id: ML号
- N mid: UP主UID
- S name: 标题
- S image_url: 封面URL
- N update_time: 更新时间
- N ctime: 过审时间(?)
- N publish_time: 发布时间
- S summary: 简介
- N words: 字数
- S content: 专栏正文HTML
- 注意,里面的图片URL似乎都是
//
开头的,所以如果你要在没有HTTPS的网站上把正文显示出来,请把src="//
替换成src="https://
。 - 还有,为了降低违和感,建议加上这个样式表,背景色改成
#f2f2f2
,并把正文放在一个<div class="article-holder">
里。
- 注意,里面的图片URL似乎都是
- S keywords: 从原文中随机抓取的关键词,半角逗号(“,”)分隔
- O data
专栏文集信息
栗子 | |
---|---|
rl154835 | 查看 查询 |
https://api.bilibili.com/x/article/list/web/articles?id=【RL号】
- O: 根对象
- O data
- O list: 文集基本信息
- N id: RL号
- N mid: UP主UID
- S name: 文集标题
- S image_url: 封面URL
- N update_time: 更新时间
- N ctime: 创建时间(?)
- N publish_time: 发布时间
- S summary: 简介
- N words: 字数
- N read: 阅读数
- N articles_count: 篇数
- O author: UP主信息
- N mid: UID
- S name: 昵称
- S face: 头像URL
- O pendant: 头像挂件信息
- O official_verify: bilibili认证信息
- O nameplate
- O vip: 大会员信息
- A articles: 文集中的文章
- O
- N id: CV号
- S title: 标题
- N publish_time: 发布时间
- N words: 字数
- A image_urls: 封面列表(最多三个)
- S 封面URL
- O category: 分区
- N id: 分区ID
- N parent_id: 父分区的ID(顶级分区为0)
- S name: 分区名
- A categories: 详细分区信息(两级,一个父分区一个子分区)
- O
- N id
- N parent_id
- S name
- O
- S summary: 预览文本
- O stats: 统计数据
- N view: 阅读数
- N favorite: 收藏数
- N like: 点赞数
- N reply: 评论数
- N share: 转发数
- N coin: 硬币数
- O
- O last: 文集中的最新一篇文章(格式同上)
- O list: 文集基本信息
- O data
搜索
待补充……
旧版VC小视频
目前新投稿的小视频将进入主站,VC小视频似乎已经弃用。
小视频信息
栗子 | |
---|---|
vc1919810 | 查看 查询 |
删了罢(无慈悲) |
https://api.vc.bilibili.com/clip/v1/video/detail?video_id=VC号
- O: 根对象
- O data
- O user: UP主信息
- N uid: UID
- S head_url: 头像
- S name: 昵称
- N is_vip: 大会员状态(0=非大会员 1=大会员 2=年度大会员)
- N upload_count: 该用户上传的VC小视频数量
- O item: 视频信息
- N id: VC号
- O cover
- S default: 封面URL
- S first_pic: 视频初始画面截图(?)
- S description: 简介
- A tags: 标签列表
- S 标签名
- N video_time: 时长
- S upload_time: 发布时间字符串(格式:年年年年-月月-日日 时时:分分:秒秒)
- N width: 视频宽度
- N height: 视频高度
- S at_control: 视频简介里艾特的其他用户的信息JSON(?)
- 由于考古过程中还没找到在简介里艾特了其他人的小视频,此项的格式尚不明确
- N watched_num: 播放数
- N reply: 评论数
- S video_playurl: 视频URL
- A backup_playurl: 视频备用URL列表
- S
- O user: UP主信息
- O data
哔哩哔哩音乐
音频信息
音频基本信息
栗子 | |
---|---|
au1281641 | 查看 查询 |
https://www.bilibili.com/audio/music-service-c/web/song/info?sid=【AU号】
注意,此API的返回值被强制gzip压缩,如果使用cURL等方式获取,记得设置解码:
curl_setopt($curl, CURLOPT_ENCODING, 'gzip');
别问,问就是我拿 PHP 请求了半天都是乱码,加了这一行代码就好了
- O: 根对象
- O data
- N id: AU号
- N uid: UP主UID
- S uname: UP主昵称
- S title: 标题
- S cover: 封面URL
- vipInfo: {
- type: 0非大会员 1大会员 2年度大会员
- }
- S intro: 简介
- S lyric: 歌词
- N duration: 时长
- N passtime: 过审时间(?)
- N curtime: 最近修改时间(?)
- N aid: 链接视频AV号
- S bvid: 链接视频BV号
- O statistic: 统计数据
- N play: 播放数
- N collect: 收藏数
- N comment: 评论数
- N share: 转发数
- N coin_num: 硬币数(?)
- O data
音频所属合辑
歌单信息
待补充……
音乐人信息
待补充……
音乐人基本信息
音乐人统计数据
音乐人热门歌曲
个人空间
首页
用户基本信息
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/acc/info?mid=【UID】
- {
- data: {
- mid: UID
- name: 昵称
- sex: 性别(男/女/保密)
- face: 头像
- sign: 个签
- level: 等级(1~6)
- birthday: 生日,格式:月月-日日
- coins: 硬币数
- fans_badge: 是否开通粉丝勋章
- official: { (bilibili认证)
- type: -1无 0个人认证 1机构认证
- title: 认证说明
- },
- vip: {
- type: 0非大会员 1大会员 2年度大会员
- },
- top_photo: 头图
- }
- }
- data: {
前方各种用户信息API大全轰炸预警!
好友数
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/relation/stat?vmid=【UID】
- {
- data:{
- mid: UID
- following: 关注数
- whisper: 悄悄关注数
- black: 黑名单数
- follower: 粉丝数
- }
- }
- data:{
UP主统计数据
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/upstat?mid=【UID】
- {
- data: {
- archive: {
- view: 视频播放量
- },
- article: {
- view: 专栏阅读量
- },
- likes: 视频、动态、专栏累计获赞
- }
- archive: {
- }
- data: {
UP主置顶视频(粉丝可见)
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/top/arc?vmid=【UID】
- {
- data: {
- aid: AV号
- videos: 分P数
- tname: 分区名
- copyright: 类型 1自制 2转载
- pic: 封面
- title: 标题
- pubdate: 发布时间
- ctime: 过审时间
- desc: 简介
- duration: 时长
- owner: {
- mid: UID
- name: UP主昵称
- face: UP主头像
- },
- stat: {
- view: 播放数
- danmaku: 弹幕数
- reply: 评论数
- favorite: 收藏数
- coin: 硬币数
- share: 转发数
- like: 点赞数
- },
- dynamic: 动态文本
- bvid: BV号
- reason: 置顶理由
- }
- }
- data: {
UP主代表作(访客可见)
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/masterpiece?vmid=【UID】
- {
- data: [ (代表作可以有3个)
- {
- aid: AV号
- videos: 分P数
- tname: 分区
- copyright: 1自制 2转载
- pic: 封面
- title: 标题
- pubdate: 发布时间
- ctime: 过审时间
- desc: 简介
- duration: 时长
- owner: {
- mid: UID
- name: UP主昵称
- face: 头像
- },
- stat: {
- view: 播放数
- danmaku: 弹幕数
- reply: 评论数
- favorite: 收藏数
- coin: 硬币数
- share: 转发数
- like: 点赞数
- },
- dynamic: 动态文本
- bvid: BV号
- }
- ]
- {
- }
- data: [ (代表作可以有3个)
动态
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/space_history?host_uid=【UID】&offset_dynamic_id=【从哪条开始,0为从最新的开始】&need_top=【是否包含置顶动态,1=输出,0=不输出】
- O : 根对象
- O data
- N has_more: 是否还有下一页(1=有 0=没有)
- A cards
- O
- O desc:
- N uid: 发送者UID
- N type: 动态类型(详见#动态详情)
- N view: 阅读数
- N repost: 转发数
- N comment: 评论数
- N like: 点赞数
- N timestamp: 发布时间
- N orig_type: 所转发的原动态号(仅转发动态)
- O user_profile: UP主信息
- O info: 基本信息
- N uid: UID
- S uname: 昵称
- S face: 头像
- O card
- O official_verify: bilibili认证信息
- N type: -1无 0个人认证 1机构认证
- S desc: 认证说明
- O official_verify: bilibili认证信息
- O vip: 大会员信息
- N type: (0=非大会员 1=大会员 2=年度大会员)
- S sign: 个签
- O level_info
- N current_level: 等级(1~6)
- O info: 基本信息
- N dynamic_id: 动态号
- S dynamic_id_str: 动态号字符串
- N orig_dy_id: 所转发的原动态号
- S orig_dy_id_str: 所转发的原动态号字符串
- N rid: OID(详见#评论区通用)
- S rid_str: OID(详见#评论区通用)字符串
- 动态号是18位数,很遗憾JavaScript最大整数是900,719,925,474,092,18位数会强行变成浮点,故提供了字符串形式的动态号
- S card: 动态卡片JSON(详见#动态详情)
- S extend_json: 附加信息(详见#动态详情)
- O extra
- N is_space_top: 是否是置顶动态(1=是 0=不是)
- O display
- O like_info: ×××赞了
- A like_users
- O
- N uid: 点赞的人UID
- Suname: 点赞的人昵称
- O
- A like_users
- O like_info: ×××赞了
- O desc:
- O
- N next_offset: 下一页第一条的动态号
- 等等,明明动态号是18位数,这里为什么不给动态号字符串???
- (实测
- O data
投稿
视频
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/arc/search?mid=【UID】&pn=【页码】&ps=【每页几个】&tid=【分区号,省略此参数则显示所有分区】
- {
- code: 0,
- message: "0",
- ttl: 1,
- data: {
- list: {
- tlist: { (UP主各个分区的视频数量)
- 分区号: {
- tid: 分区号
- count: UP主该分区的视频数量
- name: 分区名
- }
- },
- 分区号: {
- vlist: [
- {
- comment: 评论数
- play: 播放数
- pic: 封面
- description: 简介
- title: 标题
- author: UP主昵称
- mid: UID
- created: 发布时间
- length: 视频时长字符串,格式:分分:秒秒 或 时:分分:秒秒
- aid: AV号
- bvid: BV号
- is_union_video: 是否是联合创作,1是,0否
- }
- ]
- {
- },
- tlist: { (UP主各个分区的视频数量)
- page: {
- count: 页数
- pn: 页码
- ps: 每页视频数量
- }
- }
- list: {
- }
音频
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/audio/music-service/web/song/upper?uid=【UID】&pn=【页码】&ps=【每页几个】&order=【排序,1(默认)发布时间,2播放量】
- {
- data: {
- curPage: 页码
- pageCount: 页数
- totalSize: 稿件总数
- pageSize: 每页稿件数量
- data: [
- {
- id: AU号
- uid: UP主UID
- uname: UP主昵称
- title: 标题
- cover: 封面
- lyric: 歌词
- duration: 时长
- passtime: 发布时间
- statistic: {
- sid: AU号
- play: 播放数
- collect: 收藏数
- comment: 评论数
- share: 转发数
- }
- }
- ]
- {
- }
- }
- data: {
专栏
文章
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/article?mid=【UID】&pn=【页码】&ps=【每页几个】&sort=【排序,默认为publish_time,其他可能的值待研究……】
- {
- data: {
- articles: [
- {
- id: CV号
- category: {
- name: 分区
- },
- categories: [ (标签列表)
- {
- name: 标签名
- }
- ],
- {
- title: 标题
- summary: 预览文本
- banner_url: 封面
- author: {
- mid: UP主UID
- name: UP主昵称
- face: UP主头像
- vip: {
- type: 0非大会员 1大会员 2年度大会员
- }
- },
- image_urls: [ (头图列表)
- 头图URL
- ],
- publish_time: 发布时间
- ctime: 过审时间
- stats: {
- view: 阅读数
- favorite: 收藏数
- like: 点赞数
- reply: 评论数
- share: 转发数
- coin: 硬币数
- },
- words: 字数
- origin_image_urls: [ (头图原图列表)
- 头图原图URL
- ]
- original: 1原创 0非原创
- }
- ],
- {
- pn: 页码
- ps: 每页项数
- count: 页数
- }
- articles: [
- }
- data: {
文集
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/article/up/lists?mid=【UID】&sort=【排序 0发布时间 1阅读量】
- {
- data: {
- lists: [
- {
- id: RL号
- mid: UP主UID
- name: UP主昵称
- image_url: 封面URL
- update_time: 修改时间
- ctime: 过审时间
- summary: 简介
- words: 字数
- read: 阅读量
- articles_count: 篇数
- }
- ],
- {
- total: 文集总数
- }
- lists: [
- }
- data: {
相簿
各分区投稿数量统计
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.vc.bilibili.com/link_draw/v1/doc/upload_count?uid=【UID】
- {
- data: {
- all_count: 相册投稿总数
- draw_count: 绘画区稿件数
- photo_count: 摄影区稿件数
- daily_count: 日常区稿件数
- }
- }
- data: {
全部相簿投稿
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=【UID】&page_num=【页码(从0开始)】&page_size=【每页几个】
- {
- data: {
- items: [
- {
- doc_id: 相册投稿号
- poster_uid: UID
- title: 标题
- description: 简介
- pictures: [
- {
- img_src: 图片URL
- img_width: 图片宽度
- img_height: 图片高度
- img_size: 图片大小(KB)
- }
- ],
- {
- count: 图片数量
- ctime: 发布时间
- view: 查看数
- like: 点赞数
- }
- ]
- {
- }
- items: [
- }
- data: {
频道
频道基本信息
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/space/channel/list?mid=【UID】
- {
- data: {
- count: 频道数量
- list: [
- {
- cid: 频道号
- mid: UID
- name: 频道名
- intro: 频道简介
- mtime: 创建时间
- count: 视频数量
- cover: 封面
- }
- ]
- {
- }
- }
- data: {
频道内容
待补充…………
收藏
创建的收藏夹
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/v3/fav/folder/created/list-all?up_mid=【UID】
- {
- data: {
- count: 收藏夹数量
- list: [
- {
- id: 收藏夹ML号
- mid: UID
- title: 收藏夹名
- media_count: 视频数
- }
- ]
- {
- }
- }
- data: {
收藏的收藏夹
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://api.bilibili.com/x/v3/fav/folder/collected/list?pn=【页码】&ps=【每页几个】&up_mid=【UID】
- {
- data: {
- count: 收藏的收藏夹数量
- list: [
- {
- id: 收藏夹ML号
- mid: 创建者UID
- title: 收藏夹名
- upper: {
- mid: 创建者UID
- name: 创建者昵称
- },
- intro: 简介
- ctime: 创建时间
- media_count: 视频数量
- }
- ]
- {
- }
- }
- data: {
订阅
追番追剧
栗子 | ||
---|---|---|
uid328066747 | 追番 | 查看 查询 |
追剧 | 查看 查询 |
https://api.bilibili.com/x/space/bangumi/follow/list?type=【1追番 2追剧】&pn=【页码】&ps=【每页几个】&vmid=【UID】
- {
- data: {
- list: [
- {
- season_id: 番剧SS号
- media_id: 番剧MD号
- season_type_name: 番剧类型(字符串)
- title: 番剧标题
- cover: 封面
- total_count: 共几话
- is_finish: 1完结 0未完结
- stat: {
- follow: 追番数
- view: 播放数
- danmaku: 弹幕数
- reply: 评论数
- coin: 硬币数
- series_follow: 系列总追番数
- series_view: 系列总播放量
- },
- new_ep: { (最新剧集)
- id: 剧集EP号
- index_show: 更新状态(字符串)
- cover: 封面
- title: 短标题
- long_title: 完整标题
- pub_time: 发布时间 格式:年年年年-月月-日日 时时:分分:秒秒
- duration: 时长(毫秒)
- },
- rating: {
- score: 评分(满分10)
- count: 评价数
- },
- square_cover: 正方形封面
- season_title: 本季在系列中的描述(如“第一季”)
- evaluate: 简介开头的一段,长度超出的用“...”表示
- areas: [
- {
- name: 制作国(如“美国”)
- }
- ],
- {
- first_ep: 第一集EP号
- series: {
- series_id: 系列号
- title: 系列名
- season_count: 季数
- new_season_id: 最新一季SS号
- },
- publish: {
- pub_time: 发布时间 格式:年年年年-月月-日日 时时:分分:秒秒
- release_date: 发布日期 格式:年年年年-月月-日日
- },
- progress: 观看进度,如“看到第1话”
- }
- ],
- {
- pn: 页码
- ps: 每页项数
- total: 页数
- }
- list: [
- }
- data: {
番剧SS号、MD号,剧集EP号这三种神秘的番号,我暂时还没有研究明白,,,,恕不作讲解
话题
栗子 | |
---|---|
uid328066747 | 查看 查询 |
https://space.bilibili.com/ajax/tags/getSubList?mid=【UID】
此API的报错格式不是通用格式
- {
- status: 是否查询成功
- data: {
- tags: [
- name: 话题名
- cover: 话题封面(可能为空)
- tag_id: 话题号
- }
- ],
- tags: [
- count: 话题数量
- }
- }
关注/粉丝列表
栗子 | ||
---|---|---|
uid328066747 | 关注 | 查看 查询 |
粉丝 | 查看 查询 |
关注:https://api.bilibili.com/x/relation/followings?vmid=【UID】&pn=【页码】&ps=【每页几个】&order=【排序 desc=新关注的在前 asc=新关注的在后】
粉丝:https://api.bilibili.com/x/relation/followers?vmid=【UID】&pn=【页码】&ps=【每页几个】&order=【排序 desc=新关注的在前 asc=新关注的在后】
- {
- data: {
- list: [
- {
- mid: UID
- mtime: 关注时间
- special: 1特别关注 0普通
- uname: 昵称
- face: 头像
- sign: 个签
- official_verify: {
- type: -1无认证 0个人认证 1机构认证
- desc: 认证说明
- },
- vip: {
- vipType: 0非大会员 1大会员 2年度大会员
- }
- }
- ],
- {
- total: 关注总数
- }
- list: [
- }
- data: {
用户信息API大全 完
动态
动态详情
动态类型 | |||
---|---|---|---|
类型号 | 说明 | 栗子 | |
1 | 转发动态 | 355295470145652823 | 查看 查询 |
2 | 相册投稿 | 351782199784737587 | 查看 查询 |
4 | 文字动态 | 371794999330051793 | 查看 查询 |
8 | 视频投稿 | 355292278981797225 | 查看 查询 |
16 | VC小视频投稿 | 354713888622461421 | 查看 查询 |
64 | 专栏投稿 | 334997154054634266 | 查看 查询 |
256 | 音频投稿 | 352216850471547670 | 查看 查询 |
2048 | 分享歌单 | 325805722180163707 | 查看 查询 |
4300 | 分享视频收藏夹 | 355307388674695344 | 查看 查询 |
待补充……也许吧…… |
https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail?dynamic_id=【动态号】
- {
- data: {
- card: {
- desc: {
- uid: UID
- type: 动态类型
- view: 查看数
- repost: 转发数
- like: 点赞数
- dynamic_id: 动态号
- timestamp: 发布时间
- user_profile: {
- info: {
- uid: UID
- uname: 昵称
- face: 头像URL
- },
- card: {
- official: {
- type: -1无 0个人认证 1机构认证
- desc: 认证说明
- }
- }
- official: {
- vip: {
- vipType: 0非大会员 1大会员 2年度大会员
- },
- sign: 个签
- level_info: {
- current_level: 等级(1~6)
- }
- },
- info: {
- dynamic_id_str: 动态号
- orig_dy_id_str: 所转发的原动态号
- rid_str: OID
- },
- card: 【【动态卡片的JSON,【这是一个字符串!】 具体见下文】】
- extend_json: 附加信息的JSON(投票etc),暂未研究
- }
- desc: {
- }
- card: {
- }
- data: {
动态卡片格式
转发动态
栗子 | |
---|---|
355295470145652823 | 查看 查询 |
- {
- user: {
- uid: UID
- uname: 昵称
- face: 头像
- },
- item: {
- rp_id: 动态号
- uid: UID
- content: 文字内容
- orig_dy_id: 原动态号
- timestamp: 转发时间
- reply: 评论数
- orig_type: 原动态类型
- },
- origin: 原动态卡片的JSON,【这是一个字符串!】
- origin_user: {
- info: {
- uid: 原动态发布者UID
- uname: 原动态发布者昵称
- face: 原动态发布者头像URL
- },
- card: {
- official_verify: {
- type: -1无 0个人认证 1机构认证
- desc: 认证说明
- }
- },
- official_verify: {
- vip: {
- vipType: 0非大会员 1大会员 2年度大会员
- },
- sign: 原动态发布者个签
- level_info: {
- current_level: 原动态发布者等级(1~6)
- }
- }
- info: {
- }
- user: {
相册投稿
栗子 | |
---|---|
351782199784737587 | 查看 查询 |
- {
- item: {
- id: 投稿号
- description: 简介
- pictures: [
- { (某张图片)
- img_src: 图片URL
- img_width: 图片宽度
- img_height: 图片高度
- }
- ],
- { (某张图片)
- pictures_count: 图片数量
- upload_time: 发布时间
- reply: 评论数
- },
- user: {
- uid: UID
- head_url: 头像
- name: 昵称
- card: {
- official_verify: {
- type: -1无 0个人认证 1机构认证
- desc: 认证说明
- }
- },
- official_verify: {
- vip: {
- vipType: 0非大会员 1大会员 2年度大会员
- }
- }
- }
- item: {
文字动态
栗子 | |
---|---|
371794999330051793 | 查看 查询 |
- {
- user: {
- uid: UID
- uname: 昵称
- face: 头像
- },
- item: {
- rp_id: 动态号
- content: 动态内容
- timestamp: 发布时间
- reply: 评论数
- }
- }
- user: {
视频投稿
栗子 | |
---|---|
355292278981797225 | 查看 查询 |
- {
- aid: AV号
- copyright: 类型 1自制 2转载
- desc: 视频简介
- duration: 时长
- dynamic: 动态内容
- owner: {
- face: UP主头像
- mid: UID
- name: UP主昵称
- },
- pic: 封面URL
- pubdate: 发布日期
- stat: {
- coin: 硬币数
- danmaku: 弹幕数
- favorite: 收藏数
- like: 点赞数
- reply: 评论数
- share: 转发数
- view: 播放数
- },
- title: 视频标题
- tname: 视频分区
- videos: 分P数
- }
VC小视频投稿
栗子 | |
---|---|
354713888622461421 | 查看 查询 |
- {
- user: {
- uid: UID
- head_url: 头像URL
- is_vip: 0,
- name: 昵称
- },
- item: {
- id: VC号
- cover: {
- default: 封面
- unclipped: 原始宽高比封面
- },
- tags: [
- 标签列表
- ],
- description: 简介
- video_time: 时长
- upload_time: 发布时间,格式:年年年年-月月-日日 时时:分分:秒秒
- video_playurl: 视频URL
- reply: 评论数
- watched_num: 播放数
- }
- }
- user: {
音频投稿
栗子 | |
---|---|
352216850471547670 | 查看 查询 |
{
id: AU号
upId: UP主UID
title: 标题
upper: UP主
cover: 封面URL
ctime: 发布时间
replyCnt: 评论数
playCnt: 播放数
intro: 简介
upperAvatar: UP主头像URL
}
分享歌单
栗子 | |
---|---|
325805722180163707 | 查看 查询 |
- {
- rid: 动态号
- user: {
- uid: 歌单创建者UID
- uname: 歌单创建者名称
- face: 歌单创建者头像
- },
- sketch: {
- title: 歌单名
- desc_text: "【共曲目数量】首 | 【分区】 · 【二级分区】",
- cover_url: 封面
- biz_type: 歌单类型,131歌单,133合辑
- tags: [
- { (某个标签)
- type: 标签号
- name: 标签名
- color: 标签颜色,HEX,没有井号
- }
- ]
- { (某个标签)
- }
- }
标签/话题信息
话题基本信息
栗子 | |
---|---|
标签1 | 查看 查询 |
#公告# | 查看 查询 |
https://api.bilibili.com/x/tag/info?tag_id=【标签ID】
https://api.bilibili.com/x/tag/info?tag_name=【标签名】
- O: 根对象
- O data
- N tag_id: 标签ID
- S tag_name: 标签名
- S cover: 标签图标
- S head_cover: 标签封面
- S content: 标签简介
- S short_content: 短简介
- N ctime: 创建日期
- O count
- N atten: 订阅数
- O data
话题统计数据及活跃用户列表
栗子 | |
---|---|
标签1 | 查看 查询 |
#公告# | 查看 查询 |
https://api.vc.bilibili.com/topic_svr/v1/topic_svr/get_active_users?tag_id=【标签ID】
https://api.vc.bilibili.com/topic_svr/v1/topic_svr/get_active_users?tag_name=【标签名】
- O: 根对象
- O data
- N view_count: 浏览数
- N discuss_count: 讨论数
- A active_users: 活跃用户列表
- O
- N score: 活跃程度,计算方式未知
- O user_info: 用户基本信息
- N uid: UID
- S uname: 昵称
- S face: 头像
- O official: bilibili认证信息
- N type: -1无 0个人认证 1机构认证
- S title: 认证说明
- O vip: 大会原员信息
- N vipType: 0非大会员 1大会员 2年度大会员
- O pendant: 头像挂件信息
- N pid: 挂件ID
- S name: 挂件名
- S image: 挂件图
- S sign: 个性签名
- P level_info
- N current_level: 等级(1~6)
- O
- N topic_id: 标签ID
- O data
包含话题的动态
栗子 | |
---|---|
标签1 | 查看 查询 |
#公告# | 查看 查询 |
https://api.vc.bilibili.com/topic_svr/v1/topic_svr/topic_new?tag_id=【标签ID】
https://api.vc.bilibili.com/topic_svr/v1/topic_svr/topic_new?tag_name=【标签名】
待补充……
搜索用户
栗子 | |
---|---|
DGCK81LNN | 查询 |
https://api.vc.bilibili.com/dynamic_repost/v1/dynamic_repost/name_search?keyword=【用户名】
此API用于在发表动态时输入“@”后自动联想。与搜索API不同的是,此API只能搜索昵称,并且如果昵称完全匹配,即使是一级号、二级号也能搜到。
此API的整体格式与搜索API相同
- O: 根对象
- N code: 错误代码,没有错误则为0
- A result: 正文
- O
- S uname: 昵称
- N mid: UID
- S upic: 头像URL
- N rank_offset: 这是第几条结果(?)
- S usign: 个性签名
- N videos: 视频数量
- N fans: 粉丝数
- N is_upuser: 是否是UP主(?)
- O official_verify: bilibili认证信息
- N type: -1无 0个人认证 1机构认证
- S desc: 认证说明
- N level: 等级(1~6)
- N gender: 性别(1=男 2=女 3=保密)
- A hit_columns: 通过哪项信息搜索到的这个结果,如
uname
表示用户名匹配。可以有多项。- S
- N is_live: 是否正在直播(0=否 1=是)
- N room_id: 直播间ID(没开通的为0)
- O
评论区通用
评论区类型 | ||||
---|---|---|---|---|
类型号 | 说明 | OID | 栗子 | |
1 | 视频投稿 | AV号 | 59671812 | 查看 查询 |
5 | VC小视频投稿 | VC号 | 2879073 | 查看 查询 |
11 | 相册投稿 | 相册投稿号 | 65916366 | 查看 查询 |
12 | 专栏投稿 | CV号 | 3695898 | 查看 查询 |
14 | 音频投稿 | AU号 | 1285217 | 查看 查询 |
17 | 其他动态 | 动态号 | 371794999330051793 | 查看 查询 |
19 | 音频歌单 | AM号 | 10624 | 查看 查询 |
待补充…… |
https://api.bilibili.com/x/v2/reply?type=【类型】&oid=【OID】&pn=【页码】
- {
- data: {
- page: {
- num: 页码
- size: 每页条数
- count: 评论数(不含回复)
- acount: 评论数
- },
- replies: [ (全部评论列表)
- { (某条评论)
- mid: UID
- rcount: 回复数
- ctime: 发布时间
- like: 点赞数
- member: {
- uname: 昵称
- sex: 性别
- sign: 个签
- avatar: 头像
- level_info: {
- current_level: 等级(1~6)
- },
- official: {
- type: -1无 0个人认证 1机构认证
- desc: 认证说明
- },
- vip: {
- vipType: 0非大会员 1大会员 2年度大会员
- }
- },
- content: {
- message: 评论内容
- emote: [ (表情符号信息)
- [某表情名称]: {
- text: "[某表情名称]",
- url: 表情URL
- meta: {
- size: 显示大小,1小 2大
- }
- }
- ]
- text: "[某表情名称]",
- },
- [某表情名称]: {
- replies: [
- { (某条回复)
- mid: UID
- ctime: 发布时间
- like: 点赞数
- member: { (同上) },
- content: {
- message: 回复内容
- emote: (表情符号信息,同上)
- }
- }
- content: {
- ]
- }
- { (某条回复)
- ],
- hots: 热评列表,格式同上,不能翻页,最多10条,没有热评时为null
- upper: {
- mid: UP主UID
- }
- }
- }
- { (某条评论)
- page: {
- data: {