Skip to content

Latest commit

 

History

History
550 lines (456 loc) · 20.7 KB

info.md

File metadata and controls

550 lines (456 loc) · 20.7 KB
Raw

视频基本信息

获取视频详细信息（avID/bvID互转及转epID）

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

请求方式：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 obj 信息本体

data对象：

字段 类型 内容 备注
bvid str 视频bvID
aid num 视频avID
videos num 视频分P总数 默认为1
tid num 分区ID
tname str 子分区名称
copyright num 版权标志 1：自制
2：转载
pic str 视频封面图片url
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 合作成员列表 可不存在

data中的rights对象：

字段 类型 内容 备注
bp num 0 作用尚不明确
elec num 0 作用尚不明确
download num 允许下载标志 0：不允许
1：允许
movie num 视频时电影标志 0：否
1：是
pay num 仅会员可观看标志 0：无
1：有
hd5 num 有高码率标志 0：无
1：有
no_reprint num 禁止转载标志 0：无
1：禁止
autoplay num 可自动播放标志 0：无
1：有 区别影视番剧与普通视频
ugc_pay num 0 作用尚不明确
is_cooperation num 视频合作标志 0：无
1：是
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 普通：观看次数
屏蔽时：-1
danmaku num 弹幕条数
reply num 评论条数
favorite num 收藏人数
coin num 投币枚数
share num 分享次数
now_rank num 0 作用尚不明确
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：普通上传
hunan：芒果TV
part str 当前分P标题
duration num 当前分P持续时间 单位为秒
vid str 空 作用尚不明确
weblink str 空 作用尚不明确
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：有

示例：

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

可得出视频封面为：（可用于封面提取）

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

UP主头像为：

http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.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：普通上传
hunan：芒果TV
part str 当前分P标题
duration num 当前分P持续时间 单位为秒
vid str 空 作用尚不明确
weblink str 空 作用尚不明确
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
		}
	}, 
	…………
	]
}