# 视频基本信息

<img src="/imgs/ploading.gif" width="100" height="100"/>

## 获取视频详细信息（web端）

> http://api.bilibili.com/x/web-interface/view

*请求方式：GET*

认证方式：Cookie（SESSDSTA）

限制游客访问的视频需要登录

**url参数：**

| 参数名 | 类型 | 内容     | 必要性       | 备注               |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid    | num  | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid   | str  | 稿件bvID | 必要（可选） | avID与bvID任选一个 |

**json回复：**

根对象：

| 字段    | 类型 | 内容     | 备注                                                         |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code    | num  | 返回值   | 0：成功<br />-400：请求错误<br />-403：权限不足<br />-404：无视频<br />62002：稿件不可见 |
| message | str  | 错误信息 | 默认为0                                                      |
| ttl     | num  | 1        |                                                              |
| data    | obj  | 信息本体 |                                                              |

`data`对象：

| 字段                            | 类型    | 内容                           | 备注                                                         |
| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ |
| bvid                            | str     | 稿件bvID                       |                                                              |
| aid                             | num     | 稿件avID                       |                                                              |
| videos                          | num     | 稿件分P总数                    | 默认为1                                                      |
| tid                             | num     | 分区tID                        |                                                              |
| tname                           | str     | 子分区名称                     |                                                              |
| copyright                       | num     | 是否转载                       | 1：原创<br />2：转载                                         |
| pic                             | str     | 稿件封面图片url                |                                                              |
| title                           | str     | 稿件标题                       |                                                              |
| pubdate                         | num     | 稿件发布时间                   | 时间戳                                                       |
| ctime                           | num     | 用户提交稿件的时间             | 时间戳                                                       |
| desc                            | str     | 视频简介                       |                                                              |
| state                           | num     | 视频状态                       | （PS：以下部分内容来源不明，有待验证）<br />0：开放浏览<br />1：橙色通过<br />-1：待审<br />-2：被打回<br />-3：网警锁定<br />-4：被锁定<br />-5：管理员锁定（可浏览）<br />-6：修复待审<br />-7：暂缓审核<br />-8：补档待审<br />-9：等待转码<br />-10：延迟审核<br />-11：视频源待修<br />-12：转储失败<br />-13：允许评论待审<br />-14：临时回收站<br />-15：分发中<br />-16：转码失败<br />-20：创建未提交<br />-30：创建已提交<br />-40：定时发布<br />-100：用户删除 |
| ~~attribute~~（仅做历史性保留） | ~~num~~ | ~~稿件属性位配置~~             | 本字段已被删除                                               |
| duration                        | num     | 稿件总时长（所有分P）          | 单位为秒                                                     |
| mission_id                      | num     | 稿件参与的活动ID               | 无为0                                                        |
| redirect_url                    | str     | 重定向url                      | 用于番剧及影视的av/bv->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   | 合作成员列表                   | 非合作视频无此项                                             |

`attribute`属性位二进制值表：

（PS：以下部分内容来源不明，有待验证，下表只做历史保留，无实际作用）

| 位   | 内容                   | 备注                                          |
| ---- | ---------------------- | --------------------------------------------- |
| 0    | 禁止排行               |                                               |
| 1    | 动态禁止               | 禁止APP推送动态                               |
| 2    | 禁止网页输出           |                                               |
| 3    | 禁止客户端列表         |                                               |
| 4    | 搜索禁止               |                                               |
| 5    | 海外禁止               |                                               |
| 6    | 禁止推荐               | 禁止被APP端天马列表推荐                       |
| 7    | 是否显示“禁止转载“标志 | **注：此位并非限制分享**                      |
| 8    | 是否高清               | 视频清晰度>=1080P                             |
| 9    | 是否PGC稿件            | 番剧&影视                                     |
| 10   | 允许承包               |                                               |
| 11   | 是否番剧               |                                               |
| 12   | 是否私单               | 存在商业推广恰饭内容                          |
| 13   | 是否限制地区           | 大多数番剧&影视                               |
| 14   | 禁止其他人添加TAG      |                                               |
| 15   | ？                     |                                               |
| 16   | 跳转                   | 番剧及影视av/bv->ep跳转                       |
| 17   | 是否影视               |                                               |
| 18   | 是否付费               |                                               |
| 19   | 推送动态               |                                               |
| 20   | 家长模式               |                                               |
| 21   | 是否限制游客和外链     | 部分视频未登录无法观看，且网页限制referer跳转 |
| 22   | ？                     |                                               |
| 23   | ？                     |                                               |
| 24   | 是否为联合投稿         |                                               |
| 25   | ？                     |                                               |
| 26   | ？                     |                                               |
| 27   | ？                     |                                               |
| 28   | ？                     |                                               |
| 29   | 是否为互动视频         |                                               |

`data`中的`rights`对象：

