import{_ as d,c as r,a as e,b as n,d as a,e as l,w as o,r as c,o as i}from"./app-Dgsdh8A6.js";const D="data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%20953.46%20738.35'%3e%3cpath%20fill='%239FA0A0'%20d='M675.64,504c106.67-2.67,186.33-78.33,189-181c-1.33-77.33-49-143.33-125-170%20c-38.96-14.98-18.21-73.06,21-61c101.33,37.33,166.67,124.33,168,231c0,88-45.33,162-116,206c49.33,18.67,93,46,131,82%20c29.48,29.48-13.97,73.03-44,46c-61.33-57.33-140-89-224-89C633.92,568,633.92,504,675.64,504z%20M193.64,572%20c-97.33-53.33-159.67-150-161-266c2-86.67,32.83-158.83,92.5-216.5S259.64,2,349.64,0c89.33,2,163.83,31.83,223.5,89.5%20c59.67,57.67,90.83,129.83,93.5,216.5c-1.33,116-63.33,212.67-162,266c69.33,23.33,130.67,60,184,110c27.73,30.81-14.42,74.52-45,47%20c-80-76-183.33-118-294-118s-215,42-295,118c-29.5,29.5-75.63-17.63-44-47C63.31,632,124.31,595.33,193.64,572z%20M349.64,548%20c72-2,131.67-25.83,179-71.5c47.33-45.67,72-102.5,74-170.5c-2-68.67-26.67-125.67-74-171c-47.33-45.33-107-69-179-71%20c-72,2-131.83,25.67-179.5,71s-72.17,102.33-73.5,171c1.33,68,25.83,124.83,73.5,170.5S277.64,546,349.64,548z'/%3e%3c/svg%3e",u="data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='utf-8'?%3e%3c!--%20Generator:%20Adobe%20Illustrator%2024.1.1,%20SVG%20Export%20Plug-In%20.%20SVG%20Version:%206.00%20Build%200)%20--%3e%3csvg%20version='1.1'%20id='图层_1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%20x='0px'%20y='0px'%20viewBox='0%200%20244.04%2055.01'%20enable-background='new%200%200%20244.04%2055.01'%20xml:space='preserve'%3e%3cpath%20fill='%2319AAD5'%20d='M5.39,55.01h233.26c2.98,0,5.39-2.41,5.39-5.39V5.39c0-2.98-2.41-5.39-5.39-5.39L5.39,0%20C2.41,0,0,2.41,0,5.39l0,44.22C0,52.6,2.41,55.01,5.39,55.01z'/%3e%3cpath%20fill='%23FFFFFF'%20d='M79.26,24.77V8.37c0.08-1.52,1.22-2.68,2.73-2.68s2.66,1.16,2.73,2.68v16.4h16.4%20c1.52,0.08,2.68,1.22,2.68,2.73c0,1.52-1.16,2.66-2.68,2.73h-16.4v16.4c-0.08,1.52-1.22,2.68-2.73,2.68s-2.66-1.16-2.73-2.68v-16.4%20h-16.4c-1.52-0.08-2.68-1.22-2.68-2.73c0-1.52,1.16-2.66,2.68-2.73H79.26z'/%3e%3cg%3e%3cpath%20fill='%23FFFFFF'%20d='M105.14,44.25c9.46-3.33,15.11-8.12,16.93-14.37h-16.13V26.9h16.71c0.05-0.56,0.08-3.05,0.08-7.48h-14.45%20v-2.98h9.5c-2.27-2.47-4.21-4.45-5.82-5.95l2.3-2.04c2.27,2.01,4.34,3.93,6.22,5.76l-2.53,2.23h9.44c2.05-2.86,3.85-5.53,5.4-8.03%20l3.29,1.8c-1.82,2.3-3.5,4.37-5.03,6.23h10.02v2.98h-14.97c0,3.84-0.02,6.33-0.06,7.48h17.36v2.98h-16.81%20c3.1,6.57,8.94,11.07,17.52,13.51c-1.08,1.1-2.06,2.15-2.93,3.17c-8.13-3.13-13.65-7.84-16.57-14.13%20c-2.15,6.11-7.87,10.99-17.16,14.64C106.75,46.18,105.99,45.24,105.14,44.25z'/%3e%3cpath%20fill='%23FFFFFF'%20d='M147.35,19.11c1.9,1.31,4.24,3.08,7.01,5.33c-0.98,1.1-1.76,1.94-2.34,2.54c-2.77-2.51-4.99-4.39-6.65-5.64%20L147.35,19.11z%20M150.92,30.39c1.08,0.47,2.13,0.9,3.13,1.29c-1.45,4.59-2.97,9.61-4.55,15.04l-3.41-1.17%20C147.75,41.08,149.36,36.03,150.92,30.39z%20M148.86,8.97c2.56,1.91,4.84,3.81,6.85,5.72c-0.9,0.89-1.69,1.68-2.38,2.39%20c-1.42-1.49-3.59-3.47-6.49-5.95L148.86,8.97z%20M155.15,41.67h13.3V30.55h-10.29v-2.98h10.29v-9.48h-11.4v-2.98h12.63%20c-1.24-1.94-2.51-3.72-3.8-5.33l2.61-1.64c1.77,2.04,3.17,3.84,4.2,5.4l-2.47,1.57h13.29v2.98h-11.72v9.48h10.29v2.98h-10.29v11.12%20h12.83v2.98h-29.46V41.67z'/%3e%3c/g%3e%3c/svg%3e",p="data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='utf-8'?%3e%3c!--%20Generator:%20Adobe%20Illustrator%2024.1.1,%20SVG%20Export%20Plug-In%20.%20SVG%20Version:%206.00%20Build%200)%20--%3e%3csvg%20version='1.1'%20id='图层_1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%20x='0px'%20y='0px'%20viewBox='0%200%20838%20838'%20enable-background='new%200%200%20838%20838'%20xml:space='preserve'%3e%3cpath%20fill='%231497C7'%20d='M419,838c-118.67-3.33-217.33-44.33-296-123S3.33,537.67,0,419c3.33-118.67,44.33-217.33,123-296%20S300.33,3.33,419,0c118.67,3.33,217.33,44.33,296,123s119.67,177.33,123,296c-3.33,118.67-44.33,217.33-123,296%20S537.67,834.67,419,838z%20M372,372H233v94h139v139h94V466h139v-94H466V233h-94V372z'/%3e%3cg%3e%3c/g%3e%3cg%3e%3c/g%3e%3cg%3e%3c/g%3e%3cg%3e%3c/g%3e%3cg%3e%3c/g%3e%3cg%3e%3c/g%3e%3c/svg%3e",y="data:image/svg+xml,%3csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%20844%20844'%3e%3cpath%20fill='%23A0A0A0'%20d='M269,697V286c0-12,9.67-22,23-22c13.33,0,30,10,30,22v411c0,13.33-16.67,23-30,23%20C278.67,720,269,710.33,269,697z%20M391,697V286c0-27.72,50.75-29.26,54,0v411c-1.33,13.33-16.67,23-30,23%20C401.67,720,392.33,710.33,391,697z%20M522,697V286c0-12,9.67-22,23-22s30,10,30,22v411c0,13.33-16.67,23-30,23S522,710.33,522,697z%20M644,759l40-565H164l36,549c0,20,7.33,44.33,46,47h375C634.33,790,641.33,781.67,644,759z%20M622,844H230%20c-54.67-2.67-82.67-39.33-84-70l-36-580H23c-12,0-23-10.67-23-24c0-13.33,9.67-30,23-30h215V55c1.33-38.67,30.33-55,61-55h246%20c13.33,0,27.33,1.33,46,24c14.67,17.33,15,27.33,15,38v78h215c13.33,0,23,16.67,23,30c0,13.33-11,24-23,24h-86l-39,597%20C694.67,807,672.67,841.33,622,844z%20M530,55H318c-18.67,0-27.33,11.67-26,29v56h260V84C552,65.33,539.33,55,530,55z'/%3e%3c/svg%3e",v={};function b(C,s){const t=c("RouteLink");return i(),r("div",null,[s[24]||(s[24]=e('
以下说明中的 “目标用户” 指被查询的用户,“对方” 指返回的关系列表中的用户。
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 用户 mid | |
| attribute | num | 对方对于自己的关系属性 | 0:未关注 2:已关注 6:已互粉 128:已拉黑 |
| mtime | num | 对方关注目标用户时间 | 秒级时间戳 互关后刷新 |
| tag | 默认分组:null 存在至少一个分组:array | 目标用户将对方分组到的 id | |
| special | num | 目标用户特别关注对方标识 | 0:否 1:是 |
| contract_info | obj | 契约计划相关信息 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| face_nft | num | 是否为 NFT 头像 | 0:非 NFT 头像 1:NFT 头像 |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| name_render | 有效时:obj 无效时:null | 昵称渲染信息 | |
| nft_icon | str | (?) | |
| rec_reason | str | 推荐该用户的原因 | 大多数情况下为空;如:xxx关注了TA、xx粉丝 xx视频 |
| track_id | str | 内部记录id | 大多数情况下为空;如:up_rec_0.router-main-2021485-5f84c987cf-dv8fg.1746380060327.607 |
| follow_time | str | (?) |
list中的对象中的tag数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | num | 位于分组 1 的分组 id | |
| n | num | 位于分组(n+1)的分组 id | |
| …… | num | …… | …… |
list中的对象中的contract_info对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| is_contract | bool | 目标用户是否为对方的契约者 | 仅当为 true 时才有此项 |
| is_contractor | bool | 对方是否为目标用户的契约者 | 仅当为 true 时才有此项 |
| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 is_contractor 项的值为 true 时才有此项 |
| user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉 否则为原始粉丝 仅当有特殊属性时才有此项 |
list中的对象中的official_verify对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| type | num | 用户认证类型 | -1:无 0:UP 主认证 1:机构认证 |
| desc | str | 用户认证信息 | 无为空 |
list中的对象中的vip对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| vipType | num | 会员类型 | 0:无 1:月度大会员 2:年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | (?) | |
| accessStatus | num | (?) | |
| vipStatus | num | 大会员状态 | 0:无 1:有 |
| vipStatusWarn | str | (?) | |
| themeType | num | (?) | |
| label | obj | (?) |
vip中的label对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| path | str | (?) |
请求方式:GET
认证方式:Cookie(SESSDATA)
本接口只有登录、标头 referer 为 bilibili.com 下的子域名、UA 不含 python 时才会返回列表
from=main 且目标用户为自己时,返回列表按照智能推荐算法排序,仅返回前 1000 名粉丝,且返回的列表中不含 mtime 字段url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| vmid | num | 目标用户 mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 |
| offset | str | 偏移量 | 非必要 | 从上次请求的响应数据中的 data.offset 获取此项有效且不为 rcmd 时会从此偏移量开始返回粉丝列表,忽略参数 pn |
| last_access_ts | num | 上次访问粉丝列表的时间 | 非必要 | 秒级时间戳,从获取自己粉丝列表的未读状态接口获取 当按照智能推荐算法排序时,会优先展示此时间后关注的粉丝 |
| from | str | 请求来源 | 非必要 | 当为 main 且目标用户为自己时,粉丝列表按照智能推荐算法排序,此时响应数据中的 data.list 的成员中的 rec_reason 与 track_id 为非空 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -352:请求被拦截 -400:请求错误 22118:由于该用户隐私设置,粉丝列表不可见 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| offset | str | 偏移量 | 供下次请求使用 普通: {列表最后的粉丝的 mtime}:{列表最后的粉丝的 mid}智能推荐算法: rcmd |
| re_version | num | (?) | |
| total | num | 粉丝总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 粉丝 1 | 详见 关系列表对象 |
| n | obj | 粉丝 (n+1) | |
| …… | obj | …… | …… |
示例:
获取用户mid=293793435的粉丝明细
curl -G 'https://api.bilibili.com/x/relation/fans' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 289796932,
"attribute": 0,
"mtime": 1746199088,
"tag": null,
"special": 0,
"contract_info": {},
"uname": "Astlinga_星灵",
"face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg",
"sign": "",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1734278400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": "",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
},
{
"mid": 3494375621396821,
"attribute": 0,
"mtime": 1746098997,
"tag": null,
"special": 0,
"contract_info": {},
"uname": "JSRCode",
"face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg",
"sign": "一个喜欢码代码的高中牲",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": "",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
}
],
"offset": "1746098997:3494375621396821",
"re_version": 0,
"total": 3776
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
本接口只有登录、标头 referer 为 bilibili.com 下的子域名、UA 不含 python 时才会返回列表
本接口仅可返回前 1000 名粉丝,若继续往后查询则返回空列表
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | num | 目标用户 mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 仅可查看前 1000 名粉丝 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -352:请求被拦截 -400:请求错误 22118:由于该用户隐私设置,粉丝列表不可见 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 粉丝总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 粉丝 1 | 详见 关系列表对象 |
| n | obj | 粉丝 (n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
获取用户mid=293793435的粉丝明细
curl -G 'https://api.bilibili.com/x/relation/followers' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 289796932,
"attribute": 0,
"mtime": 1746199088,
"tag": null,
"special": 0,
"contract_info": {},
"uname": "Astlinga_星灵",
"face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg",
"sign": "",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1734278400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": "",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
},
{
"mid": 3494375621396821,
"attribute": 0,
"mtime": 1746098997,
"tag": null,
"special": 0,
"contract_info": {},
"uname": "JSRCode",
"face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg",
"sign": "一个喜欢码代码的高中牲",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": "",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
}
],
"re_version": 0,
"total": 3776
}
}https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/follower_list
请求方式:GET
认证方式:无
返回目标用户前100个粉丝
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| vmid | num | 目标用户 mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 20 |
| pn | num | 页码 | 非必要 | 默认为 1 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| ts | num | 时间戳 |
data.list对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 用户mid | |
| uname | str | 用户名 | |
| face | str | 头像 | |
| attribute | num |
示例:
curl 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/follower_list?vmid=504140200&pn=5&ps=21'{
"code": 0,
"data": {
"list": [
{
"mid": "3493078644034173",
"attribute": 0,
"uname": "雨天下小雪啦",
"face": "//i0.hdslb.com/bfs/face/28ad110baa58db9265eca657fcba501589981555.jpg",
"attestation_display": {
"type": 0,
"desc": ""
}
},
{
"mid": "1356049904",
"attribute": 0,
"uname": "一埋子",
"face": "//i2.hdslb.com/bfs/face/84356fd3b183284bc11b011b676432badb4096bf.jpg",
"attestation_display": {
"type": 0,
"desc": ""
}
},
]
},
"ts": 1748829553371,
"request_id": "0684785391344bdc85e4e701bed41b1c"
}请求方式:GET
认证方式:Cookie(SESSDATA)
调用此接口后会重置未读状态
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| count | num | 自上次访问后新增的粉丝个数 | |
| time | num | 上次访问粉丝列表时间 | 秒级时间戳;当没有新增粉丝时为 0 |
示例:
curl 'https://api.bilibili.com/x/relation/followers/unread/count' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 55,
"time": 1743677191
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
本接口只有登录、标头 referer 为 bilibili.com 下的子域名、UA 不含 python 时才会返回列表
登录可看当前用户全部,其他用户仅可查看前 100 个,访问超过 100 个时返回空列表(但 code 值为 0)
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | num | 目标用户 mid | 必要 | |
| order_type | str | 排序方式 | 非必要 | 当目标用户为自己时有效 按照关注顺序排列:留空 按照最常访问排列:attention |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 其他用户仅可查看前 100 个 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -352:请求被拦截 -400:请求错误 22115:用户已设置隐私,无法查看 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 关注总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 关注1 | 见 关系列表对象 |
| n | obj | 关注(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
获取用户mid=293793435的关注明细,按照关注顺序
curl -G 'https://api.bilibili.com/x/relation/followings' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'order_type=' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [{
"mid": 14082,
"attribute": 2,
"mtime": 1584271945,
"tag": null,
"special": 0,
"contract_info": {},
"uname": "山新",
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
"sign": "都说了是天依爹地,不是妈咪。\\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~",
"official_verify": {
"type": 0,
"desc": "配音演员、声优。洛天依声源提供者。"
},
"vip": {
"vipType": 2,
"vipDueDate": 1601654400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
}, {
"mid": 420831218,
"attribute": 2,
"mtime": 1584208169,
"tag": [207542],
"special": 0,
"contract_info": {},
"uname": "支付宝Alipay",
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"sign": "阿支来了,关注点赞转发投币四连走起!",
"official_verify": {
"type": 1,
"desc": "支付宝官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1585065600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"name_render": {},
"nft_icon": "",
"rec_reason": "",
"track_id": "",
"follow_time": ""
}],
"re_version": 0,
"total": 1028
}
}请求方式:GET
仅可查看前 5 页,对于已设置可见性隐私关注列表的用户,响应数据中的 data.list 为 null,且 data.total 为0
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| vmid | num | 目标用户 mid | 必要 | |
| order | str | 排序方式 | 非必要 | 按照降序排列:desc 按照升序排列:asc 默认降序排列 |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 仅可查看前 5 页 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -400:请求错误 22007:访问超过 5 页 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 关注总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 关注 1 | 与 关系列表对象 数据结构不同 |
| n | obj | 关注(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
数组list中的对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 用户 mid | |
| attribute | num | 关注属性 | 0:未关注 2:已关注 6:已互粉 |
| mtime | num | 关注对方时间 | 时间戳 互关后刷新 |
| tag | 默认分组:null 存在至少一个分组:array | 分组 id | |
| special | num | 特别关注标志 | 0:否 1:是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像 url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| live | num | 是否直播 | 0:未直播 1:直播中 |
数组list中的对象中的tag数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | num | 位于分组 1 的分组 id | |
| n | num | 位于分组(n+1)的分组 id | |
| …… | num | …… | …… |
list中的对象中的official_verify对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| type | num | 用户认证类型 | -1:无 0:UP主认证 1:机构认证 |
| desc | str | 用户认证信息 | 无为空 |
list中的对象中的vip对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| vipType | num | 会员类型 | 0:无 1:月度大会员 2:年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | (?) | |
| accessStatus | num | (?) | |
| vipStatus | num | 大会员状态 | 0:无 1:有 |
| vipStatusWarn | str | (?) | |
| themeType | num | (?) | |
| label | obj | (?) |
vip中的label对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| path | str | (?) |
示例:
获取用户mid=293793435的关注明细,按照关注顺序
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [{
"mid": 14082,
"attribute": 2,
"mtime": 1584271945,
"tag": null,
"special": 0,
"uname": "山新",
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
"sign": "都说了是天依爹地,不是妈咪。\\r私信有点多回复不过来~商业合作啥的请移步Weibo私信@山新 哦哦哦~",
"official_verify": {
"type": 0,
"desc": "配音演员、声优。洛天依声源提供者。"
},
"vip": {
"vipType": 2,
"vipDueDate": 1601654400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
},
"live": 0
}, {
"mid": 420831218,
"attribute": 2,
"mtime": 1584208169,
"tag": [207542],
"special": 0,
"uname": "支付宝Alipay",
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"sign": "阿支来了,关注点赞转发投币四连走起!",
"official_verify": {
"type": 1,
"desc": "支付宝官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1585065600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
},
"live": 0
}],
"re_version": 3228575555,
"total": 699
}
}https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
请求方式:GET
对于设置了可见性隐私关注列表的用户会返回空列表
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20 |
| pn | num | 页码 | 非必要 | 默认为1 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -400:请求错误 |
| message | str | 错误信息 | 成功时无此项 |
| data | obj | 信息本体 | 失败时无此项 |
| ts | num | 当前时间戳 | 单位为毫秒 |
| request_id | str | 请求id |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组list中的对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | str | 用户mid | |
| attribute | num | 对方对于目标用户的关注属性 | 0:未关注 2:已关注 6:已互粉 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| attention_display | obj | 用户认证信息 |
attention_display对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| type | num | 是否认证 | 0:无 1:UP主专业认证 2:UP主认证 3:机构认证 |
| desc | str | 认证信息 |
示例:
获取用户mid=293793435的关注明细
curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1'{
"code": 0,
"data": {
"list": [{
"mid": "14082",
"attribute": 2,
"uname": "山新",
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
"attestation_display": { "type": 0, "desc": "" }
}, {
"mid": "420831218",
"attribute": 2,
"uname": "支付宝Alipay",
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"attestation_display": { "type": 3, "desc": "bilibili机构认证:支付宝官方账号" }
}]
},
"ts": 1677410818395,
"request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | str | 目标用户 mid | 必要 | |
| name | str | 搜索关键词 | 非必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 |
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -400:请求错误 22007:访问超过 5 页 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 关注总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 匹配项目 1 | 见 关系列表对象 |
| n | obj | 匹配项目(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
搜索我的关注列表中关键词warma
curl -G 'https://api.bilibili.com/x/relation/followings/search' \\
--data-urlencode 'vmid=293793435' \\
--data-urlencode 'name=warma' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 53456,
"attribute": 2,
"mtime": 1586415053,
"tag": [-10],
"special": 1,
"uname": "Warma",
"face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
"sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ",
"official_verify": {
"type": 0,
"desc": "bilibili 知名UP主"
},
"vip": {
"vipType": 2,
"vipDueDate": 1637424000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"total": 1
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | num | 目标用户 mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 关注总数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 共同关注 1 | 见 关系列表对象 |
| n | obj | 共同关注(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
获取自己与用户mid=2的共同关注明细
curl -G 'https://api.bilibili.com/x/relation/same/followings' \\
--data-urlencode 'vmid=2' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 116683,
"attribute": 2,
"mtime": 1564627532,
"tag": null,
"special": 0,
"uname": "=咬人猫=",
"face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg",
"sign": "面瘫女仆酱~小粗腿~事业线什么的!!吐槽你就输了!喵~",
"official_verify": {
"type": 0,
"desc": "bilibili 2019百大UP主、高能联盟成员"
},
"vip": {
"vipType": 2,
"vipDueDate": 1618934400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
},
{
"mid": 517717593,
"attribute": 2,
"mtime": 1592126052,
"tag": [207542],
"special": 0,
"uname": "上海爱丽丝幻乐团",
"face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg",
"sign": "日本同人社团 上海爱丽丝幻乐团",
"official_verify": {
"type": 0,
"desc": "上海爱丽丝幻乐团官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1593792000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 2498273968,
"total": 38
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 悄悄关注 1 | 见 关系列表对象 |
| n | obj | 悄悄关注(n+1) | 按照操作顺序排列 |
| …… | obj | …… | …… |
示例:
curl -G 'https://api.bilibili.com/x/relation/whispers' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 178429408,
"attribute": 1,
"mtime": 1605972105,
"tag": null,
"special": 0,
"uname": "老弟一号",
"face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
"sign": "萌新硬件玩家,前垃圾佬~(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
"official_verify": {
"type": 0,
"desc": "知识领域优质UP主"
},
"vip": {
"vipType": 2,
"vipDueDate": 1632499200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 2137574562
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
查询与自己互关的用户明细,可看全部
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 互关 1 | 见 关系列表对象 |
| n | obj | 互关(n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
curl -G 'https://api.bilibili.com/x/relation/friends' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 596000,
"attribute": 6,
"mtime": 1685110154,
"tag": null,
"special": 0,
"uname": "椛椛在睡觉",
"face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg",
"sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1702742400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"nft_icon": "",
"rec_reason": "",
"track_id": ""
},
{
"mid": 24022863,
"attribute": 6,
"mtime": 1685026230,
"tag": [-10],
"special": 1,
"uname": "黄禄轩电脑专用账号",
"face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg",
"sign": "若要私信,请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/,群:410311648",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1686412800000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"nft_icon": "",
"rec_reason": "",
"track_id": ""
},
{
"mid": 85438718,
"attribute": 6,
"mtime": 1684759843,
"tag": [194110],
"special": 0,
"uname": "忘忧北萱草Official",
"face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg",
"sign": "现已加入 OrangeFire 豪华套餐!",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1691683200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"nft_icon": "",
"rec_reason": "",
"track_id": ""
},
{
"mid": 41620134,
"attribute": 6,
"mtime": 1684759649,
"tag": null,
"special": 0,
"uname": "Tiggy_Chan",
"face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg",
"sign": "此号只发科技类视频,娱乐类转至:虎子酱233",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 1,
"vipDueDate": 1669219200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": ""
},
"avatar_subscript": 0,
"nickname_color": "",
"avatar_subscript_url": ""
},
"nft_icon": "",
"rec_reason": "",
"track_id": ""
},
// ……
],
"re_version": 0
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50,且最多为50,大于50则按50输出 |
| pn | num | 页码 | 非必要 | 默认为 1 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| list | array | 明细列表 | |
| re_version | num | (?) | |
| total | num | 黑名单总计数 |
data中的list数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 黑名单 1 | 见 关系列表对象 |
| n | obj | 黑名单 (n+1) | 按照添加顺序排列 |
| …… | obj | …… | …… |
示例:
获取黑名单明细
curl -G 'https://api.bilibili.com/x/relation/blacks' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 22179720,
"attribute": 128,
"mtime": 1603032789,
"tag": null,
"special": 0,
"uname": "咩2016",
"face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
"sign": "",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
},
{
"mid": 16174624,
"attribute": 128,
"mtime": 1603026420,
"tag": null,
"special": 0,
"uname": "其实死亡没有那么痛",
"face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
"sign": "等我,我马上就来",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 897205356,
"total": 2
}
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | 操作代码见下表 |
| re_src | num | 关注来源代码 | 非必要 | 包月充电:1 个人空间:11 视频:14 评论区:15 视频播放器结束页面:17 H5推荐关注:58 H5关注列表:106 H5粉丝列表:107 专栏:115 私信:118 搜索:120 视频播放器左上角关注按钮:164 H5共同关注:167 创作激励计划:192 活动页面:222 联合投稿视频:229 消息中心点赞详情:235 视频播放器关注弹幕:245 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
操作代码act:
| 代码 | 含义 | 备注 |
|---|---|---|
| 1 | 关注 | 无法对已注销或不存在的用户进行此操作 |
| 2 | 取关 | |
| 3 | 悄悄关注 | 现已下线,使用本操作代码请求接口会提示“请求错误” |
| 4 | 取消悄悄关注 | |
| 5 | 拉黑 | 无法对已注销或不存在的用户进行此操作 |
| 6 | 取消拉黑 | |
| 7 | 踢出粉丝 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -102:账号被封停 -111:csrf校验失败 -400:请求错误 22001:不能对自己进行此操作 22002:因对方隐私设置,你还不能关注 22003:关注失败,请将该用户移除黑名单之后再试 22008:黑名单达到上限 22009:关注失败,已达关注上限 22013:账号已注销,无法完成操作 22014:已经关注用户,无法重复关注 22120:重复加入黑名单 40061:用户不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 |
示例:
关注mid=14082的用户
curl 'https://api.bilibili.com/x/relation/modify' \\
--data-urlencode 'fid=14082' \\
--data-urlencode 'act=1' \\
--data-urlencode 're_src=11' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
此接口只支持关注和拉黑操作
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fids | nums | 目标用户 mid 列表 | 必要 | 每个成员之间用 , 间隔,最多 50 个成员,不能包含自己的 mid |
| act | num | 操作代码 | 必要 | 同上 仅可为 1 或 5,故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 非必要 | 同上 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -102:账号被封停 -111:csrf校验失败 -400:请求错误 22003:用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| failed_fids | array | 操作失败的 mid 列表 |
data中的failed_fids数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | num | 操作失败的 mid 1 | |
| n | num | 操作失败的 mid(n+1) | |
| …… | num | …… | …… |
示例:
批量关注mid=1,2,3,4,5的用户
curl 'https://api.bilibili.com/x/relation/batch/modify' \\
--data-urlencode 'fid=1,2,3,4,5' \\
--data-urlencode 'act=1' \\
--data-urlencode 're_src=11' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"failed_fids": []
}
}| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 目标用户 mid | |
| attribute | num | 关系属性 | 0:未关注 2:已关注 6:已互粉 128:已拉黑 |
| mtime | num | 关注对方时间 | 时间戳 未关注为 0 |
| tag | 默认分组:null 存在至少一个分组:array | 分组 id | |
| special | num | 特别关注标志 | 0:否 1:是 |
tag数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | num | 位于分组 1 的分组 | |
| n | num | 位于分组(n+1)的分组 | |
| …… | num | …… | …… |
请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fid | num | 目标用户 mid | 必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 详见 关系属性对象 |
示例:
可得对于mid=258150656的用户,在2018/10/28 0:51:41时关注,且设为特别关注,并位于为-10分组中
curl -G 'https://api.bilibili.com/x/relation' \\
--data-urlencode 'fid=258150656' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 258150656,
"attribute": 2,
"mtime": 1540659101,
"tag": [-10],
"special": 1
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
`,289)),n("p",null,[s[1]||(s[1]=a("鉴权方式(仅接口1):")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>s[0]||(s[0]=[a("Wbi 签名")])),_:1,__:[0]})]),s[25]||(s[25]=n("p",null,[n("s",null,[a("该接口的旧版 API :"),n("a",{href:"https://api.bilibili.com/x/space/acc/relation",target:"_blank",rel:"noopener noreferrer"},"https://api.bilibili.com/x/space/acc/relation")]),a("(已废弃,不建议使用)")],-1)),s[26]||(s[26]=n("p",null,[n("strong",null,"url参数:")],-1)),n("table",null,[s[16]||(s[16]=n("thead",null,[n("tr",null,[n("th",null,"参数名"),n("th",null,"类型"),n("th",null,"内容"),n("th",null,"必要性"),n("th",null,"备注")])],-1)),n("tbody",null,[s[14]||(s[14]=n("tr",null,[n("td",null,"access_key"),n("td",null,"str"),n("td",null,"APP登录Token"),n("td",null,"APP方式必要"),n("td")],-1)),s[15]||(s[15]=n("tr",null,[n("td",null,"mid"),n("td",null,"num"),n("td",null,"目标用户mid"),n("td",null,"必要"),n("td")],-1)),n("tr",null,[s[4]||(s[4]=n("td",null,"w_rid",-1)),s[5]||(s[5]=n("td",null,"str",-1)),s[6]||(s[6]=n("td",null,"Wbi 签名",-1)),s[7]||(s[7]=n("td",null,"仅接口1必要",-1)),n("td",null,[s[3]||(s[3]=a("详见 ")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>s[2]||(s[2]=[a("Wbi 签名")])),_:1,__:[2]})])]),n("tr",null,[s[10]||(s[10]=n("td",null,"wts",-1)),s[11]||(s[11]=n("td",null,"num",-1)),s[12]||(s[12]=n("td",null,"当前时间戳",-1)),s[13]||(s[13]=n("td",null,"仅接口1必要",-1)),n("td",null,[s[9]||(s[9]=a("详见 ")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>s[8]||(s[8]=[a("Wbi 签名")])),_:1,__:[8]})])])])]),s[27]||(s[27]=e('json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| relation | obj | 目标用户对于当前用户的关系 | 详见 关系属性对象 |
| be_relation | obj | 当前用户对于目标用户的关系 | 详见 关系属性对象 |
示例:
可得对于mid=15858903的用户,在2019/1/24 14:24:19时关注了对方,且互相关注,自己将对方特别关注,并同时位于为-10和194110的分组中,对方也将自己设为特别关注,并同时位于为-10和56502的分组中(虽然我看不到)
curl -G 'https://api.bilibili.com/x/space/acc/relation' \\
--data-urlencode 'mid=15858903' \\
--data-urlencode 'wts=1686015899' \\
--data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"relation": {
"mid": 15858903,
"attribute": 6,
"mtime": 1548311059,
"tag": [-10, 194110, 248468],
"special": 1
},
"be_relation": {
"mid": 293793435,
"attribute": 6,
"mtime": 1548311059,
"tag": [56502, -10],
"special": 1
}
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fids | nums | 目标用户 mid | 必要 | 每个之间用,间隔,无成员限制 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| {用户mid} | obj | 关注的用户 | 详见 关系属性对象 |
| …… | obj | …… | 下同 |
示例:
批量查询mid=1,2,3,4,5的关系
curl -G 'https://api.bilibili.com/x/relation/relations' \\
--data-urlencode 'fid=258150656' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"1": {
"mid": 1,
"attribute": 2,
"mtime": 1601654227,
"tag": null,
"special": 0
},
"2": {
"mid": 2,
"attribute": 2,
"mtime": 1601654225,
"tag": null,
"special": 0
}
}
}分组 id 特殊值:
| id | 含义 |
|---|---|
| 0 | 默认分组 |
| -10 | 特别关心 |
请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | array | 分组列表 |
data数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 分组 1 | |
| n | obj | 分组(n+1) | |
| …… | num | …… | …… |
数组data中的对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| tagid | num | 分组 id | -10:特别关注 0:默认分组 |
| name | str | 分组名称 | |
| count | num | 分组成员数 | |
| tip | str | 提示信息 |
示例:
查询所有的分组的名字以及id
curl 'https://api.bilibili.com/x/relation/tags' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"tagid": -10,
"name": "特别关注",
"count": 19,
"tip": "第一时间收到该分组下用户更新稿件的通知"
},
{
"tagid": 0,
"name": "默认分组",
"count": 340,
"tip": ""
},
{
"tagid": 194110,
"name": "基友们",
"count": 127,
"tip": ""
},
{
"tagid": 194111,
"name": "我的同学",
"count": 22,
"tip": ""
},
// ……
]
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
只可查询属于自己的分组
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| tagid | num | 分组 id | 必要 | 0:默认分组 -10:特别关注 -20:所有 |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列:留空 按照最常访问排列:attention |
| ps | num | 每页项数 | 非必要 | 默认为 20 |
| pn | num | 页数 | 非必要 | 默认为1 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 22104:该分组不存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | array | 成员列表 |
data数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | obj | 成员信息 1 | 与关系列表对象不同 |
| n | obj | 成员信息(n+1) | 按照添加顺序排序 |
| …… | obj | …… | …… |
data 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| mid | num | 用户mid | |
| attribute | num | 关系属性 | 恒为 0 |
| tag | null | 关注分组id | 恒为 null |
| special | num | 是否特别关注 | 恒为 0 |
| contract_info | obj | 契约计划信息 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| face_nft | num | 是否为 NFT 头像 | |
| official_verify | obj | 认证信息 | 具体见下 |
| vip | obj | 会员信息 | |
| live | obj | 直播状态 | 具体见下 |
| nft_icon | str | (?) | |
| rec_reason | str | (?) | |
| track_id | str | (?) | |
| follow_time | str | (?) |
data中的对象中的official_verify对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| type | num | 用户认证类型 | -1:无 0:UP 主认证 1:机构认证 |
| desc | str | 用户认证信息 | 无为空 |
data中的对象中的vip对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| vipType | num | 会员类型 | 0:无 1:月度大会员 2:年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | (?) | |
| accessStatus | num | (?) | |
| vipStatus | num | 大会员状态 | 0:无 1:有 |
| vipStatusWarn | str | (?) | |
| themeType | num | (?) | |
| label | obj | (?) |
data数组中的对象中的live对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| live_status | num | 直播状态 | 0:未开播 1:已直播 |
| jump_url | str | 直播链接 |
data数组中的对象中的contract_info对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| is_contract | bool | 目标用户是否为对方的契约者 | 仅当为 true 时才有此项 |
| is_contractor | bool | 对方是否为目标用户的契约者 | 仅当为 true 时才有此项 |
| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 is_contractor 项的值为 true 时才有此项 |
| user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉 否则为原始粉丝 仅当有特殊属性时才有此项 |
示例:
以每页2项的方式获取了id为207542分组的第1页的粉丝明细,按照关注顺序
curl -G 'https://api.bilibili.com/x/relation/tag' \\
--data-urlencode 'tagid=207542' \\
--data-urlencode 'order_type=' \\
--data-urlencode 'ps=2' \\
--data-urlencode 'pn=1' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": [{
"mid": 420831218,
"uname": "支付宝Alipay",
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"sign": "阿支来了,关注点赞转发投币四连走起!",
"official_verify": {
"type": 1,
"desc": "支付宝官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1585065600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}, {
"mid": 125086406,
"uname": "MSI微星科技",
"face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg",
"sign": "你好,这里是微星显卡官方!专注显卡三十年,欢迎私信咨询或提问MSI",
"official_verify": {
"type": 1,
"desc": "微星科技官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1540656000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}]
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fid | num | 目标用户 mid | 必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| {加入的分组 id} | str | 分组名称 | 若目标用户存在默认分组中,则不显示 |
| …… | str | …… | 下同 |
示例:
查询用户mid=319214221存在的所有分组和名称
curl -G 'https://api.bilibili.com/x/relation/tag/user' \\
--data-urlencode 'fid=319214221' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"-10": "特别关注",
"194111": "我的同学"
}
}请求方式:GET
认证方式:Cookie(SESSDATA)或 APP
url参数:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -101:账号未登录 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | array | 成员列表 |
data数组:
| 项 | 类型 | 内容 | 备注 |
|---|---|---|---|
| 0 | num | 成员 1 mid | |
| n | num | 成员(n+1)mid | |
| …… | num | …… | …… |
示例:
curl 'https://api.bilibili.com/x/relation/tag/special' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
500716647,
32832243,
53456,
25944552,
301839556,
427494870,
319214221,
31949159,
382666849,
258318451,
15858903,
54992199,
3379951,
392279807,
23215368,
258150656,
20165629,
22179720
]
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| tag | str | 分组名 | 必要 | 最长 16 字符 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 22101:分组名称存在不允许的字符 22102:分组数量超过限制 22103:分组名过长 22106:该分组已经存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 |
data对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| tagid | num | 创建的分组的 id |
示例:
创建了名为测试的分组,得到id为216677
curl 'https://api.bilibili.com/x/relation/tag/create' \\
--data-urlencode 'tag=测试' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"tagid": 216677
}
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| tagid | num | 分组 id | 必要 | |
| name | str | 新名称 | 必要 | 最长 16 字符 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 22101:分组名称存在不允许的字符 22103:分组名过长 22104:该分组不存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |
示例:
把id为194112的分组更名为膜法师
curl 'https://api.bilibili.com/x/relation/tag/update' \\
--data-urlencode 'tagid=194112' \\
--data-urlencode 'name=膜法师' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| tagid | num | 分组 id | 必要 | |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |
示例:
删除分组id为216699的分组
curl 'https://api.bilibili.com/x/relation/tag/del' \\
--data-urlencode 'tagid=216699' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
如需删除分组中的成员,请将tagids设为 0,即移动至默认分组,而不是取关
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fids | nums | 目标用户 mid 列表 | 必要 | 每个之间用,间隔 |
| tagids | nums | 分组 id 列表 | 必要 | 每个之间用,间隔 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 22104:分组不存在 22105:未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |
示例:
把关注用户mid=205631797同时添加分组关系到id为-10和207542的分组中
curl 'https://api.bilibili.com/x/relation/tags/addUsers' \\
--data-urlencode 'fids=205631797' \\
--data-urlencode 'tagids=-10,207542' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| fids | nums | 待复制的用户 mid 列表 | 必要 | 每个之间用,间隔 |
| tagids | nums | 目标分组 id 列表 | 必要 | 每个之间用,间隔 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 22104:分组不存在 22105:未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |
示例:
把关注用户mid=4856007和mid=326499679同时复制到为231305的分组id中
curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \\
--data-urlencode 'fids=4856007,326499679' \\
--data-urlencode 'tagids=231305' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}请求方式:POST
认证方式:Cookie(SESSDATA)或 APP
正文参数(application/x-www-form-urlencoded):
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---|---|---|---|---|
| access_key | str | APP 登录 Token | APP 方式必要 | |
| beforeTagids | nums | 原分组 id 列表 | 必要 | 每个之间用,间隔 |
| afterTagids | nums | 新分组 id 列表 | 必要 | 每个之间用,间隔 |
| fids | nums | 待移动的用户 mid 列表 | 必要 | 每个之间用,间隔 |
| csrf | str | CSRF Token(位于 Cookie) | Cookie 方式必要 |
json回复:
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---|---|---|---|
| code | num | 返回值 | 0:成功 -111:csrf校验失败 -101:账号未登录 -400:请求错误 22104:分组不存在 22105:未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 |
示例:
把关注用户mid=321173469和mid=327086920同时从id为207542的分组移动到为231305的分组中
curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \\
--data-urlencode 'beforeTagids=207542' \\
--data-urlencode 'afterTagids=23130' \\
--data-urlencode 'fids=321173469,327086920' \\
--data-urlencode 'csrf=xxx' \\
-b 'SESSDATA=xxx'{
"code": 0,
"message": "0",
"ttl": 1
}mtime in fans list when sorting by recommend algorithm"},{"hash":"2f48f6c81ab400d03ac40921b25906ad8719e725","time":1750530532000,"email":"121270969+114514ns@users.noreply.github.com","author":"114514ns","message":"添加部分直播相关api (#1297)"},{"hash":"5865720b9504840dcbf767e66fb359343405572b","time":1748137701000,"email":"121035454+XuanRikka@users.noreply.github.com","author":"轩某Rikka","message":"feat: 修改查询黑名单明细中的每页项数的备注 (#1118)"},{"hash":"75d599714e2d943bcf9c38a23612ad69bea888aa","time":1747074561000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(relation): add re_src details"},{"hash":"5c4490354c52b1fc7406998057642f35b09c7dee","time":1746972830000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(relation): add unread followers"},{"hash":"4c8b0f9ddbf5e33015fe8de225c98b90fd4f5f73","time":1746384668000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"fix(relation): typo"},{"hash":"9d504615a092710ac2fc00dfc44acbf070463fa0","time":1746384210000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(relation): #1264"},{"hash":"dc3f6d64a730cf3481365e49ddd9c6b2d568569f","time":1745604137000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat & fix: update docs & fix typo in issue template"},{"hash":"6c1f03e75334aaba6f3b6f3bf346b0326073b779","time":1740498696000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"update"},{"hash":"ea555aff786abfdae0823f1c9eb9b43cb4814590","time":1719496762000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"feat: 添加获取多用户信息接口,完善用户关系文档 (#1044)"},{"hash":"a201a3c9cabda923bfcf706a9b17827ed881142b","time":1719415801000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"将 #983 中对此文件的更改合并到此 PR 中"},{"hash":"6521e3fea37a348230426c36499fc083d7887a21","time":1714761544000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update CONTRIBUTING.md"},{"hash":"b8da0e5b18258c79ac69088552a4aa86a4dead2f","time":1710531172000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"e6072a6a6978fa5e6b0aa3f8dc9833ef07432ae8","time":1710436321000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"d04d4193be98bdf8c91addc6ef807385ac09831c","time":1710270147000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"f9ee5c3b99335af6bef0d9d902101c565b3bea00","time":1710068023000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"feat: 更新包月充电、获取用户信息、用户关系相关说明 (#981)"},{"hash":"12e014afcb376e0314e0fdef2dab5c4f7b9fdde7","time":1706520417000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"fix: 错误的显示和链接和数据类型 (#954)"},{"hash":"eb2e61e2568070ce91e3a18849e566f768e01095","time":1703329762000,"email":"xliilQwQ@outlook.com","author":"行旅途","message":"feat(relation): add the order followings option (#915)"},{"hash":"95efa217a8acedcbf7316f550d78a6089d989114","time":1688056499000,"email":"35167402+maimierjiafude@users.noreply.github.com","author":"maimierjiafude","message":"Update relation.md (#725)"},{"hash":"e379d904c2753fa30e9083f59016f07e89d19467","time":1686020539000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"update【用户关系】APIDoc"},{"hash":"9459e2dd6dbc3d7138c61168443c2d7a2b37a223","time":1678895882000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"hash":"f33e9f06e1ab2571d24bf0b75d0caffdc3c27dc5","time":1678640117000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"hash":"fa1a87a4ecf41dd61f1d54148f9852f719b1ec63","time":1678639492000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"hash":"b7f78a7fbfba7f324a687b76d5d6647cc38542f6","time":1677519376000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"hash":"490d4c5e1f4559e9fae0feb46e18364317a6112e","time":1677480998000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"新增包月充电功能相关API (#626)"},{"hash":"b2a1d78b4ef116ab714a6a7a41a91ab2e1f031ce","time":1677411594000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"hash":"2871403d48676002f6895826a72dc8625d6715e0","time":1677411544000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update relation.md"},{"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/user/relation.md"}');export{q as comp,h as data};