import{_ as n,c as t,a,o as l}from"./app-Dgsdh8A6.js";const o="data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%201024'%3e%3cpath%20fill='%23F3A034'%20d='M646.6,837.1c-50.8,0-119.6-23.4-204.4-69.5l-0.2-0.1l-0.2,0.1c-84.7,45.8-153.4,69.1-204.2,69.1%20c-36,0-63.8-11.7-82.8-34.6c-17.8-21.5-28.2-53.6-31.1-95.4c-2.9-41.8,1.7-94.5,13.8-156.5l0.1-0.3l-0.2-0.2%20c-53.4-49.2-91.6-94.1-113.6-133.2c-21.9-39.1-28.3-73.6-19-102.7c9.4-29.2,35-53.7,76.1-72.8c41.2-19.1,99.1-33.4,172.1-42.4%20l0.3,0l0.1-0.2c31.3-65.6,63.1-115.6,94.4-148.4C379,17.1,410.7,0.5,441.9,0.5c31.2,0,62.9,16.6,94.1,49.3%20c31.3,32.8,63.1,82.7,94.4,148.4l0.1,0.2l0.3,0c73.2,9,131.2,23.3,172.5,42.4c41.2,19.1,66.9,43.6,76.2,72.9%20c9.3,29,2.9,63.6-19.1,102.6c-22.1,39.2-60.4,84-113.9,133.2l-0.2,0.2l0.1,0.3c12,62.2,16.7,115,13.8,156.9%20c-2.9,41.8-13.4,74-31.2,95.5C710.1,825.4,682.4,837.1,646.6,837.1z'/%3e%3c/svg%3e",p={};function e(d,s){return l(),t("div",null,s[0]||(s[0]=[a('

收藏夹基本信息

获取收藏夹元数据

https://api.bilibili.com/x/v3/fav/folder/info

请求方式：GET

认证方式：Cookie(SESSDATA) 或 APP

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

url参数：

参数名类型内容必要性备注
media_idnum目标收藏夹id（完整id）必要

json回复：

根对象：

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

data对象：

字段类型内容备注
idnum收藏夹mlid（完整id）收藏夹原始id+创建者mid尾号2位
fidnum收藏夹原始id
midnum创建者mid
attrnum属性位（？）
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收藏夹内容数量

data中的upper对象：

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

data中的cnt_info对象：

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

示例：

查询收藏夹id=1052622027的元数据

curl -G 'https://api.bilibili.com/x/v3/fav/folder/info' \\
--data-urlencode 'media_id=1052622027' \\
-b 'SESSDATA=xxx'
查看响应示例：
{
    "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_midnum目标用户mid必要
typenum目标内容属性非必要默认为全部
0：全部
2：视频稿件
ridnum目标内容id非必要视频稿件：视频稿件avid
web_locationstr333.1387非必要

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-400：请求错误
messagestr错误信息默认为0
ttlnum1
data隐藏时：null
公开时：obj		信息本体

data对象：

字段类型内容备注
countnum创建的收藏夹数
list无收藏夹时：null
有收藏夹时：array		收藏夹列表
seasonnull（？）

data中的list数组：

项类型内容备注
0obj收藏夹1
nobj收藏夹(n+1)项数取决于count的值
……obj……

data中的list数组中的对象：

字段类型内容备注
idnum收藏夹mlid（完整id）收藏夹原始id+创建者mid尾号2位
fidnum收藏夹原始id
midnum创建者mid
attrnum收藏夹属性二进制位属性
详细说明见下表
titlestr收藏夹标题
fav_statenum目标id是否存在于该收藏夹存在于该收藏夹：1
不存在于该收藏夹：0
media_countnum收藏夹内容数量

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'
查看响应示例：
{
  "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参数：

参数名类型内容必要性备注
psnum每页项数必要定义域 1 - 大于70
pnnum页码必要
up_midnum目标用户mid必要
platformstr平台类型非必要填写web 返回值才会包含用户收藏的视频合集

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-101：账号未登录
-111：csrf校验失败
40022：签名过长
messagestr错误信息默认为0
ttlnum1
data隐藏时：null
公开时：obj		信息本体

data对象：

字段类型内容备注
countnum创建的收藏夹数
list无收藏夹时：null
有收藏夹时：array		收藏夹列表

data中的list数组：

项类型内容备注
0obj收藏夹1
nobj收藏夹(n+1)项数取决于count的值
……obj……

data中的list数组中的对象：

字段类型内容备注
idnum收藏夹ml
fidnum原始收藏夹mlid去除两位mid尾号
midnum创建用户mid
attrnum收藏夹属性同上 attr
titlestr收藏夹标题
coverstr收藏夹封面图片url
upperobj收藏夹创建用户信息
cover_typenum2作用尚不明确
introstr空作用尚不明确
ctimenum创建时间时间戳
mtimenum审核时间时间戳
statenum0, 10: 正常；1:收藏夹已失效
fav_statenum0作用尚不明确
media_countnum收藏夹总计视频数

data中的list数组中的对象中的upper对象：

字段类型内容备注
midnum创建人mid
namestr创建人昵称
facestr空作用尚不明确

示例：

查询用户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'
查看响应示例：
{
  "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参数：

参数名类型内容必要性备注
resourcesstrs目标内容id列表必要格式：{内容id}:{内容类型}
每个成员间用,分隔
类型：
2：视频稿件
12：音频
内容id：
视频稿件：视频稿件avid
音频：音频auid
platformstr平台标识非必要可为web（影响内容列表类型）

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
-400：请求错误
messagestr错误信息默认为0
data有效时：array
无效或：null		内容信息列表

data数组：

项类型内容备注
0obj内容信息1
nobj内容信息（n+1）
...obj...

data数组中的对象：

字段类型内容备注
idnum内容id视频稿件：视频稿件avid
音频：音频auid
typenum内容类型2：视频稿件
12：音频
titlestr标题
coverstr封面url
introstr简介
pagenum视频分P数
durationnum音频/视频时长
upperobjUP主信息
attrnum属性0：正常
1：失效
cnt_infoobj状态数
linkstr跳转uri
ctimenum投稿时间时间戳
pubtimenum发布时间时间戳
fav_timenum收藏时间时间戳
bv_idstr视频稿件bvid
bvidstr视频稿件bvid
seasonnull（？）

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

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

data数组中的对象中的cnt_info对象：

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

示例：

批量查询内容

1-视频稿件-av583785685

2-音频-au15664

curl -G 'https://api.bilibili.com/x/v3/fav/resource/infos' \\
--data-urlencode 'resources=583785685:2,15664:12'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": [
    {
      "id": 583785685,
      "type": 2,
      "title": "已失效视频",
      "cover": "http://i0.hdslb.com/bfs/archive/be27fd62c99036dce67efface486fb0a88ffed06.jpg",
      "intro": "审核君辛苦了~\\r\\n使用curl命令访问B站api，实现二维码登录 查询登录信息 视频投币 发送评论的操作\\r\\n本视频作为api收集项目的一个硬核DEMO\\r\\n由于当时录音的问题，大部分是后期配的，后面声音有点小\\r\\n想了解更多的去github页面，也可以qq\\r\\n\\r\\nbgm：\\r\\n雲流れ\\r\\nAutumn rain（未修改版）\\r\\n四月，初雨微凉",
      "page": 1,
      "duration": 604,
      "upper": {
        "mid": 293793435,
        "name": "社会易姐QwQ",
        "face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
      },
      "attr": 1,
      "cnt_info": {
        "collect": 1470,
        "play": 28374,
        "danmaku": 64
      },
      "link": "bilibili://video/583785685",
      "ctime": 1594049831,
      "pubtime": 1594049831,
      "fav_time": 0,
      "bv_id": "BV1kz4y1X7XP",
      "bvid": "BV1kz4y1X7XP",
      "season": null
    },
    {
      "id": 523,
      "type": 21,
      "title": "2021哔哩哔哩拜年纪",
      "cover": "https://i0.hdslb.com/bfs/archive/8ccc50f7cbc671762e0536491bd2b8aeebc0837d.jpg",
      "intro": "感谢各位制作者们的辛勤付出！节目精彩，愿大家看的开心！",
      "page": 0,
      "duration": 0,
      "upper": {
        "mid": 1868902080,
        "name": "哔哩哔哩拜年纪",
        "face": "http://i0.hdslb.com/bfs/face/7f6cb94fc071aca9fbb4b1ca9cc6415e86847576.jpg"
      },
      "attr": 0,
      "cnt_info": {
        "collect": 0,
        "play": 71527018,
        "danmaku": 480547
      },
      "link": "bilibili://video/373561162",
      "ctime": 0,
      "pubtime": 0,
      "fav_time": 0,
      "bv_id": "",
      "bvid": "",
      "season": null
    },
    {
      "id": 15664,
      "type": 12,
      "title": "威风堂堂",
      "cover": "http://i0.hdslb.com/bfs/music/c417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg",
      "intro": "翻唱。在电脑里放了半个月终于！！！大家寒假快乐！！❁本家sm19233263；❁压制: 寒雨；❁mix: 三星堆；❁vocal: 茶理理。超喜欢michan的那段英文念白所以加了进来w 谢谢三月月和嘟比比你们后期辛苦了！",
      "page": 1,
      "duration": 200,
      "upper": {
        "mid": 684169,
        "name": "茶理理理子",
        "face": ""
      },
      "attr": 0,
      "cnt_info": {
        "collect": 48872,
        "play": 1508426,
        "danmaku": 0
      },
      "link": "bilibili://music/detail/15664?name=%E5%A8%81%E9%A3%8E%E5%A0%82%E5%A0%82&uperName=%E8%8C%B6%E7%90%86%E7%90%86%E7%90%86%E5%AD%90&cover_url=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Fmusic%2Fc417d30b394a8a5d4e8a150ad75837dbae3b79d4.jpg&upperId=684169&author=%E8%8C%B6%E7%90%86%E7%90%86",
      "ctime": 1502347604,
      "pubtime": 1502347604,
      "fav_time": 0,
      "bv_id": "BV1bx411c7qt",
      "bvid": "BV1bx411c7qt",
      "season": null
    }
  ]
}
`,86)]))}const c=n(p,[["render",e]]),i=JSON.parse('{"path":"/docs/fav/info.html","title":"收藏夹基本信息","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1738911583000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"Shiokiri","username":"Shiokiri","email":"xluoying2017@gmail.com","commits":1,"url":"https://github.com/Shiokiri"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":4,"url":"https://github.com/SessionHu"}],"changelog":[{"hash":"f0b3191d0e7c13d9ac4a9277c5a8aca6fb4686c1","time":1738911583000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat(fav/info.md): list-all urlparam web_location"},{"hash":"1e007cc855348d96590131e67e76fe2834d095ee","time":1738910166000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"fix(fav/info.md): list-all attr"},{"hash":"60a0c5d1a2f44fe61335da04571305fa7727a968","time":1724238159000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 各种接口补充与错误修正 (#1066)"},{"hash":"18c1efbc102ae6b44c8f5314c90e5e64f0d926cd","time":1721909032000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: bili_ticket 算法 Java 实现 及 信息补充 及 错误修正 (#1061)"},{"hash":"0e8f12d9b71a381dcdb5710657b185c5cfa6f054","time":1713278867000,"email":"xluoying2017@gmail.com","author":"Shiokiri","message":"fix: typo (#1003)"},{"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/info.md"}');export{c as comp,i as data};