mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00

* Update relation.md

* Update relation.md

fix error word

2023-06-30 00:34:59 +08:00

76 KiB

Raw Blame History

用户关系相关

查询关系列表

关系列表对象

字段	类型	内容	备注
mid	num	用户 mid
attribute	num	关注属性	0：未关注 1：已关注 2：已关注 6：已互粉 128：已拉黑
mtime	num	关注对方时间	时间戳互关后刷新
tag	默认分组：null 存在至少一个分组：array	分组 id
special	num	特别关注标志	0：否 1：是
contract_info	obj	（？）
uname	str	用户昵称
face	str	用户头像url
face_nft	num	是否为 NFT 头像	0：非 NFT 头像 1：NFT 头像
sign	str	用户签名
official_verify	obj	认证信息
vip	obj	会员信息
nft_icon	str	（？）
rec_reason	str	（？）
track_id	str	（？）

数组list中的对象中的tag数组：

项	类型	内容	备注
0	num	位于分组 1 的分组 id
n	num	位于分组（n+1）的分组 id
……	num	……	……

list中的对象中的official_verify对象：

字段	类型	内容	备注
type	num	用户认证类型	-1：无 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	（？）

查询用户粉丝明细

https://api.bilibili.com/x/relation/followers

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

登录可看当前用户前 1000 名，其他用户可查看前 250 名（网页端请求时ps为 20，所以直接查看只能看到前 100 名）

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
vmid	num	目标用户 mid	必要
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	……	……

示例：

获取用户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": 387195656,
			"attribute": 0,
			"mtime": 1583839793,
			"tag": null,
			"special": 0,
			"uname": "L_E_M_O_H_E",
			"face": "https://i1.hdslb.com/bfs/face/8ec537db75eeb292faa8dc85a9ff8aba83148c86.jpg",
			"sign": "暂时断更。。Back later",
			"official_verify": {
				"type": -1,
				"desc": ""
			},
			"vip": {
				"vipType": 0,
				"vipDueDate": 0,
				"dueRemark": "",
				"accessStatus": 0,
				"vipStatus": 0,
				"vipStatusWarn": "",
				"themeType": 0,
				"label": {
					"path": ""
				}
			}
		}, {
			"mid": 175989424,
			"attribute": 0,
			"mtime": 1583822019,
			"tag": null,
			"special": 0,
			"uname": "哥本哈根iii",
			"face": "https://i1.hdslb.com/bfs/face/e53c0fe9315176d48bd294b1f381f0da70131cd7.jpg",
			"sign": "",
			"official_verify": {
				"type": -1,
				"desc": ""
			},
			"vip": {
				"vipType": 0,
				"vipDueDate": 0,
				"dueRemark": "",
				"accessStatus": 0,
				"vipStatus": 0,
				"vipStatusWarn": "",
				"themeType": 0,
				"label": {
					"path": ""
				}
			}
		}],
		"re_version": 3857745402,
		"total": 365
	}
}

查询用户关注明细

https://api.bilibili.com/x/relation/followings

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

登录可看当前用户全部，其他用户仅可查看前5页

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
vmid	num	目标用户 mid	必要
order_type	str	排序方式	非必要	按照关注顺序排列：留空按照最常访问排列：attention
ps	num	每页项数	非必要	默认为 50
pn	num	页码	非必要	默认为 1 其他用户仅可查看前 5 页

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -400：请求错误 22007：访问超过 5 页 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,
			"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": ""
				}
			}
		}, {
			"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": ""
				}
			}
		}],
		"re_version": 3228575555,
		"total": 699
	}
}

查询用户关注明细2

https://app.biliapi.net/x/v2/relation/followings

请求方式：GET

仅可查看前 5 页，可以获取已设置可见性隐私的关注列表

url参数：

参数名	类型	内容	必要性	备注
vmid	num	目标用户 mid	必要
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：无 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": ""
				}
			}
		}, {
			"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": ""
				}
			}
		}],
		"re_version": 3228575555,
		"total": 699
	}
}

搜索关注明细

https://api.bilibili.com/x/relation/followings/search

请求方式：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'

查看响应示例：

```json { "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 } } ```

查询共同关注明细

https://api.bilibili.com/x/relation/same/followings

请求方式：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
    }
}

查询悄悄关注明细

https://api.bilibili.com/x/relation/whispers

请求方式：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
    }
}

查询互相关注明细

https://api.bilibili.com/x/relation/friends

请求方式：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'

查看响应示例：

```json { "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 } } ```

查询黑名单明细

https://api.bilibili.com/x/relation/blacks

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
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	……	……

示例：

获取黑名单明细

curl -G 'https://api.bilibili.com/x/relation/blacks' \
    --data-urlencode 'ps=2' \
    --data-urlencode 'pn=1' \
    -b 'SESSDATA=xxx'

