Skip to content

Latest commit

 

History

History
660 lines (545 loc) · 28 KB

info.md

File metadata and controls

660 lines (545 loc) · 28 KB

视频基本信息


获取视频详细信息(web端)

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

请求方式:GET

认证方式:Cookie(SESSDATA)

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

url参数:

参数名 类型 内容 必要性 备注
aid num 稿件avid 必要(可选) avid与bvid任选一个
bvid str 稿件bvid 必要(可选) avid与bvid任选一个

json回复:

根对象:

字段 类型 内容 备注
code num 返回值 0:成功
-400:请求错误
-403:权限不足
-404:无视频
62002:稿件不可见
62004:稿件审核中
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 视频简介
desc_v2 array 新版视频简介
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 用户装扮信息

data中的desc_v2数组:

类型 内容 备注
0 obj 新版简介内容

desc_v2数组中的对象:

字段 类型 内容 备注
raw_text num 简介内容
type num ?
biz_id num ?

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主mid
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 视频评分
argue_msg 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 字幕上传者mid
subtitle_url str json格式字幕文件url
author obj 字幕上传者信息

list数组中的对象中的author对象:

字段 类型 内容 备注
mid num 字幕上传者mid
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 成员mid
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 7:个人认证
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包装:破晓天",
        "desc_v2": [
            {
                "raw_text": "【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包装:破晓天",
                "type": 1,
                "biz_id": 0
            }
        ],
        "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": 2087084,
            "danmaku": 11495,
            "reply": 2669,
            "favorite": 58113,
            "coin": 68710,
            "share": 9190,
            "now_rank": 0,
            "his_rank": 55,
            "like": 148621,
            "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,
                    "due_date": 1642694400000,
                    "vip_pay_type": 1,
                    "theme_type": 0,
                    "label": {
                        "path": "",
                        "text": "年度大会员",
                        "label_theme": "annual_vip",
                        "text_color": "#FFFFFF",
                        "bg_style": 1,
                        "bg_color": "#FB7299",
                        "border_color": ""
                    },
                    "avatar_subscript": 1,
                    "nickname_color": "#FB7299",
                    "role": 3,
                    "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
                },
                "official": {
                    "role": 2,
                    "title": "bilibili 知名音乐UP主",
                    "desc": "",
                    "type": 0
                },
                "follower": 662460,
                "label_style": 0
            },
            {
                "mid": 53456,
                "title": "曲绘",
                "name": "Warma",
                "face": "http://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
                "vip": {
                    "type": 2,
                    "status": 1,
                    "due_date": 1637424000000,
                    "vip_pay_type": 0,
                    "theme_type": 0,
                    "label": {
                        "path": "",
                        "text": "年度大会员",
                        "label_theme": "annual_vip",
                        "text_color": "#FFFFFF",
                        "bg_style": 1,
                        "bg_color": "#FB7299",
                        "border_color": ""
                    },
                    "avatar_subscript": 1,
                    "nickname_color": "#FB7299",
                    "role": 3,
                    "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
                },
                "official": {
                    "role": 1,
                    "title": "bilibili 知名UP主",
                    "desc": "",
                    "type": 0
                },
                "follower": 2655737,
                "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
		}
	}, 
	…………
	]
}