bac
收藏夹基本信息
获取收藏夹元数据
https://api.bilibili.com/x/v3/fav/folder/info
请求方式：GET
认证方式：Cookie(SESSDATA) 或 APP
注：查询权限收藏夹时需要相应用户登录
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| media_id | num | 目标收藏夹id（完整id） | 必要 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 -400：请求错误 -403：访问权限不足 11010: 内容不存在 |
| message | str | 错误信息 | 默认为0 |
| data | 有效时：obj 无效或：null |
信息本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者mid | |
| attr | num | 属性位（？） | |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
| upper | obj | 创建者信息 | |
| cover_type | num | 封面图类别（？） | |
| cnt_info | obj | 收藏夹状态数 | |
| type | num | 类型（？） | 一般是11 |
| intro | str | 备注 | |
| ctime | num | 创建时间 | 时间戳 |
| mtime | num | 收藏时间 | 时间戳 |
| state | num | 状态（？） | 一般为0 |
| fav_state | num | 收藏夹收藏状态 | 已收藏收藏夹：1 未收藏收藏夹：0 需要登录 |
| like_state | num | 点赞状态 | 已点赞：1 未点赞：0 需要登录 |
| media_count | num | 收藏夹内容数量 |
data中的upper对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 创建者mid | |
| name | str | 创建者昵称 | |
| face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | |
| vip_type | num | 会员类别 | 0：无 1：月大会员 2：年度及以上大会员 |
| vip_statue | num | 会员开通状态 | 0：无 1：有 |
data中的cnt_info对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| collect | num | 收藏数 | |
| play | num | 播放数 | |
| thumb_up | num | 点赞数 | |
| share | num | 分享数 |
示例：
查询收藏夹id=1052622027的元数据
curl -G 'https://api.bilibili.com/x/v3/fav/folder/info' \
--data-urlencode 'media_id=1052622027' \
-b 'SESSDATA=xxx'
查看响应示例：
```json { "code": 0, "message": "0", "ttl": 1, "data": { "id": 1052622027, "fid": 10526220, "mid": 686127, "attr": 54, "title": "猛 男 生 存", "cover": "http://i2.hdslb.com/bfs/archive/bb51ee8a5fc5e03996138155f0f682d30ee16484.jpg", "upper": { "mid": 686127, "name": "籽岷", "face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp", "followed": true, "vip_type": 2, "vip_statue": 1 }, "cover_type": 2, "cnt_info": { "collect": 3393, "play": 184822, "thumb_up": 3918, "share": 44 }, "type": 11, "intro": "猛 男 生 存", "ctime": 1598884758, "mtime": 1598884758, "state": 0, "fav_state": 0, "like_state": 0, "media_count": 28 } } ```获取指定用户创建的所有收藏夹信息
https://api.bilibili.com/x/v3/fav/folder/created/list-all
请求方式：GET
认证方式：Cookie (SESSDATA) 或 APP
若欲查看相应用户的私密收藏夹需要登录
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| up_mid | num | 目标用户mid | 必要 | |
| type | num | 目标内容属性 | 非必要 | 默认为全部 0：全部 2：视频稿件 |
| rid | num | 目标内容id | 非必要 | 视频稿件：视频稿件avid |
| web_location | str | 333.1387 | 非必要 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 -400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 隐藏时：null 公开时：obj |
信息本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时：null 有收藏夹时：array |
收藏夹列表 | |
| season | null | （？） |
data中的list数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于count的值 |
| …… | obj | …… |
data中的list数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者mid | |
| attr | num | 收藏夹属性 | 二进制位属性 详细说明见下表 |
| title | str | 收藏夹标题 | |
| fav_state | num | 目标id是否存在于该收藏夹 | 存在于该收藏夹：1 不存在于该收藏夹：0 |
| media_count | num | 收藏夹内容数量 |
attr属性位二进制值表：
| 位 | 内容 | 备注 |
|---|---|---|
| 0 | 私有收藏夹 | 0：公开 1：私有 |
| 1 | 是否为默认收藏夹 | 0：默认收藏夹 1：其他收藏夹 |
| 其他有待补充… |
示例：
查询用户mid=7792521的收藏夹列表
curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
--data-urlencode 'up_mid=7792521' \
-b 'SESSDATA=xxx'
查看响应示例：
```json { "code": 0, "message": "0", "ttl": 1, "data": { "count": 5, "list": [{ "id": 44233921, "fid": 442339, "mid": 7792521, "attr": 0, "title": "默认收藏夹", "fav_state": 0, "media_count": 85 }, { "id": 936347621, "fid": 9363476, "mid": 7792521, "attr": 22, "title": "放假君的鬼畜私房歌", "fav_state": 0, "media_count": 2 }, { "id": 845218621, "fid": 8452186, "mid": 7792521, "attr": 22, "title": "♪一言不合就开唱♪", "fav_state": 0, "media_count": 4 }, { "id": 844998121, "fid": 8449981, "mid": 7792521, "attr": 22, "title": "个人作品精选", "fav_state": 0, "media_count": 25 }, { "id": 381779121, "fid": 3817791, "mid": 7792521, "attr": 22, "title": "鬼畜小课堂", "fav_state": 0, "media_count": 25 }] } } ```查询用户收藏的视频收藏夹
https://api.bilibili.com/x/v3/fav/folder/collected/list
请求方式：GET
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| ps | num | 每页项数 | 必要 | 定义域 1 - 大于70 |
| pn | num | 页码 | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
| platform | str | 平台类型 | 非必要 | 填写web 返回值才会包含用户收藏的视频合集 |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 -101：账号未登录 -111：csrf校验失败 40022：签名过长 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 隐藏时：null 公开时：obj |
信息本体 |
data对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时：null 有收藏夹时：array |
收藏夹列表 |
data中的list数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于count的值 |
| …… | obj | …… |
data中的list数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| id | num | 收藏夹ml | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性 | 同上 attr |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
| upper | obj | 收藏夹创建用户信息 | |
| cover_type | num | 2 | 作用尚不明确 |
| intro | str | 空 | 作用尚不明确 |
| ctime | num | 创建时间 | 时间戳 |
| mtime | num | 审核时间 | 时间戳 |
| state | num | 0, 1 | 0: 正常；1:收藏夹已失效 |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 |
data中的list数组中的对象中的upper对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 创建人mid | |
| name | str | 创建人昵称 | |
| face | str | 空 | 作用尚不明确 |
示例：
查询用户mid=293793435的收藏夹收藏列表
curl -G 'https://api.bilibili.com/x/v3/fav/folder/collected/list' \
--data-urlencode 'up_mid=293793435' \
--data-urlencode 'ps=20' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
查看响应示例：
```json { "code": 0, "message": "0", "ttl": 1, "data": { "count": 2, "list": [{ "id": 496307088, "fid": 4963070, "mid": 412466388, "attr": 22, "title": "入站必刷", "cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg", "upper": { "mid": 412466388, "name": "热门菌", "face": "" }, "cover_type": 2, "intro": "", "ctime": 1563394571, "mtime": 1563394571, "state": 0, "fav_state": 0, "media_count": 55 }, { "id": 381779121, "fid": 3817791, "mid": 7792521, "attr": 22, "title": "鬼畜小课堂", "cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg", "upper": { "mid": 7792521, "name": "还有一天就放假了", "face": "" }, "cover_type": 2, "intro": "", "ctime": 1553700224, "mtime": 1557291666, "state": 0, "fav_state": 0, "media_count": 25 }] } } ```批量获取指定收藏id的内容
https://api.bilibili.com/x/v3/fav/resource/infos
请求方式：GET
url参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型} 每个成员间用 ,分隔类型： 2：视频稿件 12：音频 内容id： 视频稿件：视频稿件avid 音频：音频auid |
| platform | str | 平台标识 | 非必要 | 可为web（影响内容列表类型） |
json回复：
根对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0：成功 -400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| data | 有效时：array 无效或：null |
内容信息列表 |
data数组：
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 内容信息1 | |
| n | obj | 内容信息（n+1） | |
| … | obj | … |
data数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| id | num | 内容id | 视频稿件：视频稿件avid 音频：音频auid |
| type | num | 内容类型 | 2：视频稿件 12：音频 |
| title | str | 标题 | |
| cover | str | 封面url | |
| intro | str | 简介 | |
| page | num | 视频分P数 | |
| duration | num | 音频/视频时长 | |
| upper | obj | UP主信息 | |
| attr | num | 属性 | 0：正常 1：失效 |
| cnt_info | obj | 状态数 | |
| link | str | 跳转uri | |
| ctime | num | 投稿时间 | 时间戳 |
| pubtime | num | 发布时间 | 时间戳 |
| fav_time | num | 收藏时间 | 时间戳 |
| bv_id | str | 视频稿件bvid | |
| bvid | str | 视频稿件bvid | |
| season | null | （？） |
data数组中的对象中的upper对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | UP主mid | |
| name | str | UP主昵称 | |
| face | str | UP主头像url |
data数组中的对象中的cnt_info对象：
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| collect | num | 收藏数 | |
| play | num | 播放数 | |
| danmaku | num | 弹幕数 |
示例：
批量查询内容
1-视频稿件-av583785685
2-音频-au15664
curl -G 'https://api.bilibili.com/x/v3/fav/resource/infos' \
--data-urlencode 'resources=583785685:2,15664:12'