哔哩哔哩-API收集整理：视频合集管理接口调用教程
在哔哩哔哩（Bilibili）平台上，视频创作者和开发者经常需要通过API接口来管理视频合集。本教程将详细介绍如何调用哔哩哔哩的视频合集管理接口，帮助你轻松实现合集的创建、查询和更新等操作。
合集与视频列表的区别
在开始使用接口之前，首先需要明确合集(seasons_archives) 和视频列表(seasons_series) 的区别。合集是后加入的功能，图标为立体叠放的正方形(.icon-heji)，可以在创作中心管理，参见 合集管理。列表即系列(series)或频道(channel)，图标为平面叠放的矩形且中央有播放按钮标识(.icon-ic_channel1)，在个人空间直接操作。
获取视频合集信息
要获取视频合集信息，我们可以使用以下接口：
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 签名 |
示例代码
获取 mid=37737161 的 season_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
}
}
}
只获取系列视频
如果只想获取系列视频，可以使用以下接口：
https://api.bilibili.com/x/polymer/web-space/home/seasons_series
请求方式
GET
URL参数
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| mid | num | 用户 mid | 必要 | |
| page_num | num | 页码索引 | 必要 | |
| page_size | num | 单页内容数量 | 必要 | |
| gaia_vtoken | str | 风控验证? | 可选 | 若被风控则必要(如User-Agent不正常) |
| w_rid | str | WBI 签名 | 不必要 | 参见 WBI 签名 |
| wts | num | UNIX 秒级时间戳 | 不必要 | 参见 WBI 签名 |
示例代码
curl -G "https://api.bilibili.com/x/polymer/web-space/home/seasons_series" \
--data-urlencode "mid=37737161" \
--data-urlencode "page_num=1" \
--data-urlencode "page_size=10"
响应示例
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"items_lists": {
"page": {
"page_num": 1,
"page_size": 10,
"total": 1
},
"seasons_list": [],
"series_list": [
{
"archives": [
{
"aid": 284063097,
"bvid": "BV1Fc411x7xF",
"ctime": 1705925782,
"duration": 8885,
"enable_vt": false,
"interactive_video": false,
"pic": "http://i0.hdslb.com/bfs/archive/5aa1bb0a121d89969e9bd2634bc7ae23272bf850.jpg",
"playback_position": 0,
"pubdate": 1705925781,
"stat": {
"view": 14683,
"vt": 0
},
"state": 0,
"title": "Gradle 教程 已完结 (基于Kotlin DSL讲解) 4K蓝光画质 超强的脚本式项目依赖和构建工具",
"ugc_pay": 0,
"vt_display": ""
},
{
"aid": 367948632,
"bvid": "BV1P94y1c7tV",
"ctime": 1703844221,
"duration": 52036,
"enable_vt": false,
"interactive_video": false,
"pic": "http://i2.hdslb.com/bfs/archive/499aeb41a0428e05523b766e367540b04f7c3ae2.jpg",
"playback_position": 0,
"pubdate": 1703844220,
"stat": {
"view": 82997,
"vt": 0
},
"state": 0,
"title": "Kotlin 教程 已完结 (IDEA 2024 最新版) 4K蓝光画质+杜比音效 零基础入门一套搞定 入门到精通经典版",
"ugc_pay": 0,
"vt_display": ""
},
{
"aid": 836303388,
"bvid": "BV1Hg4y1m7Ca",
"ctime": 1705401362,
"duration": 5873,
"enable_vt": false,
"interactive_video": false,
"pic": "http://i1.hdslb.com/bfs/archive/a20b09d1cc1a81f6a9c5ed8ea322656e406be725.jpg",
"playback_position": 0,
"pubdate": 1705401362,
"stat": {
"view": 8417,
"vt": 0
},
"state": 0,
"title": "Kotlin 扩展篇 已完结 (IDEA 2024 最新版) 4K蓝光画质 与Java语言混合编程",
"ugc_pay": 0,
"vt_display": ""
}
],
"meta": {
"category": 1,
"cover": "http://i0.hdslb.com/bfs/archive/5aa1bb0a121d89969e9bd2634bc7ae23272bf850.jpg",
"creator": "auto",
"ctime": 1705401630,
"description": "包含Kotlin语言学习的完整流程，正在不断完善中哦~",
"keywords": [
"Kotlin"
],
"last_update_ts": 1705925782,
"mid": 37737161,
"mtime": 1705925782,
"name": "Kotlin开心路线",
"raw_keywords": "Kotlin",
"series_id": 3908327,
"state": 2,
"total": 3
},
"recent_aids": [
284063097,
367948632,
836303388
]
}
]
}
}
}
总结
通过本教程，你已经了解了如何调用哔哩哔哩的视频合集管理接口，包括获取视频合集信息和只获取系列视频。希望这些内容能够帮助你更好地管理哔哩哔哩上的视频合集。如果你想了解更多关于哔哩哔哩API的信息，可以查阅 官方文档。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
