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

6.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 合集内视频数量

示例:

获取 mid=37737161season_id=1227671 视频合集信息,默认排序,第 1 页,每页 30 个视频

curl -G "https://api.bilibili.com/x/polymer/space/seasons_archives_list" \
--data-urlencode "mid=37737161" \
--data-urlencode "sort_reverse=false" \
--data-urlencode "season_id=1227671" \
--data-urlencode "page_num=1" \
--data-urlencode "page_size=30"
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aids": [
      311606079,
      400546145
    ],
    "archives": [
      {
        "aid": 311606079,
        "bvid": "BV1XN411K7g9",
        "ctime": 1679651747,
        "duration": 261,
        "interactive_video": false,
        "pic": "http://i2.hdslb.com/bfs/archive/234e6bd061176dba9e148f4373c52fa7cd2d801f.jpg",
        "pubdate": 1679651747,
        "stat": {
          "view": 12145
        },
        "state": 0,
        "title": "某些IT社区平台乱象文章千篇一律毫不注重版权文章互相抄袭成潮流希望能够好好管管",
        "ugc_pay": 0
      },
      {
        "aid": 400546145,
        "bvid": "BV1qo4y1L73P",
        "ctime": 1682777426,
        "duration": 335,
        "interactive_video": false,
        "pic": "http://i2.hdslb.com/bfs/archive/a6b6fb0330bbf6c500720a024e5a9ade24d888c3.jpg",
        "pubdate": 1682777425,
        "stat": {
          "view": 52743
        },
        "state": 0,
        "title": "某些搜索引擎得到的结果,官方网站反而排在一些诈骗广告后面,诱导用户下载大量捆绑垃圾软件",
        "ugc_pay": 0
      }
    ],
    "meta": {
      "category": 0,
      "cover": "https://archive.biliimg.com/bfs/archive/5e1c1f77c3065ec31eec43d7e35f7a061602e4d6.jpg",
      "description": "白马首席讲师吐槽系列视频",
      "mid": 37737161,
      "name": "水浅王八多,真假白马说",
      "ptime": 1682777425,
      "season_id": 1227671,
      "total": 2
    },
    "page": {
      "page_num": 1,
      "page_size": 30,
      "total": 2
    }
  }
}