Skip to content

Latest commit

 

History

History
1986 lines (1774 loc) · 60.6 KB

collection.md

File metadata and controls

1986 lines (1774 loc) · 60.6 KB
Raw

合集和视频列表信息

请注意区分 合集(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
pn num 页码 非必要 留空为 1
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": {}
}