Northern_Lights/bilibili-API-collect

Fork 0

A81N9 a70c0500d6

feat: 补充分页描述

2025-10-30 10:14:48 +08:00

61 KiB

Raw Blame History

合集和视频列表信息

请注意区分 合集(seasons_archives) 和 视频列表(seasons_series)

合集是后加入的功能, 图标为立体叠放的正方形(.icon-heji), 可以在创作中心管理, 参见合集管理

列表即系列(series)或频道(channel), 图标为平面叠放的矩形且中央有播放按钮标识(.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

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=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 签名

JSON回复:

根对象:

字段	类型	内容	备注
code	num	返回值	0：成功 -352: 请求被风控 -400: 请求错误
message	str	错误信息	默认为0
ttl	num	1
data	obj	信息本体

data对象:

字段	类型	内容	备注
items_lists	obj	内容列表	套了个娃

data中的items_lists对象:

字段	类型	内容
page	obj	分页信息
seasons_list	array	空
series_list	array	系列列表

items_lists中的page对象:

字段	类型	内容
page_num	num	分页页码
page_size	num	单页个数
total	num	总页数

items_lists中的series_list数组:

项	类型	内容	备注
0	obj	第1个系列内容
1	obj	第2个系列内容
……	obj	……	……
n	obj	第(n+1)个系列内容

series_list数组中的对象:

字段	类型	内容	备注
archives	array	系列视频列表
meta	obj	系列元数据
recent_aids	array	系列视频 aid 列表	内容类型为num

series_list中的archives数组:

同获取视频合集信息中的archives数组

series_list中的meta对象:

字段	类型	内容	备注
category	num	1
cover	str	系列封面 URL
creator	str	auto
ctime	num	创建时间	Unix 时间戳
description	str	系列描述
keywords	array	系列关键词列表	内容类型为str
last_update_ts	num	最近更新时间	Unix 时间戳
mid	num	UP 主 ID
mtime	num	修改时间	Unix 时间戳
name	str	系列标题
raw_keywords	str	原始系列关键词
series_id	num	系列 ID
state	num	2
total	num	系列视频数量

示例:

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
          ]
        },
        {
          "archives": [
            {
              "aid": 848832470,
              "bvid": "BV1CL4y1i7qR",
              "ctime": 1635258883,
              "duration": 106474,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/45dddea811257f78ddd6f1e70197d95d7d6b5187.jpg",
              "playback_position": 0,
              "pubdate": 1635258883,
              "stat": {
                "view": 438645,
                "vt": 0
              },
              "state": 0,
              "title": "JavaWeb 教程 已完结（IDEA 2021版本）4K蓝光画质 入土到起立",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 566880413,
              "bvid": "BV1Kv4y1x7is",
              "ctime": 1676544280,
              "duration": 25149,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/cc59de5afebc66447ba93ad9ea0ba73a9b09c117.jpg",
              "playback_position": 0,
              "pubdate": 1676544280,
              "stat": {
                "view": 87171,
                "vt": 0
              },
              "state": 0,
              "title": "Spring 核心教程 已完结（IDEA 2023最新版）4K蓝光画质 基于Spring6的全新重制版本 起立到起飞",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 615286308,
              "bvid": "BV1Lh4y1M7kx",
              "ctime": 1688117457,
              "duration": 10373,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/5f860de4bc0fab30651ae93396f9c572be8380b2.jpg",
              "playback_position": 0,
              "pubdate": 1688117457,
              "stat": {
                "view": 41428,
                "vt": 0
              },
              "state": 0,
              "title": "Spring MVC 教程 已完结（IDEA 2023最新版）4K蓝光画质 基于Spring6的全新重制版本 起立到起飞",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 403104913,
              "bvid": "BV1fV411M7aS",
              "ctime": 1688560394,
              "duration": 17611,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/c4557a16aa3519183d6ae0114e1c64107bb23703.jpg",
              "playback_position": 0,
              "pubdate": 1688560394,
              "stat": {
                "view": 59298,
                "vt": 0
              },
              "state": 0,
              "title": "Spring Security 教程 已完结（IDEA 2023最新版）4K蓝光画质 基于Spring6的全新重制版本 起立到起飞",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 828666773,
              "bvid": "BV1xu4y1m7UP",
              "ctime": 1689767299,
              "duration": 29696,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/06cf686d4d3f7ce6731975ef59938d759283318e.jpg",
              "playback_position": 0,
              "pubdate": 1689767299,
              "stat": {
                "view": 108078,
                "vt": 0
              },
              "state": 0,
              "title": "Spring Boot 教程 已完结（IDEA 2023最新版）4K蓝光画质 基于SpringBoot 3 的全新重制版本 起飞到删库跑路",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 852857221,
              "bvid": "BV1AL4y1j7RY",
              "ctime": 1648811079,
              "duration": 55544,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/629755f79c13c96c9b6d91da80257a352b29dd86.jpg",
              "playback_position": 0,
              "pubdate": 1648811079,
              "stat": {
                "view": 168251,
                "vt": 0
              },
              "state": 0,
              "title": "SpringCloud 教程 已完结（IDEA 2022.1最新版）4K蓝光画质 微服务开发",
              "ugc_pay": 0,
              "vt_display": ""
            }
          ],
          "meta": {
            "category": 1,
            "cover": "http://i0.hdslb.com/bfs/archive/45dddea811257f78ddd6f1e70197d95d7d6b5187.jpg",
            "creator": "auto",
            "ctime": 1669273103,
            "description": "已排序完成，共4个系列，请至少完成Java SE篇视频之后再开始JavaEE路线哦~ 整个路线大致为：JavaWeb基础篇、SSM成长篇、SpringBoot成熟篇、SpringCloud进阶篇",
            "keywords": [
              ""
            ],
            "last_update_ts": 1696249622,
            "mid": 37737161,
            "mtime": 1696249622,
            "name": "JavaEE通关路线",
            "raw_keywords": "",
            "series_id": 2800548,
            "state": 2,
            "total": 9
          },
          "recent_aids": [
            848832470,
            566880413,
            615286308,
            403104913,
            828666773,
            852857221
          ]
        },
        {
          "archives": [
            {
              "aid": 445283537,
              "bvid": "BV14j411S76G",
              "ctime": 1687946670,
              "duration": 7008,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/208bb09ecf97fbbd73e45b3839715276ffbbe8f4.jpg",
              "playback_position": 0,
              "pubdate": 1687946670,
              "stat": {
                "view": 9483,
                "vt": 0
              },
              "state": 0,
              "title": "Apache Maven 依赖管理 极速上手 已完结（2021 版本）4K蓝光画质+杜比音效 从导入到冲突",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 813084463,
              "bvid": "BV1r34y1p7j9",
              "ctime": 1656909478,
              "duration": 17457,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/798135f31dc9e03121458f32825dc81d8e403887.jpg",
              "playback_position": 0,
              "pubdate": 1656909478,
              "stat": {
                "view": 46179,
                "vt": 0
              },
              "state": 0,
              "title": "Docker 容器技术 已完结（2022 最新版）4K蓝光画质+杜比音效 从内卷到开摆",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 432905025,
              "bvid": "BV1a3411f7nh",
              "ctime": 1669296029,
              "duration": 10393,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/d14c0fad064a224de7afb7edd147f8b335324c53.jpg",
              "playback_position": 0,
              "pubdate": 1669296029,
              "stat": {
                "view": 37040,
                "vt": 0
              },
              "state": 0,
              "title": "Linux 操作系统 光速入门 已完结（2021 版本）4K蓝光画质+杜比音效 从讨厌到喜欢",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 390385576,
              "bvid": "BV19d4y147Df",
              "ctime": 1669272992,
              "duration": 23389,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/8ba763e1a1e14c47c1c178ecf21240896d3fbb5e.jpg",
              "playback_position": 0,
              "pubdate": 1669272992,
              "stat": {
                "view": 32189,
                "vt": 0
              },
              "state": 0,
              "title": "MySQL 数据库技术 已完结（2021版本）4K蓝光画质+杜比音效 从内卷到开摆",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 647924810,
              "bvid": "BV1ce4y1W7YB",
              "ctime": 1669275447,
              "duration": 8492,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/f5bcc92a4e181cb12a8b80499cea255f43f2d97b.jpg",
              "playback_position": 0,
              "pubdate": 1669275447,
              "stat": {
                "view": 20004,
                "vt": 0
              },
              "state": 0,
              "title": "Git 版本控制 快速上手 已完结（2021版本）4K蓝光画质+杜比音效 从开摆到放弃",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 347934006,
              "bvid": "BV1vR4y1o7Z2",
              "ctime": 1669295228,
              "duration": 10631,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/f95d39b0bc1a2bdad07461a8f4b1ea48c174902c.jpg",
              "playback_position": 0,
              "pubdate": 1669295228,
              "stat": {
                "view": 25860,
                "vt": 0
              },
              "state": 0,
              "title": "Redis 缓存技术 已完结（2021版本）4K蓝光画质+杜比音效 从内卷到开摆",
              "ugc_pay": 0,
              "vt_display": ""
            }
          ],
          "meta": {
            "category": 1,
            "cover": "http://i1.hdslb.com/bfs/archive/208bb09ecf97fbbd73e45b3839715276ffbbe8f4.jpg",
            "creator": "auto",
            "ctime": 1669273164,
            "description": "包含主线中讲解的中间件归档视频与当下必学的火热技术。",
            "keywords": [
              ""
            ],
            "last_update_ts": 1688123428,
            "mid": 37737161,
            "mtime": 1688123428,
            "name": "必学技术与中间件",
            "raw_keywords": "",
            "series_id": 2800550,
            "state": 2,
            "total": 7
          },
          "recent_aids": [
            445283537,
            813084463,
            432905025,
            390385576,
            647924810,
            347934006
          ]
        },
        {
          "archives": [
            {
              "aid": 900707014,
              "bvid": "BV1YP4y1o75f",
              "ctime": 1663494406,
              "duration": 103542,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/291dd3b60b67a8f74567a81999612bd50b4e8017.jpg",
              "playback_position": 0,
              "pubdate": 1663494406,
              "stat": {
                "view": 312144,
                "vt": 0
              },
              "state": 0,
              "title": "JavaSE 教程 已完结 (IDEA 2022 最新版) 4K蓝光画质+杜比音效 零基础入门一套搞定 入门到入土",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 604837097,
              "bvid": "BV1G84y1v7Vj",
              "ctime": 1667815711,
              "duration": 19395,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/4a4522194a1d0c8ae684976b26fb2fe43ce28f39.jpg",
              "playback_position": 0,
              "pubdate": 1667815711,
              "stat": {
                "view": 74496,
                "vt": 0
              },
              "state": 0,
              "title": "JavaSE AWT/Swing 图形化编程 (IDEA 2022 最新版) 4K蓝光画质+杜比音效 快速上手桌面程序 用IDEA写IDEA",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 766688029,
              "bvid": "BV1Er4y1r7as",
              "ctime": 1645157763,
              "duration": 21585,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/ced6a8c8548f0f921f306ea3589f9d470adc0446.jpg",
              "playback_position": 0,
              "pubdate": 1645157763,
              "stat": {
                "view": 133409,
                "vt": 0
              },
              "state": 0,
              "title": "Java JVM 虚拟机 已完结（IDEA 2021版本）4K蓝光画质 全程劝退",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 936955310,
              "bvid": "BV1JT4y1S7K8",
              "ctime": 1646391131,
              "duration": 31736,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/9347ef3cdb6cf0e5bca29ce32e211b488e90ab7b.jpg",
              "playback_position": 0,
              "pubdate": 1646391131,
              "stat": {
                "view": 74731,
                "vt": 0
              },
              "state": 0,
              "title": "Java JUC 并发编程 已完结（IDEA 2021版本）4K蓝光画质 玩转多线程",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 768437265,
              "bvid": "BV1ar4y1J7mC",
              "ctime": 1650881312,
              "duration": 26314,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/7f97549147c09a386d9402b121cc6206c36e4079.jpg",
              "playback_position": 0,
              "pubdate": 1650881312,
              "stat": {
                "view": 67900,
                "vt": 0
              },
              "state": 0,
              "title": "Java NIO Netty网络编程 已完结（IDEA 2022.1最新版）4K蓝光画质 网络I/O进阶编程",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 684547077,
              "bvid": "BV1tU4y1y7Fg",
              "ctime": 1653900327,
              "duration": 10243,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/dc0cc9464c6fc274c1f23f682a01dab5a358217b.jpg",
              "playback_position": 0,
              "pubdate": 1653900327,
              "stat": {
                "view": 47693,
                "vt": 0
              },
              "state": 0,
              "title": "JavaSE 9-17 新特性 已完结（IDEA 2022.1最新版）4K蓝光画质 Java9/10/11/12/13/14/15/16/17讲解",
              "ugc_pay": 0,
              "vt_display": ""
            }
          ],
          "meta": {
            "category": 1,
            "cover": "http://i0.hdslb.com/bfs/archive/291dd3b60b67a8f74567a81999612bd50b4e8017.jpg",
            "creator": "auto",
            "ctime": 1648810702,
            "description": "已排序完成，共3个系列，完成JavaSE篇之后，就可以开启JavaEE路线了",
            "keywords": [
              ""
            ],
            "last_update_ts": 1667816253,
            "mid": 37737161,
            "mtime": 1667816253,
            "name": "JavaSE基础路线",
            "raw_keywords": "",
            "series_id": 2158988,
            "state": 2,
            "total": 6
          },
          "recent_aids": [
            900707014,
            604837097,
            766688029,
            936955310,
            768437265,
            684547077
          ]
        },
        {
          "archives": [
            {
              "aid": 770027221,
              "bvid": "BV1Cr4y137os",
              "ctime": 1655371329,
              "duration": 48185,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/5d9bd135f068e623e50c7341244635f6cc96c3ea.jpg",
              "playback_position": 0,
              "pubdate": 1655371329,
              "stat": {
                "view": 275378,
                "vt": 0
              },
              "state": 0,
              "title": "C语言程序设计 已完结（CLion 2022 最新版）4K蓝光画质+杜比音效 梦开始的地方",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 941207928,
              "bvid": "BV13W4y127Ey",
              "ctime": 1658474799,
              "duration": 69081,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/0bf055a0961c0f9bbb7f869b47c3e3d7df21f55c.jpg",
              "playback_position": 0,
              "pubdate": 1658474798,
              "stat": {
                "view": 220072,
                "vt": 0
              },
              "state": 0,
              "title": "数据结构与算法 已完结（CLion 2022 最新版）4K蓝光画质+杜比音效 全程高能",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 426681358,
              "bvid": "BV1u3411P7Na",
              "ctime": 1653033628,
              "duration": 12346,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i0.hdslb.com/bfs/archive/4174e2976f750d5410d6cef374c3035190717cac.jpg",
              "playback_position": 0,
              "pubdate": 1653033628,
              "stat": {
                "view": 71911,
                "vt": 0
              },
              "state": 0,
              "title": "Java 设计模式 已完结（IDEA 2022.1最新版）4K蓝光画质+杜比音效",
              "ugc_pay": 0,
              "vt_display": ""
            }
          ],
          "meta": {
            "category": 1,
            "cover": "http://i0.hdslb.com/bfs/archive/5d9bd135f068e623e50c7341244635f6cc96c3ea.jpg",
            "creator": "auto",
            "ctime": 1653296733,
            "description": "Java设计模式系列视频，提升你的代码编写规范。",
            "keywords": [
              ""
            ],
            "last_update_ts": 1658735292,
            "mid": 37737161,
            "mtime": 1658735292,
            "name": "高等院校计算机必修课",
            "raw_keywords": "",
            "series_id": 2318088,
            "state": 2,
            "total": 3
          },
          "recent_aids": [
            770027221,
            941207928,
            426681358
          ]
        }
      ]
    }
  }
}

