mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-03-12 09:20:08 +08:00
502 lines
19 KiB
Markdown
502 lines
19 KiB
Markdown
# 视频基本信息
|
||
|
||
<img src="/imgs/ploading.gif" width="100" height="100"/>
|
||
|
||
## 视频详细信息
|
||
|
||
api.bilibili.com/x/web-interface/view
|
||
|
||
*方式:GET*
|
||
|
||
参数：
|
||
|
||
| 参数名 | 内容 | 必要性 | 备注 |
|
||
| ------ | -------- | ------ | ---- |
|
||
| aid | 视频avID | 必要 | |
|
||
|
||
**json回复：**
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | --------------------------------------- |
|
||
| code | num | 返回值 | 0成功<br />-400请求错误<br />-404无视频 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | 作用尚不明确 |
|
||
| data | obj | 信息本体 | |
|
||
|
||
data 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ----- | ------------------------------ | --------------------- |
|
||
| bvid | str | 空 | 作用尚不明确 |
|
||
| aid | num | 视频avID | |
|
||
| videos | num | 视频分P总数 | 默认为1 |
|
||
| tid | num | 分区ID | |
|
||
| tname | str | 子分区名称 | |
|
||
| copyright | num | 版权标志 | 1自制<br />2转载 |
|
||
| pic | str | 视频封面图片url | jpg gif |
|
||
| title | str | 视频标题 | |
|
||
| pubdate | num | 视频上传时间 | 时间戳 |
|
||
| ctime | num | 视频审核通过时间 | 时间戳 |
|
||
| desc | str | 视频简介 | |
|
||
| state | num | 0 | 作用尚不明确 |
|
||
| attribute | num | | 作用尚不明确 |
|
||
| duration | num | 视频总计持续时长（所有分P） | 单位为秒 |
|
||
| mission_id | num | 视频参与的活动ID | 无为0 |
|
||
| redirect_url | str | 重定向url | 用于番剧 影视的av->ep |
|
||
| rights | obj | 视频属性标志 | |
|
||
| owner | obj | 视频UP主信息 | |
|
||
| stat | obj | 视频状态数 | |
|
||
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
|
||
| cid | num | 视频1P CID | |
|
||
| dimension | obj | 视频1P分辨率 | |
|
||
| no_cache | bool | true | 作用尚不明确 |
|
||
| pages | array | 视频分P列表 | |
|
||
| subtitle | obj | 视频CC字幕 | |
|
||
| staff | array | 合作成员列表 | 可不存在 |
|
||
|
||
rights 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------------- | ---- | ---------------- | ------------------------------------ |
|
||
| bp | num | 0 | 作用尚不明确 |
|
||
| elec | num | 0 | 作用尚不明确 |
|
||
| download | num | 允许下载标志 | 0不允许<br />1允许 |
|
||
| movie | num | 视频时电影标志 | 0否<br />1是 |
|
||
| pay | num | 仅会员可观看标志 | 0无<br />1有 |
|
||
| hd5 | num | 有高码率标志 | 0无<br />1有 |
|
||
| no_reprint | num | 禁止转载标志 | 0无<br />1禁止 |
|
||
| autoplay | num | 可自动播放标志 | 0无<br />1有 区别影视番剧与普通视频 |
|
||
| ugc_pay | num | 0 | 作用尚不明确 |
|
||
| is_cooperation | num | 视频合作标志 | 0无<br />1是 |
|
||
| ugc_pay_preview | num | 0 | 作用尚不明确 |
|
||
| no_background | num | 0 | 作用尚不明确 |
|
||
|
||
owner 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | -------- | ------- |
|
||
| mid | num | UP主UID | |
|
||
| name | str | UP主昵称 | |
|
||
| face | str | UP主头像 | jpg gif |
|
||
|
||
stat 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---------------------- | -------------------------------- | ------------ |
|
||
| aid | num | 视频avID | |
|
||
| view | 普通num<br />屏蔽时str | 普通：观看次数<br />屏蔽时："--" | |
|
||
| danmaku | num | 弹幕条数 | |
|
||
| reply | num | 评论条数 | |
|
||
| favorite | num | 收藏人数 | |
|
||
| coin | num | 投币枚数 | |
|
||
| share | num | 分享次数 | |
|
||
| now_rank | num | 0 | 作用尚不明确 |
|
||
| his_rank | num | 历史最高排行 | |
|
||
| like | num | 获赞次数 | |
|
||
| dislike | num | 0 | 作用尚不明确 |
|
||
| evaluation | str | 视频评分 | 默认为空 |
|
||
|
||
page 数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ---------- | ------------- |
|
||
| 0 | obj | 1P内容 | 无分P仅有此项 |
|
||
| n | obj | (n+1)P内容 | |
|
||
| …… | obj | …… | …… |
|
||
|
||
数组 page 中的所有项 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------- | ---- | --------------- | -------------------------------- |
|
||
| cid | num | 当前分P CID | |
|
||
| page | num | 当前分P | |
|
||
| from | str | 视频来源 | vupload用户上传<br />hunan芒果TV |
|
||
| part | str | 当前分P标题 | |
|
||
| duration | num | 当前分P持续时间 | 单位为秒 |
|
||
| vid | str | 空 | 作用尚不明确 |
|
||
| weblink | str | 空 | 作用尚不明确 |
|
||
| dimension | obj | 当前分P分辨率 | |
|
||
|
||
dimension 对象：(同data中的dimension对象)
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------ | ---- | ------------ | ------------ |
|
||
| width | num | 当前分P 宽度 | 可能为0 |
|
||
| height | num | 当前分P 高度 | 可能为0 |
|
||
| rotate | num | 0 | 作用尚不明确 |
|
||
|
||
subtitle 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ----- | ---------------- | ---- |
|
||
| allow_submit | bool | 是否允许提交字幕 | |
|
||
| list | array | 字幕列表 | |
|
||
|
||
list 数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | --------- | ---- |
|
||
| 0 | obj | 字幕1 | |
|
||
| n | obj | 字幕(n+1) | |
|
||
| …… | obj | …… | …… |
|
||
|
||
数组 list 中的所有项 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------------ | ---- | -------------- | -------- |
|
||
| id | num | 字幕ID | |
|
||
| lan | str | 字幕语言 | |
|
||
| lan_doc | str | 字幕语言名称 | |
|
||
| is_lock | bool | 是否锁定 | |
|
||
| author_mid | num | 字幕上传者UID | |
|
||
| subtitle_url | str | 字幕文件url | json格式 |
|
||
| author | obj | 字幕上传者信息 | |
|
||
|
||
author 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------------- | ---- | ----------------- | ------------ |
|
||
| mid | num | 字幕上传者UID | |
|
||
| name | str | 字幕上传者昵称 | |
|
||
| sex | str | 字幕上传者性别 | 男 女 保密 |
|
||
| face | str | 字幕上传者头像url | jpg gif |
|
||
| sign | str | 字幕上传者签名 | |
|
||
| rank | num | 10000 | 作用尚不明确 |
|
||
| birthday | num | 0 | 作用尚不明确 |
|
||
| is_fake_account | num | 0 | 作用尚不明确 |
|
||
| is_deleted | num | 0 | 作用尚不明确 |
|
||
|
||
staff 数组：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ------------- | ---- |
|
||
| 0 | obj | 合作成员1 | |
|
||
| n | obj | 合作成员(n+1) | |
|
||
| …… | obj | …… | …… |
|
||
|
||
数组 staff 中的所有项 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ---- | -------------- | ------- |
|
||
| mid | num | 成员UID | |
|
||
| title | str | 成员名称 | |
|
||
| name | str | 成员昵称 | |
|
||
| face | str | 成员头像url | jpg gif |
|
||
| vip | obj | 成员大会员状态 | |
|
||
| official | obj | 成员认证信息 | |
|
||
| follower | num | 成员粉丝数 | |
|
||
|
||
vip 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ---------- | ---- | ------------ | ------------------- |
|
||
| type | num | 成员会员类型 | 0无 1月会员 2年会员 |
|
||
| status | num | 会员状态 | 0无 1有 |
|
||
| theme_type | num | 0 | |
|
||
|
||
official 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------------ | ----------------------------------------- |
|
||
| role | num | 成员认证级别 | 0无<br />1 2个人认证<br />3 4 5 6机构认证 |
|
||
| title | str | 成员认证名 | 无为空 |
|
||
| desc | str | 成员认证备注 | 无为空 |
|
||
| type | num | 成员认证类型 | -1无<br />0有 |
|
||
|
||
示例：
|
||
|
||
http://api.bilibili.com/x/web-interface/view?aid=85440373
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"bvid": "",
|
||
"aid": 85440373,
|
||
"videos": 1,
|
||
"tid": 28,
|
||
"tname": "原创音乐",
|
||
"copyright": 1,
|
||
"pic": "http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg",
|
||
"title": "当我给拜年祭的快板加了电音配乐…",
|
||
"pubdate": 1580377255,
|
||
"ctime": 1580212263,
|
||
"desc": "【CB想说的】看完拜年祭之后最爱的一个节目！给有快板的部分简单加了一些不同风格的配乐hhh，感谢沃玛画的我！太可爱了哈哈哈哈哈哈哈！！！\n【Warma想说的】我画了打碟的CB，画风为了还原原版视频所以参考了四迹老师的画风，四迹老师的画真的太可爱啦！不过其实在画的过程中我遇到了一个问题，CB的耳机……到底是戴在哪个耳朵上呢？\n\n原版：av78977080\n编曲（配乐）：Crazy Bucket\n人声（配音）：Warma/谢拉\n曲绘：四迹/Warma\n动画：四迹/Crazy Bucket\n剧本：Mokurei-木灵君\n音频后期：DMYoung/纳兰寻风/Crazy Bucket\n包装：破晓天",
|
||
"state": 0,
|
||
"attribute": 16793984,
|
||
"duration": 486,
|
||
"mission_id": 11838,
|
||
"rights": {
|
||
"bp": 0,
|
||
"elec": 0,
|
||
"download": 1,
|
||
"movie": 0,
|
||
"pay": 0,
|
||
"hd5": 1,
|
||
"no_reprint": 1,
|
||
"autoplay": 1,
|
||
"ugc_pay": 0,
|
||
"is_cooperation": 1,
|
||
"ugc_pay_preview": 0,
|
||
"no_background": 0
|
||
},
|
||
"owner": {
|
||
"mid": 66606350,
|
||
"name": "Crazy_Bucket",
|
||
"face": "http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg"
|
||
},
|
||
"stat": {
|
||
"aid": 85440373,
|
||
"view": 1362470,
|
||
"danmaku": 8753,
|
||
"reply": 2489,
|
||
"favorite": 47970,
|
||
"coin": 55627,
|
||
"share": 7927,
|
||
"now_rank": 0,
|
||
"his_rank": 55,
|
||
"like": 115395,
|
||
"dislike": 0,
|
||
"evaluation": ""
|
||
},
|
||
"dynamic": "进来就出不去了！！！\n#全民音乐UP主##CB##warma##电音##快板##拜年祭##诸神的奥运##编曲##Remix#",
|
||
"cid": 146044693,
|
||
"dimension": {
|
||
"width": 1920,
|
||
"height": 1080,
|
||
"rotate": 0
|
||
},
|
||
"no_cache": false,
|
||
"pages": [{
|
||
"cid": 146044693,
|
||
"page": 1,
|
||
"from": "vupload",
|
||
"part": "建议改成：建议改成：诸 神 的 电 音 节（不是）",
|
||
"duration": 486,
|
||
"vid": "",
|
||
"weblink": "",
|
||
"dimension": {
|
||
"width": 1920,
|
||
"height": 1080,
|
||
"rotate": 0
|
||
}
|
||
}],
|
||
"subtitle": {
|
||
"allow_submit": false,
|
||
"list": []
|
||
},
|
||
"staff": [{
|
||
"mid": 66606350,
|
||
"title": "UP主",
|
||
"name": "Crazy_Bucket",
|
||
"face": "http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg",
|
||
"vip": {
|
||
"type": 2,
|
||
"status": 1,
|
||
"vip_pay_type": 0,
|
||
"theme_type": 0
|
||
},
|
||
"official": {
|
||
"role": 2,
|
||
"title": "bilibili 知名音乐UP主",
|
||
"desc": "",
|
||
"type": 0
|
||
},
|
||
"follower": 333883,
|
||
"label_style": 0
|
||
}, {
|
||
"mid": 53456,
|
||
"title": "曲绘",
|
||
"name": "Warma",
|
||
"face": "http://i0.hdslb.com/bfs/face/32a43710a69155a5a90441ebedb6c05b63d2fd98.jpg",
|
||
"vip": {
|
||
"type": 2,
|
||
"status": 1,
|
||
"vip_pay_type": 0,
|
||
"theme_type": 0
|
||
},
|
||
"official": {
|
||
"role": 1,
|
||
"title": "bilibili 知名UP主",
|
||
"desc": "",
|
||
"type": 0
|
||
},
|
||
"follower": 1398071,
|
||
"label_style": 0
|
||
}]
|
||
}
|
||
}
|
||
```
|
||
|
||
可得出视频封面为：**（可用于封面提取）**
|
||
|
||
http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg
|
||
|
||
|
||
|
||
UP主头像为：
|
||
|
||
http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
|
||
|
||
<img src="http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg" align="left" width="100" height="100" />
|
||
|
||
|
||
|
||
## 视频简介
|
||
|
||
api.bilibili.com/x/web-interface/archive/desc
|
||
|
||
*方式:GET*
|
||
|
||
参数：
|
||
|
||
| 参数名 | 内容 | 必要性 | 备注 |
|
||
| ------ | -------- | ------ | ---- |
|
||
| aid | 视频avID | 必要 | |
|
||
|
||
**json回复：**
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ---- | -------- | -------------------------------------------- |
|
||
| code | num | 返回值 | 0成功<br />-400请求错误<br />62002稿件不可见 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | 作用尚不明确 |
|
||
| data | str | 简介内容 | |
|
||
|
||
示例：
|
||
|
||
http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
|
||
|
||
~~（教主的咕鸽）~~
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": "1.小朋友们大家好，我是你们爷爷最喜欢的超威一列姆！\r\n2.在过去的一年里，我创作了无数脍炙人口的歌曲，常常被人夸赞高产似雌豚。\r\n3.接下来的日子里我会一如既往地勤勉创作，争取继续保持现在的产量，文体两开花。\r\n4.我感觉照这个势头和速度下去别说日常更新不在话下，连出张新专辑都指日可待了啊。\r\n5.也感谢你们一如既往的支持和鼓励，我会注意身体，不把自己累垮掉的。\r\n6.我个人不建议你们在评论区里艾特任何UP主，我真的不建议，当然你们非要这么做我也没办法的。"
|
||
}
|
||
```
|
||
|
||
## 视频分P列表 (avID转CID)
|
||
|
||
api.bilibili.com/x/player/pagelist
|
||
|
||
*方式:GET*
|
||
|
||
参数：
|
||
|
||
| 参数名 | 内容 | 必要性 | 备注 |
|
||
| ------ | -------- | ------ | ---- |
|
||
| aid | 视频avID | 必要 | |
|
||
|
||
**json回复：**
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------- | ----- | -------- | --------------------------------------- |
|
||
| code | num | 返回值 | 0成功<br />-400请求错误<br />-404无视频 |
|
||
| message | str | 错误信息 | 默认为0 |
|
||
| ttl | num | 1 | 作用尚不明确 |
|
||
| data | array | 分P列表 | |
|
||
|
||
数组 data：
|
||
|
||
| 项 | 类型 | 内容 | 备注 |
|
||
| ---- | ---- | ---------- | ------------- |
|
||
| 0 | obj | 1P内容 | 无分P仅有此项 |
|
||
| n | obj | (n+1)P内容 | |
|
||
| …… | obj | …… | …… |
|
||
|
||
数组 data 中的所有项 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| --------- | ---- | --------------- | -------------------------------- |
|
||
| cid | num | 当前分P CID | |
|
||
| page | num | 当前分P | |
|
||
| from | str | 视频来源 | vupload用户上传<br />hunan芒果TV |
|
||
| part | str | 当前分P标题 | |
|
||
| duration | num | 当前分P持续时间 | 单位为秒 |
|
||
| vid | str | 空 | 作用尚不明确 |
|
||
| weblink | str | 空 | 作用尚不明确 |
|
||
| dimension | obj | 当前分P分辨率 | |
|
||
|
||
dimension 对象：
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ------ | ---- | ------------ | ------------ |
|
||
| width | num | 当前分P 宽度 | 可能为0 |
|
||
| height | num | 当前分P 高度 | 可能为0 |
|
||
| rotate | num | 0 | 作用尚不明确 |
|
||
|
||
示例：（后面省略）
|
||
|
||
http://api.bilibili.com/x/player/pagelist?aid=13502509
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": [{
|
||
"cid": 66445301,
|
||
"page": 1,
|
||
"from": "vupload",
|
||
"part": "00. 宣传短片",
|
||
"duration": 33,
|
||
"vid": "",
|
||
"weblink": "",
|
||
"dimension": {
|
||
"width": 1920,
|
||
"height": 1080,
|
||
"rotate": 0
|
||
}
|
||
}, {
|
||
"cid": 35039663,
|
||
"page": 2,
|
||
"from": "vupload",
|
||
"part": "01. 火柴人与动画师",
|
||
"duration": 133,
|
||
"vid": "",
|
||
"weblink": "",
|
||
"dimension": {
|
||
"width": 1484,
|
||
"height": 1080,
|
||
"rotate": 0
|
||
}
|
||
}, {
|
||
"cid": 35039678,
|
||
"page": 3,
|
||
"from": "vupload",
|
||
"part": "02. 火柴人与动画师 II",
|
||
"duration": 210,
|
||
"vid": "",
|
||
"weblink": "",
|
||
"dimension": {
|
||
"width": 1484,
|
||
"height": 1080,
|
||
"rotate": 0
|
||
}
|
||
}, {
|
||
"cid": 35039693,
|
||
"page": 4,
|
||
"from": "vupload",
|
||
"part": "03. 火柴人与动画师 III",
|
||
"duration": 503,
|
||
"vid": "",
|
||
"weblink": "",
|
||
"dimension": {
|
||
"width": 992,
|
||
"height": 720,
|
||
"rotate": 0
|
||
}
|
||
},
|
||
…………
|
||
]
|
||
}
|
||
```
|
||
|
||
|
||
|