github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-14 13:50:06 +08:00
Code Issues Packages Projects Releases Wiki Activity
41d73f1a20
bilibili-API-collect/docs/fav/info.md
Session小胡 60a0c5d1a2
feat: 各种接口补充与错误修正 (#1066) 
* fix(video/collection.md): unclosed xml tags

* feat(video/report.md): uuid not really random

* feat: b23.tv short link

* feat: login/moral/exp log

* feat: v_voucher

* feat: upload video cover & post

* feat(creativecenter/upload.md): upload octet-stream

* feat(creativecenter/upload.md): update some notes

* feat(clientinfo/ip.md): another from live

* feat: live web heartbeat

* feat: update popular series & precious

* fix(creativecenter/upload.md): mistakes in example

* feat: merge duplicate fav info

* feat(README.md): missing link to webmask

* feat(search/hot.md): word_type

* feat(login/login_action): recovery old api

* feat(video/collection.md):  series operation

* feat: video season operation

* feat: add & mod some links

* feat(search/suggest.md): up to date

* feat: web home header image

* feat(misc/sign/bili_ticket.md): demo for nodejs

* feat(creativecenter/upload.md): x-upos-auth validity period

* feat: add referer & buvid3 to request header

* feat: customer service message heartbeat & upload

* feat(customerservice/msg.md): upload code 1200201

* feat(video/report.md): click/web/h5

* feat(video/report.md): view count desc

* feat: laser2

* feat: wbi_key in bili_ticket

* fix: typo & unclosed XML tags

* feat(misc/sign/v_voucher): cookie x-bili-gaia-vtoken

* feat(search/hot.md): square

* feat(video/status_number.md): fold archive_stat/stat

* feat(fav/info.md): resource/infos invalid type 21

* feat: /x/activity/subject/info

* feat: lottery

* feat(docs/misc/b23.tv): remove some unnecessary fields

* feat(creativecenter/upload.md): types/predict

* fix(video/collection.md): invalid end tag

* feat: app version upgrade

* feat(creativecenter/upload.md): tag/recommend #528

* feat(user/status_number.md): navnum

* feat: /x/activity/page/list

* feat(comment/list.md): desc about pagination_str

* feat(comment/list.md): update example

* feat(dynamic/all.md): #1082

* fix(comment/list.md): -352 not -412

* feat: #700

* feat(video/video_stream.md): #606 & cv949156

* feat(message/private_msg.md): single_unread freq

* feat: getUserWallet

* fix: broken form

* feat(Layout.vue): copyright to 2024

* feat: /x/topic/pub/rcmd/search

* feat: #425

* feat(misc/time_stamp.md): rtc/getTimestamp

* fix(misc/time_stamp.md): missing end tag

* feat: #745

* feat(dynamic/all.md): update feed/all

* feat(danmaku/action.md): #220

* feat(live/info.md): gethistory from cv8186413

* fix(danmaku/action.md): missing end tag
2024-08-21 19:02:39 +08:00

23 KiB
Raw Blame History

收藏夹基本信息

获取收藏夹元数据

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

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'
查看响应示例： 
{
  "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 收藏夹属性 转换成8-bit二进制处理
详细说明见下表
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 收藏夹总计视频数

attr属性二进制值表：

其他有待补充... 1：默认收藏夹 0：公开性
0：默认收藏夹
1：其他收藏夹		 0：公开
1：私有

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