获取系列和合集视频

https://api.bilibili.com/x/polymer/web-space/seasons_series_list

请求方式: GET

鉴权方式: 请求头 User-Agent 为正常浏览器, 若仍被风控则请求头再带上 Referer 为 .bilibili.com 下任意页

URL参数:

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
page_num	num	页码	必要	默认为 1
page_size	num	每页数量	必要	默认为 20
w_rid	str	WBI 签名	可选	参见 WBI 签名
wts	num	UNIX 秒级时间戳	可选	参见 WBI 签名
web_location	str	页面位置?	可选	333.999

JSON回复:

与只获取系列视频基本一致, 但 .data.items_lists.seasons_list 数组不为空, 且该数组中的元素结构与 .data.items_lists.series_list 相同, 略

示例:

获取 mid=37737161 的系列视频列表，每页 5 条，页码为 1

curl -G "https://api.bilibili.com/x/polymer/web-space/seasons_series_list" \
--data-urlencode "mid=37737161" \
--data-urlencode "page_num=1" \
--data-urlencode "page_size=5" \
--data-urlencode "w_rid=xxx" \
--data-urlencode "wts=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "items_lists": {
      "page": {
        "page_num": 1,
        "page_size": 5,
        "total": 9
      },
      "seasons_list": [
        {
          "archives": [
            {
              "aid": 343807541,
              "bvid": "BV1t94y1D79E",
              "ctime": 1658907465,
              "duration": 2164,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i1.hdslb.com/bfs/archive/0af0faa77a1921db4cf86c115db70aa2594983f0.jpg",
              "playback_position": 0,
              "pubdate": 1658907465,
              "stat": {
                "view": 43096,
                "vt": 0
              },
              "state": 0,
              "title": "Java学习路线两条龙版，让你不再迷茫！包含各个知识点梳理，常用技术栈介绍等。",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 429032764,
              "bvid": "BV11G411h7NB",
              "ctime": 1659499261,
              "duration": 197,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/5235a0ab2738e288b08654aa8e0cd3a509a7ef96.jpg",
              "playback_position": 0,
              "pubdate": 1659499200,
              "stat": {
                "view": 22700,
                "vt": 0
              },
              "state": 0,
              "title": "好书推荐《On Java》都什么年代了，还在看传统Java书籍？",
              "ugc_pay": 0,
              "vt_display": ""
            },
            // ...
          ],
          "meta": {
            "category": 0,
            "cover": "https://archive.biliimg.com/bfs/archive/27733cf13514d990c880154b937cd8633f583aa4.jpg",
            "description": "除教程视频外其他的视频，均在此。",
            "mid": 37737161,
            "name": "合集·拾枝杂谈",
            "ptime": 1694682652,
            "season_id": 587216,
            "total": 10
          },
          "recent_aids": [
            343807541,
            429032764,
            857089796,
            560181990,
            774119786,
            859397126
          ]
        },
        {
          "archives": [
            {
              "aid": 311606079,
              "bvid": "BV1XN411K7g9",
              "ctime": 1679651747,
              "duration": 261,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/234e6bd061176dba9e148f4373c52fa7cd2d801f.jpg",
              "playback_position": 0,
              "pubdate": 1679651747,
              "stat": {
                "view": 12150,
                "vt": 0
              },
              "state": 0,
              "title": "某些IT社区平台乱象，文章千篇一律，毫不注重版权，文章互相抄袭成潮流，希望能够好好管管！",
              "ugc_pay": 0,
              "vt_display": ""
            },
            {
              "aid": 400546145,
              "bvid": "BV1qo4y1L73P",
              "ctime": 1682777426,
              "duration": 335,
              "enable_vt": false,
              "interactive_video": false,
              "pic": "http://i2.hdslb.com/bfs/archive/a6b6fb0330bbf6c500720a024e5a9ade24d888c3.jpg",
              "playback_position": 0,
              "pubdate": 1682777425,
              "stat": {
                "view": 52744,
                "vt": 0
              },
              "state": 0,
              "title": "某些搜索引擎得到的结果，官方网站反而排在一些诈骗广告后面，诱导用户下载大量捆绑垃圾软件",
              "ugc_pay": 0,
              "vt_display": ""
            }
          ],
          "meta": {
            "category": 0,
            "cover": "https://archive.biliimg.com/bfs/archive/5e1c1f77c3065ec31eec43d7e35f7a061602e4d6.jpg",
            "description": "白马首席讲师吐槽系列视频",
            "mid": 37737161,
            "name": "合集·水浅王八多，真假白马说",
            "ptime": 1682777425,
            "season_id": 1227671,
            "total": 2
          },
          "recent_aids": [
            311606079,
            400546145
          ]
        },
        // ...
      ],
      "series_list": [
        // 与前接口基本相同
      ]
    }
  }
}