| 字段            | 类型 | 内容                   | 备注         |
| --------------- | ---- | ---------------------- | ------------ |
| bp              | num  | 0                      | 作用尚不明确 |
| elec            | num  | 是否支持充电           |              |
| download        | num  | 是否允许下载           |              |
| movie           | num  | 是否电影               |              |
| pay             | num  | 是否PGC付费            |              |
| hd5             | num  | 是否有高码率           |              |
| no_reprint      | num  | 是否显示“禁止转载“标志 |              |
| autoplay        | num  | 是否自动播放           |              |
| ugc_pay         | num  | 是否UGC付费            |              |
| is_cooperation  | num  | 是否为联合投稿         |              |
| ugc_pay_preview | num  | 0                      | 作用尚不明确 |
| no_background   | num  | 0                      | 作用尚不明确 |

`data`中的`owner`对象：

| 字段 | 类型 | 内容     | 备注 |
| ---- | ---- | -------- | ---- |
| mid  | num  | UP主UID  |      |
| name | str  | UP主昵称 |      |
| face | str  | UP主头像 |      |

`data`中的`stat`对象：

| 字段       | 类型 | 内容         | 备注    |
| ---------- | ---- | ------------ | ------- |
| aid        | num  | 稿件avID     |         |
| view       | num  | 播放数       |         |
| danmaku    | num  | 弹幕数       |         |
| reply      | num  | 评论数       |         |
| favorite   | num  | 收藏数       |         |
| coin       | num  | 投币数       |         |
| share      | num  | 分享数       |         |
| now_rank   | num  | 当前排名     |         |
| his_rank   | num  | 历史最高排行 |         |
| like       | num  | 获赞数       |         |
| dislike    | num  | 点踩数       | 恒为`0` |
| evaluation | str  | 视频评分     |         |

`data`中的`pages`数组：

| 项   | 类型 | 内容       | 备注          |
| ---- | ---- | ---------- | ------------- |
| 0    | obj  | 1P内容     | 无分P仅有此项 |
| n    | obj  | (n+1)P内容 |               |
| ……   | obj  | ……         | ……            |

`pages`数组中的对象：

| 字段      | 类型 | 内容            | 备注                                                      |
| --------- | ---- | --------------- | --------------------------------------------------------- |
| cid       | num  | 当前分P CID     |                                                           |
| page      | num  | 当前分P         |                                                           |
| from      | str  | 视频来源        | vupload：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part      | str  | 当前分P标题     |                                                           |
| duration  | num  | 当前分P持续时间 | 单位为秒                                                  |
| vid       | str  | 站外视频vid     | 仅站外视频有效                                            |
| weblink   | str  | 站外视频跳转url | 仅站外视频有效                                            |
| dimension | obj  | 当前分P分辨率   | 部分较老视频无分辨率值                                    |

`pages`数组中的对象中的`dimension`对象(同`data`中的`dimension`对象)：

| 字段   | 类型 | 内容           | 备注                 |
| ------ | ---- | -------------- | -------------------- |
| width  | num  | 当前分P 宽度   |                      |
| height | num  | 当前分P 高度   |                      |
| rotate | num  | 是否将宽高对换 | 0：正常<br />1：对换 |

`subtitle`对象：

| 字段         | 类型  | 内容             | 备注 |
| ------------ | ----- | ---------------- | ---- |
| allow_submit | bool  | 是否允许提交字幕 |      |
| list         | array | 字幕列表         |      |

