bilibili-API-collect/video/info.md

视频基本信息

• 获取视频详细信息（web端）
• 获取视频简介
• 查询视频分P列表 (avID/bvID转CID)

---

获取视频详细信息（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：成功 -400：请求错误 -403：权限不足 -404：无视频 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：原创 2：转载
pic	str	稿件封面图片url
title	str	稿件标题
pubdate	num	稿件发布时间	时间戳
ctime	num	用户投稿时间	时间戳
desc	str	视频简介
state	num	视频状态	详情见下表
attribute（已经弃用）	num	稿件属性位配置	详情见下表
duration	num	稿件总时长（所有分P）	单位为秒
forward	num	撞车视频跳转avid	仅撞车视频存在此字段
mission_id	num	稿件参与的活动ID
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	合作成员列表	非合作视频无此项
user_garb	obj	用户装扮信息

attribute字段属性位二进制值表：

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

位	内容	备注
0	禁止排行
1	动态禁止	禁止APP推送动态
2	禁止网页输出
3	禁止客户端列表
4	搜索禁止	打全标题或av/bv号都搜索不到的那种
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跳转，但第二种未登录无法访问，可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断
22	？
23	？
24	是否为联合投稿
25	？
26	？
27	？
28	？
29	是否为互动视频

state字段值：

（PS：以下部分内容来源不明，且部分值前端不可见，有待验证）

值	内容	备注
1	橙色通过
0	开放浏览
-1	待审
-2	被打回
-3	网警锁定
-4	被锁定	视频撞车了
-5	管理员锁定
-6	修复待审
-7	暂缓审核
-8	补档待审
-9	等待转码
-10	延迟审核
-11	视频源待修
-12	转储失败
-13	允许评论待审
-14	临时回收站
-15	分发中
-16	转码失败
-20	创建未提交
-30	创建已提交
-40	定时发布
-100	用户删除

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_stein_gate	num	是否为互动视频
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站） hunan：芒果TV 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：正常 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：无 1：月会员 2：年会员
status	num	会员状态	0：无 1：有
theme_type	num	0

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

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

data中的user_garb对象：

字段	类型	内容	备注
url_image_ani_cut	str	某url？

示例：

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

avID方式：

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

bvID方式：

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

查看响应示例：

{
    "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,
        "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,
            "clean_mode": 0,
            "is_stein_gate": 0
        },
        "owner": {
            "mid": 66606350,
            "name": "Crazy_Bucket",
            "face": "http://i2.hdslb.com/bfs/face/c9af3b32cf74baec5a4b65af8ca18ae5ff571f77.jpg"
        },
        "stat": {
            "aid": 85440373,
            "view": 1936852,
            "danmaku": 11189,
            "reply": 2626,
            "favorite": 56572,
            "coin": 66857,
            "share": 9032,
            "now_rank": 0,
            "his_rank": 55,
            "like": 142449,
            "dislike": 0,
            "evaluation": "",
            "argue_msg": ""
        },
        "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/c9af3b32cf74baec5a4b65af8ca18ae5ff571f77.jpg",
                "vip": {
                    "type": 2,
                    "status": 1,
                    "vip_pay_type": 0,
                    "theme_type": 0
                },
                "official": {
                    "role": 2,
                    "title": "bilibili 知名音乐UP主",
                    "desc": "",
                    "type": 0
                },
                "follower": 628808,
                "label_style": 0
            },
            {
                "mid": 53456,
                "title": "曲绘",
                "name": "Warma",
                "face": "http://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
                "vip": {
                    "type": 2,
                    "status": 1,
                    "vip_pay_type": 0,
                    "theme_type": 0
                },
                "official": {
                    "role": 1,
                    "title": "bilibili 知名UP主",
                    "desc": "",
                    "type": 0
                },
                "follower": 2268492,
                "label_style": 0
            }
        ],
        "user_garb": {
            "url_image_ani_cut": ""
        }
    }
}

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

视频分区为：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://api.bilibili.com/x/web-interface/archive/desc

请求方式：GET

url参数：

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

json回复：

根对象：

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

示例：

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

avID方式：

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

bvID方式：

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

查看响应示例：

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

查询视频分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：成功 -400：请求错误 -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站） hunan：芒果TV 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：正常 1：对换

示例：

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

avID方式：

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

bvID方式：

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

查看响应示例：

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