查询指定系列

https://api.bilibili.com/x/series/series

请求方式: GET

URL参数:

参数名	类型	内容	必要性	备注
series_id	num	系列ID	必要

JSON回复:

根对象:

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

data对象:

字段	类型	内容	备注
meta	obj	系列信息
recent_aids	array	系列 aid 列表	内容类型为 num

data中的meta对象:

同只获取系列视频中的meta对象

示例:

curl -G 'https://api.bilibili.com/x/series/series' \
--data-urlencode 'series_id=2158988'

查看响应示例

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "meta": {
      "series_id": 2158988,
      "mid": 37737161,
      "name": "JavaSE基础路线",
      "description": "已排序完成，共3个系列，完成JavaSE篇之后，就可以开启JavaEE路线了",
      "keywords": [
        ""
      ],
      "creator": "auto",
      "state": 2,
      "last_update_ts": 1667816253,
      "total": 6,
      "ctime": 1648810702,
      "mtime": 1667816253,
      "raw_keywords": "",
      "category": 1
    },
    "recent_aids": [
      900707014,
      604837097,
      766688029,
      936955310,
      768437265,
      684547077
    ]
  }
}

获取指定系列视频

https://api.bilibili.com/x/series/archives

请求方式: GET

URL参数:

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
series_id	num	系列ID	必要
only_normal	bool	作用尚不明确	可选	默认为 true
sort	str	排序方式	可选	desc: 默认排序 asc: 升序排序
pn	num	页码	可选	默认为 1
ps	num	每页数量	可选	默认为 20
current_mid	num	当前用户 mid	可选	用于 `playback_position` 播放进度

