bilibili-API-collect/docs/video/collection.md

4.1 KiB
Raw Blame History

合集和视频列表信息

获取视频合集信息

https://api.bilibili.com/x/polymer/web-space/seasons_archives_list (需验证referer)

https://api.bilibili.com/x/polymer/space/seasons_archives_list (旧接口, 无鉴权验证)

请求方式GET

url参数

参数名 类型 内容 必要性 备注
mid num 用户 mid 必要 创建者的 mid但也可以是任意的非负整数
season_id num 视频合集 ID 必要
sort_reverse bool 排序方式 可选 true: 升序排序
false: 默认排序
page_num num 页码索引 可选 默认为 1
page_size num 单页内容数量 可选 默认为 30
gaia_vtoken str 风控验证? 可选 若被风控则必要(如User-Agent不正常)
web_location str 页面位置? 可选 333.999
w_rid str WBI 签名 可选 参见 WBI 签名
wts num UNIX 秒级时间戳 可选 参见 WBI 签名

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
aids array 稿件 avid 列表 对应下方数组中内容 aid
archives array 合集中的视频
meta obj 合集元数据
page obj 分页信息

data中的archives数组:

类型 内容 备注
0 obj 合集内容
n obj (n+1)P内容
…… obj …… ……

archives数组中的对象:

字段 类型 内容 备注
aid num 稿件 avid
bvid str 稿件 bvid
ctime num 创建时间 Unix 时间戳
duration num 视频时长 单位为秒
enable_vt bool false 旧接口无
interactive_video bool 是否是互动视频
pic str 封面 URL
playback_position num 会随着播放时间增长,播放完成后为 -1 。单位未知
pubdate num 发布日期 Unix 时间戳
stat obj 稿件信息
state num 0
title str 稿件标题
ugc_pay num UGC 付费? 0: 否
vt_display str 旧接口无

archives中的stat对象:

字段 类型 内容 备注
view num 稿件播放量
vt num 0

data中的meta对象:

字段 类型 内容 备注
category num 0
cover str 合集封面 URL
description str 合集描述
mid num UP 主 ID
name str 合集标题
ptime num 发布时间 Unix 时间戳
season_id num 合集 ID
total num 合集内视频数量

data中的page对象:

字段 类型 内容 备注
page_num num 分页页码
page_size num 单页个数
total num 合集内视频数量