github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-16 06:40:05 +08:00
Code Issues Packages Projects Releases Wiki Activity
15058a39da
bilibili-API-collect/fav/list.md

571 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 收藏夹内容
- [收藏夹内容](#收藏夹内容)
- [获取收藏夹内容明细列表](#获取收藏夹内容明细列表)
- [获取收藏夹全部内容id](#获取收藏夹全部内容id)
---
## 获取收藏夹内容明细列表
> http://api.bilibili.com/x/v3/fav/resource/list
*请求方式：GET*
认证方式：Cookie或APP
**注：查询权限收藏夹时需要相应用户登录**
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| media_id | num | 目标收藏夹mlid（完整id） | 必要 | |
| tid | num | 分区tid | 非必要 | 默认为全部分区<br />0：全部分区<br />[详见说明](../video/video_zone.md) |
| keyword | str | 搜索关键字 | 非必要 | |
| order | str | 排序方式 | 非必要 | 按收藏时间:mtime<br />按播放量: view<br />按投稿时间：pubtime |
| type | num | 内容类型（？） | 非必要 | 可为0 |
| ps | num | 每页数量 | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| platform | str | 平台标识 | 非必要 | 可为web（影响内容列表类型） |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| data | 有效时：obj<br />无效或：null | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ----- | ------------ | ---- |
| info | obj | 收藏夹元数据 | |
| medias | array | 收藏夹内容 | |
`data`中的`info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------------- | -------------------------------------------------- |
| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 |
| fid | num | 收藏夹原始id | |
| mid | num | 创建者UID | |
| attr | num | 属性 | 0：正常<br />1：失效 |
| 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<br />未收藏收藏夹：0<br />需要登录 |
| like_state | num | 点赞状态 | 已点赞：1<br />未点赞：0<br />需要登录 |
| media_count | num | 收藏夹内容数量 | |
`info`中的`upper`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------- | ----------------------------------------------- |
| mid | num | 创建者UID | |
| name | str | 创建者昵称 | |
| face | str | 创建者头像url | |
| followed | bool | 是否已关注创建者 | |
| vip_type | num | 会员类别 | 0：无<br />1：月大会员<br />2：年度及以上大会员 |
| vip_statue | num | 会员开通状态 | 0：无<br />1：有 |
`info`中的`cnt_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------ | ---- |
| collect | num | 收藏数 | |
| play | num | 播放数 | |
| thumb_up | num | 点赞数 | |
| share | num | 分享数 | |
`data`中的`medias`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---- |
| 0 | obj | 收藏内容1 | |
| n | obj | 收藏内容(n+1) | |
| ... | obj | ... | |
`medias`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ------------------------------------------------------------ |
| id | num | 内容id | 视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| type | num | 内容类型 | 2：视频稿件<br />12：音频<br />21：视频合集 |
| title | str | 标题 | |
| cover | str | 封面url | |
| intro | str | 简介 | |
| page | num | 视频分P数 | |
| duration | num | 音频/视频时长 | |
| upper | obj | UP主信息 | |
| attr | num | 属性位（？） | |
| cnt_info | obj | 状态数 | |
| link | str | 跳转uri | |
| ctime | num | 投稿时间 | 时间戳 |
| pubtime | num | 发布时间 | 时间戳 |
| fav_time | num | 收藏时间 | 时间戳 |
| bv_id | str | 视频稿件bvid | |
| bvid | str | 视频稿件bvid | |
| season | null | （？） | |
`medias`数组中的对象中的`upper`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---- |
| mid | num | UP主UID | |
| name | str | UP主昵称 | |
| face | str | UP主头像url | |
`medias`数组中的对象中的`cnt_info`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------ | ---- |
| collect | num | 收藏数 | |
| play | num | 播放数 | |
| danmaku | num | 弹幕数 | |
**示例：**
查询收藏夹`ID=1052622027`，每页5个视频，第`1`页的内容明细
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \
--data-urlencode 'media_id=1052622027' \
--data-urlencode 'platform=web' \
--data-urlencode 'pn=1' \
--data-urlencode 'ps=5' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"info": {
"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": 184768,
"thumb_up": 3916,
"share": 44
},
"type": 11,
"intro": "猛 男 生 存",
"ctime": 1598884758,
"mtime": 1598884758,
"state": 0,
"fav_state": 0,
"like_state": 0,
"media_count": 28
},
"medias": [
{
"id": 371494037,
"type": 2,
"title": "猛 男 生 存",
"cover": "http://i2.hdslb.com/bfs/archive/bb51ee8a5fc5e03996138155f0f682d30ee16484.jpg",
"intro": "如果大家喜欢我的视频，别忘了点个赞，一键三连，或者关注我的频道哦~\n也可以把我的视频分享给你们的朋友们~\n\n第一集：BV1CZ4y1T7gC\n第二集：BV1oA411a72k\n第三集：BV1fK4y1e7Yj\n第四集：BV1Ya4y1E7Y6\n第五集：BV17V411z75A\n第六集：BV1oi4y137sw\n第七集：BV1Wt4y1D7Uu\n第八集：BV1Bp4y1q7y9\n第九集：BV1Lv411v7G2\n第十集：BV1Xi4y137ER\n第十一集：BV1nC4y1879J\n第十二集：BV1K54y1",
"page": 1,
"duration": 546,
"upper": {
"mid": 686127,
"name": "籽岷",
"face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp"
},
"attr": 0,
"cnt_info": {
"collect": 11256,
"play": 1638040,
"danmaku": 7697
},
"link": "bilibili://video/371494037",
"ctime": 1595690513,
"pubtime": 1595690513,
"fav_time": 1598884777,
"bv_id": "BV1CZ4y1T7gC",
"bvid": "BV1CZ4y1T7gC",
"season": null
},
{
"id": 328991940,
"type": 2,
"title": "猛 男 生 存 2",
"cover": "http://i1.hdslb.com/bfs/archive/aa801612ea0229a08d000a525b715af24cba0964.jpg",
"intro": "如果大家喜欢我的视频，别忘了点个赞，一键三连，或者关注我的频道哦~\n也可以把我的视频分享给你们的朋友们~\n\n第一集：BV1CZ4y1T7gC\n第二集：BV1oA411a72k\n第三集：BV1fK4y1e7Yj\n第四集：BV1Ya4y1E7Y6\n第五集：BV17V411z75A\n第六集：BV1oi4y137sw\n第七集：BV1Wt4y1D7Uu\n第八集：BV1Bp4y1q7y9\n第九集：BV1Lv411v7G2\n第十集：BV1Xi4y137ER\n第十一集：BV1nC4y1879J\n第十二集：BV1K54y1",
"page": 1,
"duration": 644,
"upper": {
"mid": 686127,
"name": "籽岷",
"face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp"
},
"attr": 0,
"cnt_info": {
"collect": 8695,
"play": 1334651,
"danmaku": 6064
},
"link": "bilibili://video/328991940",
"ctime": 1595770876,
"pubtime": 1595770876,
"fav_time": 1598884783,
"bv_id": "BV1oA411a72k",
"bvid": "BV1oA411a72k",
"season": null
},
{
"id": 884042215,
"type": 2,
"title": "猛 男 生 存 3",
"cover": "http://i1.hdslb.com/bfs/archive/f99059637c110dcd1cdae765a946801fbcefe4ab.jpg",
"intro": "如果大家喜欢我的视频，别忘了点个赞，一键三连，或者关注我的频道哦~\n也可以把我的视频分享给你们的朋友们~\n\n第一集：BV1CZ4y1T7gC\n第二集：BV1oA411a72k\n第三集：BV1fK4y1e7Yj\n第四集：BV1Ya4y1E7Y6\n第五集：BV17V411z75A\n第六集：BV1oi4y137sw\n第七集：BV1Wt4y1D7Uu\n第八集：BV1Bp4y1q7y9\n第九集：BV1Lv411v7G2\n第十集：BV1Xi4y137ER\n第十一集：BV1nC4y1879J\n第十二集：BV1K54y1",
"page": 1,
"duration": 703,
"upper": {
"mid": 686127,
"name": "籽岷",
"face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp"
},
"attr": 0,
"cnt_info": {
"collect": 9449,
"play": 1429408,
"danmaku": 8243
},
"link": "bilibili://video/884042215",
"ctime": 1595847079,
"pubtime": 1595847079,
"fav_time": 1598884788,
"bv_id": "BV1fK4y1e7Yj",
"bvid": "BV1fK4y1e7Yj",
"season": null
},
{
"id": 669013980,
"type": 2,
"title": "猛 男 生 存 4",
"cover": "http://i1.hdslb.com/bfs/archive/def0f7009cb9a8b581ee03be9565918ff0c1913d.jpg",
"intro": "如果大家喜欢我的视频，别忘了点个赞，一键三连，或者关注我的频道哦~\n也可以把我的视频分享给你们的朋友们~\n\n第一集：BV1CZ4y1T7gC\n第二集：BV1oA411a72k\n第三集：BV1fK4y1e7Yj\n第四集：BV1Ya4y1E7Y6\n第五集：BV17V411z75A\n第六集：BV1oi4y137sw\n第七集：BV1Wt4y1D7Uu\n第八集：BV1Bp4y1q7y9\n第九集：BV1Lv411v7G2\n第十集：BV1Xi4y137ER\n第十一集：BV1nC4y1879J\n第十二集：BV1K54y1",
"page": 1,
"duration": 895,
"upper": {
"mid": 686127,
"name": "籽岷",
"face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp"
},
"attr": 0,
"cnt_info": {
"collect": 9950,
"play": 1309544,
"danmaku": 13551
},
"link": "bilibili://video/669013980",
"ctime": 1595943988,
"pubtime": 1595943988,
"fav_time": 1598884792,
"bv_id": "BV1Ya4y1E7Y6",
"bvid": "BV1Ya4y1E7Y6",
"season": null
},
{
"id": 414034824,
"type": 2,
"title": "猛 男 生 存 5",
"cover": "http://i2.hdslb.com/bfs/archive/b4844ac89dde221d13bb8ddff80a8c4658bf7dc5.jpg",
"intro": "如果大家喜欢我的视频，别忘了点个赞，一键三连，或者关注我的频道哦~\n也可以把我的视频分享给你们的朋友们~\n\n第一集：BV1CZ4y1T7gC\n第二集：BV1oA411a72k\n第三集：BV1fK4y1e7Yj\n第四集：BV1Ya4y1E7Y6\n第五集：BV17V411z75A\n第六集：BV1oi4y137sw\n第七集：BV1Wt4y1D7Uu\n第八集：BV1Bp4y1q7y9\n第九集：BV1Lv411v7G2\n第十集：BV1Xi4y137ER\n第十一集：BV1nC4y1879J\n第十二集：BV1K54y1",
"page": 1,
"duration": 814,
"upper": {
"mid": 686127,
"name": "籽岷",
"face": "http://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp"
},
"attr": 0,
"cnt_info": {
"collect": 9446,
"play": 1235998,
"danmaku": 9021
},
"link": "bilibili://video/414034824",
"ctime": 1596023668,
"pubtime": 1596023668,
"fav_time": 1598884798,
"bv_id": "BV17V411z75A",
"bvid": "BV17V411z75A",
"season": null
}
],
"has_more": true
}
}
```
</details>
## 获取收藏夹全部内容id
> http://api.bilibili.com/x/v3/fav/resource/ids
*请求方式：GET*
认证方式：Cookie或APP
**注：查询权限收藏夹时需要相应用户登录**
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | --------------------------- |
| media_id | num | 目标收藏夹mlid（完整id） | 必要 | |
| platform | str | 平台标识 | 非必要 | 可为web（影响内容列表类型） |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------------------------------- | ---------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-403：访问权限不足 |
| message | str | 错误信息 | 默认为0 |
| data | 有效时：array<br />无效或：null | 内容id列表 | |
`data`中的`medias`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---- |
| 0 | obj | 收藏内容id1 | |
| n | obj | 收藏内容id(n+1) | |
| ... | obj | ... | |
`medias`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | ------------------------------------------------------------ |
| id | num | 内容id | 视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
| type | num | 内容类型 | 2：视频稿件<br />12：音频<br />21：视频合集 |
| bv_id | str | 视频稿件bvid | |
| bvid | str | 视频稿件bvid | |
**示例：**
查询收藏夹`ID=1052622027`的全部内容id
```shell
curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \
--data-urlencode 'media_id=1052622027' \
--data-urlencode 'platform=web' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"id": 371494037,
"type": 2,
"bv_id": "BV1CZ4y1T7gC",
"bvid": "BV1CZ4y1T7gC"
},
{
"id": 328991940,
"type": 2,
"bv_id": "BV1oA411a72k",
"bvid": "BV1oA411a72k"
},
{
"id": 884042215,
"type": 2,
"bv_id": "BV1fK4y1e7Yj",
"bvid": "BV1fK4y1e7Yj"
},
{
"id": 669013980,
"type": 2,
"bv_id": "BV1Ya4y1E7Y6",
"bvid": "BV1Ya4y1E7Y6"
},
{
"id": 414034824,
"type": 2,
"bv_id": "BV17V411z75A",
"bvid": "BV17V411z75A"
},
{
"id": 541550765,
"type": 2,
"bv_id": "BV1oi4y137sw",
"bvid": "BV1oi4y137sw"
},
{
"id": 626619000,
"type": 2,
"bv_id": "BV1Wt4y1D7Uu",
"bvid": "BV1Wt4y1D7Uu"
},
{
"id": 969124957,
"type": 2,
"bv_id": "BV1Bp4y1q7y9",
"bvid": "BV1Bp4y1q7y9"
},
{
"id": 244079274,
"type": 2,
"bv_id": "BV1Lv411v7G2",
"bvid": "BV1Lv411v7G2"
},
{
"id": 541500006,
"type": 2,
"bv_id": "BV1Xi4y137ER",
"bvid": "BV1Xi4y137ER"
},
{
"id": 796655080,
"type": 2,
"bv_id": "BV1nC4y1879J",
"bvid": "BV1nC4y1879J"
},
{
"id": 839243447,
"type": 2,
"bv_id": "BV1K54y1U77v",
"bvid": "BV1K54y1U77v"
},
{
"id": 329235451,
"type": 2,
"bv_id": "BV13A411e7ad",
"bvid": "BV13A411e7ad"
},
{
"id": 884202228,
"type": 2,
"bv_id": "BV1UK4y1v7K6",
"bvid": "BV1UK4y1v7K6"
},
{
"id": 926710567,
"type": 2,
"bv_id": "BV1BT4y157HK",
"bvid": "BV1BT4y157HK"
},
{
"id": 754200948,
"type": 2,
"bv_id": "BV1qk4y117Uk",
"bvid": "BV1qk4y117Uk"
},
{
"id": 371795957,
"type": 2,
"bv_id": "BV1iZ4y1K7LG",
"bvid": "BV1iZ4y1K7LG"
},
{
"id": 969268280,
"type": 2,
"bv_id": "BV1hp4y1v7mU",
"bvid": "BV1hp4y1v7mU"
},
{
"id": 414281629,
"type": 2,
"bv_id": "BV1xV411U7mm",
"bvid": "BV1xV411U7mm"
},
{
"id": 839319009,
"type": 2,
"bv_id": "BV1t54y1U7hg",
"bvid": "BV1t54y1U7hg"
},
{
"id": 329271769,
"type": 2,
"bv_id": "BV12A411J7JZ",
"bvid": "BV12A411J7JZ"
},
{
"id": 969365400,
"type": 2,
"bv_id": "BV1wp4y1i7U8",
"bvid": "BV1wp4y1i7U8"
},
{
"id": 796831427,
"type": 2,
"bv_id": "BV1yC4y1t7Gb",
"bvid": "BV1yC4y1t7Gb"
},
{
"id": 711972863,
"type": 2,
"bv_id": "BV1YD4y1m7FP",
"bvid": "BV1YD4y1m7FP"
},
{
"id": 754414390,
"type": 2,
"bv_id": "BV1Yk4y127YR",
"bvid": "BV1Yk4y127YR"
},
{
"id": 839478683,
"type": 2,
"bv_id": "BV1i54y127uw",
"bvid": "BV1i54y127uw"
},
{
"id": 499448381,
"type": 2,
"bv_id": "BV19K411N7KE",
"bvid": "BV19K411N7KE"
},
{
"id": 926919797,
"type": 2,
"bv_id": "BV1QT4y1L7Bb",
"bvid": "BV1QT4y1L7Bb"
}
]
}
```
</details>
Reference in New Issue View Git Blame Copy Permalink