JSON回复:

根对象:

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

data对象:

字段	类型	内容	备注
aids	array	视频 aid 列表	内容类型为 num
page	obj	页码信息
archives	array	视频信息列表

data中的page对象:

字段	类型	内容
num	num	当前页码
size	num	每页数量
total	num	视频总数

data中的archives数组:

基本同获取视频合集信息中的archives数组

示例:

获取 mid=39665558 的 series_id=534501 系列视频列表，每页 16 条，页码为 1，默认排序, 当前用户 mid 为 1070915568

curl -G "https://api.bilibili.com/x/series/archives" \
--data-urlencode "mid=39665558" \
--data-urlencode "series_id=534501" \
--data-urlencode "only_normal=true" \
--data-urlencode "sort=desc" \
--data-urlencode "pn=1" \
--data-urlencode "ps=16" \
--data-urlencode "current_mid=1070915568"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "aids": [
      695029098,
      724599872,
      594794875,
      41565264,
      541053051,
      499696652,
      673071936,
      462891077,
      973903762,
      61692380,
      336713491,
      372661682,
      550840795,
      51839931,
      718592873,
      87838863
    ],
    "page": {
      "num": 1,
      "size": 16,
      "total": 25
    },
    "archives": [
      {
        "aid": 695029098,
        "title": "Python控制Minecraft教程（下）：自动建造",
        "pubdate": 1677321251,
        "ctime": 1677321251,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/187c0ba21b9ceba908a8760e83d49f466316824b.jpg",
        "duration": 275,
        "stat": {
          "view": 26555
        },
        "bvid": "BV1k24y1J78X",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 724599872,
        "title": "『教程』一看就懂！Github基础教程",
        "pubdate": 1646740815,
        "ctime": 1646740824,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/1401ebe64e88deddf2b44ad6a740ff8872c2fda6.jpg",
        "duration": 296,
        "stat": {
          "view": 2412054
        },
        "bvid": "BV1hS4y1S7wL",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 594794875,
        "title": "『教程』手把手教你流畅访问Github",
        "pubdate": 1647345613,
        "ctime": 1647336725,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/71cc640a84087cc99399449c00b93212fe78ee6f.jpg",
        "duration": 236,
        "stat": {
          "view": 910491
        },
        "bvid": "BV1Aq4y1q7hr",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 41565264,
        "title": "《Python负基础到入门教程》专为\"非计算机专业和编程困难户\"制作（全13集 配音字幕重制版）",
        "pubdate": 1548316071,
        "ctime": 1548316072,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/5f4f6acfc00723c84f726d35add94b1d4b4ee482.jpg",
        "duration": 6395,
        "stat": {
          "view": 261286
        },
        "bvid": "BV1et411b76c",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 541053051,
        "title": "『教程』文字频频乱码 这背后是显卡的扭曲还是规则的沦丧？",
        "pubdate": 1592996906,
        "ctime": 1592996907,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/8a3c3e3d01a91776763d34bba79add698869c82d.jpg",
        "duration": 381,
        "stat": {
          "view": 1184937
        },
        "bvid": "BV1ai4y1x7Uz",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 499696652,
        "title": "『教程』VsCode五分钟上手教程 无一句废话",
        "pubdate": 1601207369,
        "ctime": 1601207369,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/cb78c07a090ed456bdcc217b0417670867772a29.jpg",
        "duration": 329,
        "stat": {
          "view": 417610
        },
        "bvid": "BV1bK411P767",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 673071936,
        "title": "『教程』补码怎么来的？",
        "pubdate": 1620994814,
        "ctime": 1620986531,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/12c02599321a0b1386b29ddc4653ff7df9bd54b4.jpg",
        "duration": 445,
        "stat": {
          "view": 247578
        },
        "bvid": "BV16U4y1t7LD",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 462891077,
        "title": "『教程』回调函数是个啥？",
        "pubdate": 1631274885,
        "ctime": 1631274885,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/df294350462558601f65b743ca25e2fdc01de628.jpg",
        "duration": 452,
        "stat": {
          "view": 213895
        },
        "bvid": "BV1vL411t78b",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 98
      },
      {
        "aid": 973903762,
        "title": "『教程』堆栈是个啥？",
        "pubdate": 1625227205,
        "ctime": 1625227209,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/bf7956b6311ec0787fd52d1293bb4287d16b7e65.jpg",
        "duration": 370,
        "stat": {
          "view": 535174
        },
        "bvid": "BV1P44y1q7uL",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 99
      },
      {
        "aid": 61692380,
        "title": "『教程』什么是递归？",
        "pubdate": 1564660818,
        "ctime": 1564637347,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/4af853671204b9bc631fada1934a3e86145a7d19.jpg",
        "duration": 658,
        "stat": {
          "view": 487397
        },
        "bvid": "BV194411f71o",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 79
      },
      {
        "aid": 336713491,
        "title": "『教程』几分钟听懂迭代器",
        "pubdate": 1636713476,
        "ctime": 1636713476,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/6e255cce7c0303ab0211acd0f9d1ec5980ff03f7.jpg",
        "duration": 453,
        "stat": {
          "view": 110688
        },
        "bvid": "BV18R4y1t7Hg",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 97
      },
      {
        "aid": 372661682,
        "title": "『教程』桌面精灵是怎样实现的？",
        "pubdate": 1604916264,
        "ctime": 1604916264,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/aaa8bb7b6fced63dd4792e28c1f78ba903fcc4cc.jpg",
        "duration": 326,
        "stat": {
          "view": 168775
        },
        "bvid": "BV1aZ4y1V7aa",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 550840795,
        "title": "『教程』什么是钩子技术？",
        "pubdate": 1642744335,
        "ctime": 1642744335,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/380b1ff9726c673411cf916b03268c7fb16aff68.jpg",
        "duration": 240,
        "stat": {
          "view": 237568
        },
        "bvid": "BV1Cq4y1c7kK",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 51839931,
        "title": "『教程』学编程前必知的8个电脑操作",
        "pubdate": 1557313623,
        "ctime": 1557313623,
        "state": 0,
        "pic": "http://i2.hdslb.com/bfs/archive/b54535ee3ff27006912d8013f2ea1667b2a50f80.jpg",
        "duration": 641,
        "stat": {
          "view": 139385
        },
        "bvid": "BV1t4411v78E",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 718592873,
        "title": "『教程』这些常见编程单词到底该怎么读？看你能否读对？对✔❌✅☑",
        "pubdate": 1634300675,
        "ctime": 1634265090,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/de43275f44aea9f6d79c13ee68c6dcdfc9e5fc5e.jpg",
        "duration": 783,
        "stat": {
          "view": 81193
        },
        "bvid": "BV1JQ4y1D79p",
        "ugc_pay": 0,
        "interactive_video": true,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 100
      },
      {
        "aid": 87838863,
        "title": "『教程』什么是环境变量",
        "pubdate": 1581258353,
        "ctime": 1581258353,
        "state": 0,
        "pic": "http://i0.hdslb.com/bfs/archive/331b2304d8262c4252f338599846761d6a5a8e0c.jpg",
        "duration": 353,
        "stat": {
          "view": 99797
        },
        "bvid": "BV1w741147G9",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      }
    ]
  }
}