`subtitle`对象中的`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  | json格式字幕文件url |      |
| author       | obj  | 字幕上传者信息      |      |

`list`数组中的对象中的`author`对象：

| 字段            | 类型 | 内容              | 备注         |
| --------------- | ---- | ----------------- | ------------ |
| mid             | num  | 字幕上传者UID     |              |
| name            | str  | 字幕上传者昵称    |              |
| sex             | str  | 字幕上传者性别    | 男 女 保密   |
| face            | str  | 字幕上传者头像url |              |
| 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    |      |
| vip      | obj  | 成员大会员状态 |      |
| official | obj  | 成员认证信息   |      |
| follower | num  | 成员粉丝数     |      |

`staff`数组中的对象中的`vip`对象：

| 字段       | 类型 | 内容         | 备注                                |
| ---------- | ---- | ------------ | ----------------------------------- |
| type       | num  | 成员会员类型 | 0：无<br />1：月会员<br />2：年会员 |
| status     | num  | 会员状态     | 0：无<br />1：有                    |
| theme_type | num  | 0            |                                     |

`staff`数组中的对象中的`official`对象：

| 字段  | 类型 | 内容         | 备注                                            |
| ----- | ---- | ------------ | ----------------------------------------------- |
| role  | num  | 成员认证级别 | 0：无<br />1 2：个人认证<br />3 4 5 6：机构认证 |
| title | str  | 成员认证名   | 无为空                                          |
| desc  | str  | 成员认证备注 | 无为空                                          |
| type  | num  | 成员认证类型 | -1：无<br />0：有                               |

**示例：**

获取视频`av85440373`/`BV117411r7R1`的基本信息

avID方式：

```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \
--data-urlencode 'aid=85440373'
```

bvID方式：

```shell
curl -G 'http://api.bilibili.com/x/web-interface/view' \
--data-urlencode 'bvid=BV117411r7R1'
```

<details>
<summary>查看响应示例：</summary>

```json
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"bvid": "BV117411r7R1",
		"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://i2.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg"
		},
		"stat": {
			"aid": 85440373,
			"view": 1419319,
			"danmaku": 9203,
			"reply": 2519,
			"favorite": 49031,
			"coin": 57470,
			"share": 8120,
			"now_rank": 0,
			"his_rank": 55,
			"like": 118462,
			"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://i2.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": 369687,
			"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": 1452718,
			"label_style": 0
		}]
	}
}
```

</details>

视频标题为：`当我给拜年祭的快板加了电音配乐…`

视频分区为：`tid=28（音乐->原创音乐）`

视频时长：`486s`

视频发布时间：`2020/1/30 17:40:55`

视频投稿时间：`2020/1/28 19:51:3`

视频分P为：`1`

视频类型为：`1（原创）`

视频UP主为：`66606350（Crazy_Bucket）`

视频简介为：

`【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包装：破晓天`

视频状态为：`0（开放浏览）`

视频属性为： `显示“禁止转载“标志`、`高清`、`禁止其他人添加TAG`、`联合投稿视频`

视频封面为：

http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg

![](http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg)



## 获取视频简介

> http://api.bilibili.com/x/web-interface/archive/desc

*请求方式：GET*

**url参数：**

| 参数名 | 类型 | 内容     | 必要性       | 备注               |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid    | num  | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid   | str  | 稿件bvID | 必要（可选） | avID与bvID任选一个 |

**json回复：**

根对象：

| 字段    | 类型 | 内容     | 备注                                               |
| ------- | ---- | -------- | -------------------------------------------------- |
| code    | num  | 返回值   | 0：成功<br />-400：请求错误<br />62002：稿件不可见 |
| message | str  | 错误信息 | 默认为0                                            |
| ttl     | num  | 1        |                                                    |
| data    | str  | 简介内容 |                                                    |

**示例：**

查看视频~~（教主的咕鸽）~~`av39330059`/`BV1Bt411z799`的简介

avID方式：

```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \
--data-urlencode 'aid=39330059'
```

bvID方式：

```shell
curl -G 'http://api.bilibili.com/x/archive/desc' \
--data-urlencode 'bvid=BV1Bt411z799'
```

<details>
<summary>查看响应示例：</summary>

```json
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": "1.小朋友们大家好，我是你们爷爷最喜欢的超威一列姆！\r\n2.在过去的一年里，我创作了无数脍炙人口的歌曲，常常被人夸赞高产似雌豚。\r\n3.接下来的日子里我会一如既往地勤勉创作，争取继续保持现在的产量，文体两开花。\r\n4.我感觉照这个势头和速度下去别说日常更新不在话下，连出张新专辑都指日可待了啊。\r\n5.也感谢你们一如既往的支持和鼓励，我会注意身体，不把自己累垮掉的。\r\n6.我个人不建议你们在评论区里艾特任何UP主，我真的不建议，当然你们非要这么做我也没办法的。"
}
```

</details>

## 查询视频分P列表  (avID/bvID转CID)

> http://api.bilibili.com/x/player/pagelist

*请求方式：GET*

**url参数：**

| 参数名 | 类型 | 内容     | 必要性       | 备注               |
| ------ | ---- | -------- | ------------ | ------------------ |
| aid    | num  | 稿件avID | 必要（可选） | avID与bvID任选一个 |
| bvid   | str  | 稿件bvID | 必要（可选） | avID与bvID任选一个 |

**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：普通上传（B站）<br />hunan：芒果TV<br />qq：腾讯 |
| part      | str  | 当前分P标题     |                                                           |
| duration  | num  | 当前分P持续时间 | 单位为秒                                                  |
| vid       | str  | 站外视频vid     |                                                           |
| weblink   | str  | 站外视频跳转url |                                                           |
| dimension | obj  | 当前分P分辨率   | 有部分视频无法获取分辨率                                  |

数组`data`中的对象中的`dimension`对象：

| 字段   | 类型 | 内容           | 备注                 |
| ------ | ---- | -------------- | -------------------- |
| width  | num  | 当前分P 宽度   |                      |
| height | num  | 当前分P 高度   |                      |
| rotate | num  | 是否将宽高对换 | 0：正常<br />1：对换 |

**示例：**

查询视频`av13502509`/`BV1ex411J7GE`的分P列表

avID方式：

```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \
--data-urlencode 'aid=13502509'
```

bvID方式：

```shell
curl -G 'http://api.bilibili.com/x/player/pagelist' \
--data-urlencode 'bvid=BV1ex411J7GE'
```

<details>
<summary>查看响应示例：</summary>

```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
		}
	}, 
	…………
	]
}
```

</details>