github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-03-27 08:30:12 +08:00
Code Issues Packages Projects Releases Wiki Activity
6f235ba1ec
bilibili-API-collect/fav/list.md
SocialSisterYi c84e72504e 勘误并添加了大量【收藏夹】相关接口
2021-02-27 16:33:41 +08:00

24 KiB
Raw Blame History

收藏夹内容

获取收藏夹内容明细列表

http://api.bilibili.com/x/v3/fav/resource/list

请求方式：GET

认证方式：Cookie或APP

注：查询权限收藏夹时需要相应用户登录

url参数：

参数名 类型 内容 必要性 备注
media_id num 目标收藏夹mlid（完整id） 必要
tid num 分区tid 非必要 默认为全部分区
0：全部分区
详见说明
keyword str 搜索关键字 非必要
order str 排序方式 非必要 按收藏时间:mtime
按播放量: view
按投稿时间：pubtime
type num 内容类型（？） 非必要 可为0
ps num 每页数量 必要
pn num 页码 非必要 默认为1
platform str 平台标识 非必要 可为web（影响内容列表类型）

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
-403：访问权限不足
message str 错误信息 默认为0
data 有效时：obj
无效或：null		 信息本体

data对象：

字段 类型 内容 备注
info obj 收藏夹元数据
medias array 收藏夹内容

data中的info对象：

字段 类型 内容 备注
id num 收藏夹mlid（完整id） 收藏夹原始id+创建者UID尾号2位
fid num 收藏夹原始id
mid num 创建者UID
attr num 属性 0：正常
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
未收藏收藏夹：0
需要登录
like_state num 点赞状态 已点赞：1
未点赞：0
需要登录
media_count num 收藏夹内容数量

info中的upper对象：

字段 类型 内容 备注
mid num 创建者UID
name str 创建者昵称
face str 创建者头像url
followed bool 是否已关注创建者
vip_type num 会员类别 0：无
1：月大会员
2：年度及以上大会员
vip_statue num 会员开通状态 0：无
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
音频：音频auid
视频合集：视频合集id
type num 内容类型 2：视频稿件
12：音频
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页的内容明细

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'
查看响应示例： ```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 } } ```

获取收藏夹全部内容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：成功
-400：请求错误
-403：访问权限不足
message str 错误信息 默认为0
data 有效时：array
无效或：null		 内容id列表

data中的medias数组：

项 类型 内容 备注
0 obj 收藏内容id1
n obj 收藏内容id(n+1)
... obj ...

medias数组中的对象：

字段 类型 内容 备注
id num 内容id 视频稿件：视频稿件avid
音频：音频auid
视频合集：视频合集id
type num 内容类型 2：视频稿件
12：音频
21：视频合集
bv_id str 视频稿件bvid
bvid str 视频稿件bvid

示例：

查询收藏夹ID=1052622027的全部内容id

curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \
--data-urlencode 'media_id=1052622027' \
--data-urlencode 'platform=web' \
-b 'SESSDATA=xxx'
查看响应示例： 
{
    "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"
        }
    ]
}