根据关键词查找视频

https://api.bilibili.com/x/series/recArchivesByKeywords

请求方式：GET

URL参数:

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
keywords	str	关键词	必要	可为空, 即获取所有视频
ps	num	每页视频数	非必要	默认为 0, 留空为 20，最大值 100
pn	num	页码	非必要	留空为 1，为 0 则直接忽略 ps 参数获取所有
orderby	str	排序方式	非必要	最新发布: pubdate(默认) 最多播放: views senddate: 最新发布
series_id	num	系列 ID	非必要	用于过滤结果, 即若某一视频包含在系列内则不返回该视频

JSON回复:

根对象:

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

data 对象:

字段	类型	内容	备注
archives	arr	视频列表
page	obj	页码信息

archives 数组:

同获取视频合集信息中的archives数组

page 对象:

同获取视频合集信息中的page对象

示例:

查询用户 mid=2 关键词为 幕 的视频, 不限制每页视频数

curl -G "https://api.bilibili.com/x/series/recArchivesByKeywords" \
--data-urlencode "mid=2" \
--data-urlencode "keywords=幕" \
--data-urlencode "ps=0"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "archives": [
      {
        "aid": 120040,
        "title": "高级语言弹幕测试",
        "pubdate": 1311616515,
        "ctime": 1497344798,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/55a553659799d8a6fcb645d8f1f9df418ad6fe4e.jpg",
        "duration": 911,
        "stat": {
          "view": 3584767
        },
        "bvid": "BV1Xx411c7cH",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 2,
        "title": "字幕君交流场所",
        "pubdate": 1252458549,
        "ctime": 1497344798,
        "state": 0,
        "pic": "http://static.hdslb.com/images/transparent.gif",
        "duration": 2055,
        "stat": {
          "view": 4609291
        },
        "bvid": "BV1xx411c7mD",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      },
      {
        "aid": 271,
        "title": "弹幕测试专用",
        "pubdate": 1249886475,
        "ctime": 1497344798,
        "state": 0,
        "pic": "http://i1.hdslb.com/bfs/archive/a5980672f3d03e8292148748a63de99cd45679d3.jpg",
        "duration": 1213,
        "stat": {
          "view": 4857422
        },
        "bvid": "BV1xx411c7Xg",
        "ugc_pay": 0,
        "interactive_video": false,
        "enable_vt": 0,
        "vt_display": "",
        "playback_position": 0
      }
    ],
    "page": {
      "num": 1,
      "size": 0,
      "total": 3
    }
  }
}

