Skip to content

Latest commit

 

History

History
679 lines (558 loc) · 29.7 KB

info.md

File metadata and controls

679 lines (558 loc) · 29.7 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:稿件不可见
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
		}
	}, 
	…………
	]
}