B站视频合集详情接口详解：哔哩哔哩-API收集整理中的系列内容展示
在B站内容生态中，视频合集（Collection）是UP主组织系列内容的重要方式，也是用户系统学习的高效途径。本文基于开源项目哔哩哔哩-API收集整理，详细解析视频合集详情接口的使用方法，帮助开发者快速集成系列内容展示功能。
合集与系列的功能区分
B站平台存在两种内容组织形式：合集(seasons_archives) 和视频列表(seasons_series)，二者在功能定位和接口设计上有显著差异。
- 合集：后加入的官方功能，图标为立体叠放的正方形(.icon-heji)，支持在创作中心精细化管理，适合结构化课程内容。
- 系列：传统列表形式，图标为平面叠放的矩形且中央有播放按钮标识(.icon-ic_channel1)，适合简单的内容归类。
详细功能对比可参考项目Issue #945
核心接口解析：获取视频合集信息
接口基础信息
请求地址：https://api.bilibili.com/x/polymer/web-space/seasons_archives_list（需验证referer）
备用地址：https://api.bilibili.com/x/polymer/space/seasons_archives_list（旧接口，无鉴权验证）
请求方式：GET
关键参数说明
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| mid | num | 用户 mid | 必要 | 创建者的用户ID |
| season_id | num | 视频合集 ID | 必要 | 合集唯一标识 |
| sort_reverse | bool | 排序方式 | 可选 | true: 升序排序 false: 默认排序 |
| gaia_vtoken | str | 风控验证 | 可选 | 异常环境下必填 |
| w_rid | str | WBI 签名 | 可选 | 参见 WBI 签名 |
响应数据结构
接口返回JSON包含三个核心对象：
- archives数组：合集中的视频列表，包含单个视频的aid、bvid、时长、封面等信息
- meta对象：合集元数据，包括标题、封面、描述、总视频数等
- page对象：分页信息，支持批量数据获取
实战调用示例
使用curl命令获取指定合集信息：
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"
完整响应示例可查看接口文档中的JSON结构
系列视频专用接口
对于仅需要获取传统系列视频的场景，可使用专用接口：
请求地址：https://api.bilibili.com/x/polymer/web-space/home/seasons_series
关键差异：支持批量获取UP主所有系列，返回数据包含分页信息和系列元数据数组。
核心返回字段：
series_list：系列列表数组meta：系列元数据（标题、封面、更新时间等）archives：视频列表（与合集接口结构一致）
接口应用场景与最佳实践
典型应用场景
- 教育类应用：集成合集接口展示完整课程目录，如JavaEE通关路线系列
- 内容聚合平台：通过系列接口批量获取UP主专辑，实现个性化推荐
- 学习助手工具：利用播放进度(playback_position)字段实现续播功能
开发注意事项
接口调试与测试工具
为简化开发流程，推荐使用以下方式进行接口调试：
总结与扩展阅读
视频合集接口为开发者提供了结构化获取B站系列内容的能力，结合视频信息接口和播放量统计接口，可构建完整的内容展示生态。项目持续更新中，建议定期关注文档更新日志获取最新接口变动。
扩展学习：
通过合理利用这些接口，开发者能够为用户提供媲美官方客户端的系列内容浏览体验，助力知识传播与内容消费升级。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