创建视频列表

https://api.bilibili.com/x/series/series/createAndAddArchives

请求方式: POST

认证方式: Cookie (SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
csrf	str	CSRF Token (即 Cookies 中 bili_jct )	必要

正文参数 (multipart/form-data):

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
name	str	标题	必要
keywords	str	关键词	不必要
description	str	简介	不必要
aids	str	视频 aid 列表	不必要	以 `,` 分隔, 如 `2,112861,112861976201494,976201494`

JSON回复:

根对象:

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

data 对象:

字段	类型	内容	备注
series_id	num	视频列表 ID

示例:

为 mid=616368979 创建视频列表, 标题为 NAME, 视频为 112861976201494

curl -X POST --url "https://api.bilibili.com/x/series/series/createAndAddArchives" \
--url-query "csrf=xxxxxxxxxx" \
--data-urlencode "mid=616368979" \
--data-urlencode "name=NAME" \
--data-urlencode "aids=112861976201494" \
-b "SESSDATA=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "series_id": 4269765
  }
}

删除视频列表

https://api.bilibili.com/x/series/series/delete

请求方式: POST

认证方式: Cookie (SESSDATA)

URL参数:

参数名	类型	内容	必要性
csrf	str	CSRF Token (即 Cookies 中 bili_jct )	必要
mid	num	用户 mid	必要
series_id	num	视频列表 ID	必要
aids	str	空	不必要