查看响应示例：

```json { "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 } } ```

操作关系

操作用户关系

https://api.bilibili.com/x/relation/modify

请求方式：POST

认证方式：Cookie（SESSDATA）或 APP

正文参数（application/x-www-form-urlencoded）：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
fid	num	目标用户mid	必要
act	num	操作代码	必要	操作代码见下表
re_src	num	关注来源代码	必要	空间：11 视频：14 文章：115 活动页面：222
csrf	str	CSRF Token（位于 Cookie）	Cookie 方式必要

操作代码act：

代码	含义
1	关注
2	取关
3	悄悄关注
4	取消悄悄关注
5	拉黑
6	取消拉黑
7	踢出粉丝

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -101：账号未登录 -102：账号被封停 -111：csrf校验失败 -400：请求错误 22001：不能对自己进行此操作 22003：用户位于黑名单
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
}

批量操作用户关系

https://api.bilibili.com/x/relation/batch/modify

请求方式：POST

认证方式：Cookie（SESSDATA）或 APP

此接口只支持关注和拉黑操作

正文参数（application/x-www-form-urlencoded）：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
fids	nums	目标用户 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	……	……

查询用户与自己关系（仅关注）

https://api.bilibili.com/x/relation

请求方式：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对象：示例：

可得对于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
	}
}

查询用户与自己关系（互相关系）

https://api.bilibili.com/x/space/wbi/acc/relation

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

鉴权方式：Wbi 签名

~~该接口的旧版 API ：https://api.bilibili.com/x/space/acc/relation~~（已废弃，不建议使用）

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP登录Token	APP方式必要
mid	num	目标用户mid	必要
w_rid	str	Wbi 签名	必要	详见 Wbi 签名
wts	num	当前时间戳	必要	详见 Wbi 签名

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的分组中（虽然我看不到）

Wbi 签名的 wts、w_rid生成方式详见 Wbi 签名文档

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
        }
    }
}

批量查询用户与自己关系

https://api.bilibili.com/x/relation/relations

请求方式：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	特别关心

查询关注分组列表

https://api.bilibili.com/x/relation/tags

请求方式：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数组：

项	类型	内容	备注
1	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": ""
        },
	…………
	]
}

查询关注分组明细

https://api.bilibili.com/x/relation/tag

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

只可查询属于自己的分组

url参数：

参数名	类型	内容	必要性	备注
access_key	str	APP 登录 Token	APP 方式必要
tagid	num	分组 id	必要
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	用户id
attribute	num	0
tag	null	null
special	num	0
contract_info	json	空的
uname	str	用户名
face	str	头像地址
sign	str	个人简介
face_nft	int	ntf头像
official_verify	json	官方认证	具体见下
vip	json	大会员	参考大会员文档
live	json	直播状态	具体见下
nft_icon	str	显示nft角标
rec_reason	str
track_id	str

data对象中的official_verify：

字段	类型	内容	备注
type	num	0
desc	str	官方认证内容

data对象中的live：

字段	类型	内容	备注
live_status	num	0或1	0：未开播，1：已直播
jump_url	str	直播链接

示例：

以每页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": ""
			}
		}
	}]
}

查询目标用户所在的分组

https://api.bilibili.com/x/relation/tag/user

请求方式：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": "我的同学"
	}
}

查询所有特别关注 mid

https://api.bilibili.com/x/relation/tag/special

请求方式：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
    ]
}

创建分组

https://api.bilibili.com/x/relation/tag/create

请求方式：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：请求错误 22106：该分组已经存在 22103：分组名过长
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
	}
}

重命名分组

https://api.bilibili.com/x/relation/tag/update

请求方式：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：请求错误 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
}

删除分组

https://api.bilibili.com/x/relation/tag/del

请求方式：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
}

修改分组成员

https://api.bilibili.com/x/relation/tags/addUsers

请求方式：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
}

复制关注到分组

https://api.bilibili.com/x/relation/tags/copyUsers

请求方式：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
}

移动关注到分组

https://api.bilibili.com/x/relation/tags/moveUsers

请求方式：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
}

76 KiB Raw Blame History Unescape Escape

用户关系相关

查询关系列表

关系列表对象

查询用户粉丝明细

查询用户关注明细

查询用户关注明细2

搜索关注明细

查询共同关注明细

查询悄悄关注明细

查询互相关注明细

查询黑名单明细

操作关系

操作用户关系

批量操作用户关系

查询关系属性

关系属性对象

查询用户与自己关系（仅关注）

查询用户与自己关系（互相关系）

批量查询用户与自己关系

关注分组相关

查询关注分组列表

查询关注分组明细

查询目标用户所在的分组

查询所有特别关注 mid

创建分组

重命名分组

删除分组

修改分组成员

复制关注到分组

移动关注到分组

76 KiB

Raw Blame History