import{_ as p,c as t,a as l,b as s,d as a,e,w as c,r as D,o as r}from"./app-Dgsdh8A6.js";const i={};function d(y,n){const o=D("RouteLink");return r(),t("div",null,[n[17]||(n[17]=l('

收藏夹内容

获取收藏夹内容明细列表

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

请求方式:GET

认证方式:Cookie或APP

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

url参数:

',7)),s("table",null,[n[16]||(n[16]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[n[9]||(n[9]=s("tr",null,[s("td",null,"media_id"),s("td",null,"num"),s("td",null,"目标收藏夹mlid(完整id)"),s("td",null,"必要"),s("td")],-1)),s("tr",null,[n[5]||(n[5]=s("td",null,"tid",-1)),n[6]||(n[6]=s("td",null,"num",-1)),n[7]||(n[7]=s("td",null,"分区tid",-1)),n[8]||(n[8]=s("td",null,"非必要",-1)),s("td",null,[n[1]||(n[1]=a("默认为全部分区")),n[2]||(n[2]=s("br",null,null,-1)),n[3]||(n[3]=a("0:全部分区")),n[4]||(n[4]=s("br",null,null,-1)),e(o,{to:"/docs/video/video_zone.html"},{default:c(()=>n[0]||(n[0]=[a("详见说明")])),_:1,__:[0]})])]),n[10]||(n[10]=s("tr",null,[s("td",null,"keyword"),s("td",null,"str"),s("td",null,"搜索关键字"),s("td",null,"非必要"),s("td")],-1)),n[11]||(n[11]=s("tr",null,[s("td",null,"order"),s("td",null,"str"),s("td",null,"排序方式"),s("td",null,"非必要"),s("td",null,[a("按收藏时间:mtime"),s("br"),a("按播放量: view"),s("br"),a("按投稿时间:pubtime")])],-1)),n[12]||(n[12]=s("tr",null,[s("td",null,"type"),s("td",null,"num"),s("td",null,"查询范围"),s("td",null,"非必要"),s("td",null,[a("0:当前收藏夹(对应media_id)"),s("br"),a(" 1:全部收藏夹")])],-1)),n[13]||(n[13]=s("tr",null,[s("td",null,"ps"),s("td",null,"num"),s("td",null,"每页数量"),s("td",null,"必要"),s("td",null,"定义域:1-20")],-1)),n[14]||(n[14]=s("tr",null,[s("td",null,"pn"),s("td",null,"num"),s("td",null,"页码"),s("td",null,"非必要"),s("td",null,"默认为1")],-1)),n[15]||(n[15]=s("tr",null,[s("td",null,"platform"),s("td",null,"str"),s("td",null,"平台标识"),s("td",null,"非必要"),s("td",null,"可为web(影响内容列表类型)")],-1))])]),n[18]||(n[18]=l(`

json回复:

根对象:

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

data对象:

字段类型内容备注
infoobj收藏夹元数据
mediasarray收藏夹内容
has_morebool收藏夹是否有下一页
ttlnum接口返回时间时间戳

data中的info对象:

字段类型内容备注
idnum收藏夹mlid(完整id)收藏夹原始id+创建者mid尾号2位
fidnum收藏夹原始id
midnum创建者mid
attrnum属性0:正常
1:失效
titlestr收藏夹标题
coverstr收藏夹封面图片url
upperobj创建者信息
cover_typenum封面图类别(?)
cnt_infoobj收藏夹状态数
typenum类型(?)一般是11
introstr备注
ctimenum创建时间时间戳
mtimenum收藏时间时间戳
statenum状态(?)一般为0
fav_statenum收藏夹收藏状态已收藏收藏夹:1
未收藏收藏夹:0
需要登录
like_statenum点赞状态已点赞:1
未点赞:0
需要登录
media_countnum收藏夹内容数量

info中的upper对象:

字段类型内容备注
midnum创建者mid
namestr创建者昵称
facestr创建者头像url
followedbool是否已关注创建者
vip_typenum会员类别0:无
1:月大会员
2:年度及以上大会员
vip_statuenum会员开通状态0:无
1:有

info中的cnt_info对象:

字段类型内容备注
collectnum收藏数
playnum播放数
thumb_upnum点赞数
sharenum分享数

data中的medias数组:

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

medias数组中的对象:

字段类型内容备注
idnum内容id视频稿件:视频稿件avid
音频:音频auid
视频合集:视频合集id
typenum内容类型2:视频稿件
12:音频
21:视频合集
titlestr标题
coverstr封面url
introstr简介
pagenum视频分P数
durationnum音频/视频时长
upperobjUP主信息
attrnum失效0: 正常;9: up自己删除;1: 其他原因删除
cnt_infoobj状态数
linkstr跳转uri
ctimenum投稿时间时间戳
pubtimenum发布时间时间戳
fav_timenum收藏时间时间戳
bv_idstr视频稿件bvid
bvidstr视频稿件bvid
seasonnull(?)

medias数组中的对象中的upper对象:

字段类型内容备注
midnumUP主mid
namestrUP主昵称
facestrUP主头像url

medias数组中的对象中的cnt_info对象:

字段类型内容备注
collectnum收藏数
playnum播放数
danmakunum弹幕数

示例:

查询收藏夹id=1052622027,每页5个视频,第1页的内容明细

curl -G 'https://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'
查看响应示例:
{
    "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,
        "ttl": 1703349018
    }
}

获取收藏夹全部内容id

https://api.bilibili.com/x/v3/fav/resource/ids

请求方式:GET

认证方式:Cookie或APP

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

url参数:

参数名类型内容必要性备注
media_idnum目标收藏夹mlid(完整id)必要
platformstr平台标识非必要可为web(影响内容列表类型)

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-400:请求错误
-403:访问权限不足
messagestr错误信息默认为0
data有效时:array
无效或:null
内容id列表

data数组中的对象:

字段类型内容备注
idnum内容id视频稿件:视频稿件avid
音频:音频auid
视频合集:视频合集id
typenum内容类型2:视频稿件
12:音频
21:视频合集
bv_idstr视频稿件bvid
bvidstr视频稿件bvid

示例:

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

curl -G 'https://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"
        }
    ]
}
`,39))])}const C=p(i,[["render",d]]),v=JSON.parse(`{"path":"/docs/fav/list.html","title":"收藏夹内容","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1758034707000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"mizuhokaga","username":"mizuhokaga","email":"mizuhokaga@gmail.com","commits":1,"url":"https://github.com/mizuhokaga"},{"name":"王翼翔","username":"","email":"836250617@qq.com","commits":1},{"name":"linyuansup","username":"linyuansup","email":"li936017978@gmail.com","commits":1,"url":"https://github.com/linyuansup"}],"changelog":[{"hash":"f73870b0b36211623308d3002773154a44a8aa4a","time":1758034707000,"email":"li936017978@gmail.com","author":"linyuansup","message":"Revise 'data' section in list.md documentation (#1402)"},{"hash":"2c4530e2c76c8066ba8431b014cc2683c6ee3499","time":1706455445000,"email":"836250617@qq.com","author":"王翼翔","message":"Update list.md (#952)"},{"hash":"547f07e765c0b92c3e61ad698d36c25032ad63e8","time":1703432668000,"email":"mizuhokaga@gmail.com","author":"mizuhokaga","message":"新增 获取收藏夹内容明细列表API 返回json中data对象字段 (#916)"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/fav/list.md"}`);export{C as comp,v as data};