JSON回复:

根对象:

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

示例:

为 mid=616368979 删除视频列表 series_id=4269765

curl -X POST --url "https://api.bilibili.com/x/series/series/delete" \
--url-query "csrf=xxxxxxxxxx" \
--url-query "series_id=4269765" \
--url-query "mid=616368979" \
-b "SESSDATA=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {}
}

删除视频列表中的稿件

https://api.bilibili.com/x/series/series/delArchives

请求方式: POST

认证方式: Cookie (SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
csrf	str	CSRF Token (即 Cookies 中 bili_jct )	必要

正文参数 (application/x-www-form-urlencoded):

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
series_id	num	视频列表 ID	必要
aids	str	视频 aid 列表	必要	以 `,` 分隔, 如 `2,112861,112861976201494,976201494`

JSON回复:

根对象:

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

示例:

为 mid=616368979 删除视频列表 series_id=4269782 中的 112861976201494

curl -X POST --url "https://api.bilibili.com/x/series/series/delArchives" \
--url-query "csrf=xxxxxxxxxx" \
--data-urlencode "mid=616368979" \
--data-urlencode "series_id=4269782" \
--data-urlencode "aids=112861976201494" \
-b "SESSDATA=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {}
}

添加稿件至视频列表

https://api.bilibili.com/x/series/series/addArchives

请求方式: POST

认证方式: Cookie (SESSDATA)

URL参数:

同删除视频列表中的稿件

正文参数 (application/x-www-form-urlencoded):

同删除视频列表中的稿件

JSON回复:

同删除视频列表中的稿件

示例:

为 mid=616368979 添加视频 112861976201494 至视频列表 series_id=4269782

curl -X POST --url "https://api.bilibili.com/x/series/series/addArchives" \
--url-query "csrf=xxxxxxxxxx" \
--data-urlencode "mid=616368979" \
--data-urlencode "series_id=4269782" \
--data-urlencode "aids=112861976201494" \
-b "SESSDATA=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {}
}

编辑视频列表信息

https://api.bilibili.com/x/series/series/update

请求方式: POST

认证方式: Cookie (SESSDATA)

URL参数:

参数名	类型	内容	必要性	备注
csrf	str	CSRF Token (即 Cookies 中 bili_jct )	必要

正文参数 (application/x-www-form-urlencoded):

参数名	类型	内容	必要性	备注
mid	num	用户 mid	必要
series_id	num	视频列表 ID	必要
name	str	标题	必要
keywords	str	关键词	不必要
description	str	简介	不必要
add_aids	str	视频 aid 列表	不必要	以 `,` 分隔
del_aids	str	视频 aid 列表	不必要
aids	str	空	不必要

JSON回复:

同删除视频列表中的稿件

示例:

为 mid=616368979 编辑视频列表 series_id=4269782, 设置标题为 NAME, 设置简介为空, 设置关键词 Telnet, 添加视频 112861976201494

curl -X POST --url "https://api.bilibili.com/x/series/series/update" \
--url-query "csrf=xxxxxxxxxx" \
--data-urlencode "name=NAME" \
--data-urlencode "mid=616368979" \
--data-urlencode "series_id=4269782" \
--data-urlencode "keywords=Telnet" \
--data-urlencode "add_aids=112861976201494" \
-b "SESSDATA=xxx"

查看响应示例:

{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {}
}

61 KiB Raw Blame History Unescape Escape

合集和视频列表信息

获取视频合集信息

只获取系列视频

获取系列和合集视频

查询指定系列

获取指定系列视频

根据关键词查找视频

创建视频列表

删除视频列表

删除视频列表中的稿件

添加稿件至视频列表

编辑视频列表信息

61 KiB

Raw Blame History