- [d1a4f6d
](d1a4f6dd2b
) close #1062 ~by myself~ - [ff450a6
](ff450a6569
) add Wbi API - [b3c3fce
](b3c3fce164
) close #707 - [fa6c9c8
](fa6c9c8f57
) new method of `buvid3` & `b_nut` from #790 - [45755b0
](45755b01d8 (diff-1a8d1ba142e61d01fd3b24620847ca2f2ff93f880973ea1e1d71de79d0123096R133)
) close #380 - [45755b0
](45755b01d8 (diff-1a8d1ba142e61d01fd3b24620847ca2f2ff93f880973ea1e1d71de79d0123096R542)
) add details in #244 - [1c5b778
](1c5b7788f7
) - [85e8fc5
](85e8fc5304
) close #945
59 KiB
用户基本信息
用户空间详细信息
请求方式:GET
认证方式:Cookie(SESSDATA)
鉴权方式:Wbi 签名, Cookie (对于某些 IP 地址,需要在 Cookie 中提供任意非空的 buvid3
字段)
该接口的旧版 API :https://api.bilibili.com/x/space/acc/info(已废弃,不建议使用)
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
mid | num | 目标用户mid | 必要 | |
w_rid | str | Wbi 签名 | 必要 | 详见 Wbi 签名 |
wts | num | 当前时间戳 | 必要 | 详见 Wbi 签名 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 -403:访问权限不足 -404:用户不存在(如注销账号) |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | obj | 信息本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | mid | |
name | str | 昵称 | |
sex | str | 性别 | 男/女/保密 |
face | str | 头像链接 | |
face_nft | num | 是否为 NFT 头像 | 0:不是 NFT 头像 1:是 NFT 头像 |
face_nft_type | num | NFT 头像类型? | |
sign | str | 签名 | |
rank | num | 用户权限等级 | 目前应该无任何作用 5000:0级未答题 10000:普通会员 20000:字幕君 25000:VIP 30000:真·职人 32000:管理员 |
level | num | 当前等级 | 0-6 级 |
jointime | num | 注册时间 | 此接口返回恒为0 |
moral | num | 节操值 | 此接口返回恒为0 |
silence | num | 封禁状态 | 0:正常 1:被封 |
coins | num | 硬币数 | 需要登录(Cookie) 只能查看自己的 默认为 0 |
fans_badge | bool | 是否具有粉丝勋章 | false:无 true:有 |
fans_medal | obj | 粉丝勋章信息 | |
official | obj | 认证信息 | |
vip | obj | 会员信息 | |
pendant | obj | 头像框信息 | |
nameplate | obj | 勋章信息 | |
user_honour_info | obj | (?) | |
is_followed | bool | 是否关注此用户 | true:已关注 false:未关注 需要登录(Cookie) 未登录恒为 false |
top_photo | str | 主页头图链接 | |
theme | obj | (?) | |
sys_notice | obj | 系统通知 | 无内容则为空对象 主要用于展示如用户争议、纪念账号等等的小黄条 |
live_room | obj | 直播间信息 | |
birthday | str | 生日 | MM-DD 如设置隐私为空 |
school | obj | 学校 | |
profession | obj | 专业资质信息 | |
tags | null | 个人标签 | |
series | obj | ||
is_senior_member | num | 是否为硬核会员 | 0:否 1:是 |
mcn_info | null | (?) | |
gaia_res_type | num | (?) | |
gaia_data | null | (?) | |
is_risk | bool | (?) | |
elec | obj | 充电信息 | |
contract | obj | 是否显示老粉计划 |
rank
示例
UID | rank |
---|---|
2 | 20000 |
16765 | 20000 |
15773384 | 20000 |
124416 | 20000 |
429736362 | 25000 |
424261768 | 25000 |
41273726 | 25000 |
15080107 | 25000 |
9847497 | 25000 |
4856007 | 25000 |
928123 | 25000 |
132704 | 25000 |
70093 | 25000 |
47291 | 25000 |
27380 | 25000 |
22445 | 25000 |
3351 | 25000 |
1101 | 25000 |
93066 | 30000 |
2443068 | 30000 |
46368 | 30000 |
11167 | 30000 |
profession
示例
UID |
---|
654391 |
1440295 |
1785155 |
2990100 |
3875803 |
data
中的official
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role | num | 认证类型 | 见 用户认证类型一览 |
title | str | 认证信息 | 无为空 |
desc | str | 认证备注 | 无为空 |
type | num | 是否认证 | -1:无 0:个人认证 1:机构认证 |
data
中的vip
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
type | num | 会员类型 | 0:无 1:月大会员 2:年度及以上大会员 |
status | num | 会员状态 | 0:无 1:有 |
due_date | num | 会员过期时间 | 毫秒时间戳 |
vip_pay_type | num | 支付类型 | 0:未支付(常见于官方账号) 1:已支付(以正常渠道获取的大会员均为此值) |
theme_type | num | 0 | 作用尚不明确 |
label | obj | 会员标签 | |
avatar_subscript | num | 是否显示会员图标 | 0:不显示 1:显示 |
nickname_color | str | 会员昵称颜色 | 颜色码,一般为#FB7299 ,曾用于愚人节改变大会员配色 |
role | num | 大角色类型 | 1:月度大会员 3:年度大会员 7:十年大会员 15:百年大会员 |
avatar_subscript_url | str | 大会员角标地址 | |
tv_vip_status | num | 电视大会员状态 | 0:未开通 |
tv_vip_pay_type | num | 电视大会员支付类型 |
vip
中的label
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
path | str | 空 | 作用尚不明确 |
text | str | 会员类型文案 | 大会员 年度大会员 十年大会员 百年大会员 最强绿鲤鱼 |
label_theme | str | 会员标签 | vip:大会员 annual_vip:年度大会员 ten_annual_vip:十年大会员 hundred_annual_vip:百年大会员 fools_day_hundred_annual_vip:最强绿鲤鱼 |
text_color | str | 会员标签 | |
bg_style | num | 1 | |
bg_color | str | 会员标签背景颜色 | 颜色码,一般为#FB7299 ,曾用于愚人节改变大会员配色 |
border_color | str | 会员标签边框颜色 | 未使用 |
use_img_label | bool | true |
|
img_label_uri_hans | str | 空串 |
|
img_label_uri_hant | str | 空串 |
|
img_label_uri_hans_static | str | 大会员牌子图片 | 简体版 |
img_label_uri_hant_static | str | 大会员牌子图片 | 繁体版 |
data
中的pendant
对象:
普通头像框的image
与image_enhance
内容相同
动态头像框的image
为png静态图片,image_enhance
为webp动态图片,image_enhance_frame
为png逐帧序列
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
pid | num | 头像框id | |
name | str | 头像框名称 | |
image | str | 头像框图片url | |
expire | num | 过期时间 | 此接口返回恒为0 |
image_enhance | str | 头像框图片url | |
image_enhance_frame | str | 头像框图片逐帧序列url |
data
中的nameplate
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
nid | num | 勋章id | |
name | str | 勋章名称 | |
image | str | 勋章图标 | |
image_small | str | 勋章图标(小) | |
level | str | 勋章等级 | |
condition | str | 获取条件 |
data
中的fans_medal
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
show | bool | ||
wear | bool | 是否佩戴了粉丝勋章 | |
medal | obj | 粉丝勋章信息 |
fans_medal
中的medal
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
uid | num | 此用户mid | |
target_id | num | 粉丝勋章所属UP的mid | |
medal_id | num | 粉丝勋章id | |
level | num | 粉丝勋章等级 | |
medal_name | str | 粉丝勋章名称 | |
medal_color | num | 颜色 | |
intimacy | num | 当前亲密度 | |
next_intimacy | num | 下一等级所需亲密度 | |
day_limit | num | 每日亲密度获取上限 | |
today_feed | num | 今日已获得亲密度 | |
medal_color_start | num | 粉丝勋章颜色 | 十进制数,可转为十六进制颜色代码 |
medal_color_end | num | 粉丝勋章颜色 | 十进制数,可转为十六进制颜色代码 |
medal_color_border | num | 粉丝勋章边框颜色 | 十进制数,可转为十六进制颜色代码 |
is_lighted | num | ||
light_status | num | ||
wearing_status | num | 当前是否佩戴 | 0:未佩戴 1:已佩戴 |
score | num |
data
中的sys_notice
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
id | num | id | |
content | str | 显示文案 | |
url | str | 跳转地址 | |
notice_type | num | 提示类型 | 1,2 |
icon | str | 前缀图标 | |
text_color | str | 文字颜色 | |
bg_color | str | 背景颜色 |
sys_notice
示例
id | content | notice_type | 示例用户 |
---|---|---|---|
5 | 该用户存在争议行为,已冻结其帐号功能的使用 | 1 | 82385070 |
8 | 该用户存在较大争议,请谨慎甄别其内容 | 1 | 28062215 |
11 | 该账号涉及合约争议,暂冻结其账号功能使用。详见公告-> | 1 | |
16 | 该UP主内容存在争议,请注意甄别视频内信息 | 1 | 382534165 |
20 | 请允许我们在此献上最后的告别,以此纪念其在哔哩哔哩留下的回忆与足迹。请点此查看纪念账号相关说明 | 2 | 212535360 |
22 | 该账号涉及合约诉讼,封禁其账号使用 | ||
24 | 该账号涉及合约争议,暂冻结其账号功能使用 | 1 | 291229008 |
25 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | 81447581 |
31 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | 22439273 |
34 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | 1640486775 |
36 | 该账户存在争议,请谨慎甄别 | 1 | 198297 18149131 |
data
中的live_room
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
roomStatus | num | 直播间状态 | 0:无房间 1:有房间 |
liveStatus | num | 直播状态 | 0:未开播 1:直播中 |
url | str | 直播间网页 url | |
title | str | 直播间标题 | |
cover | str | 直播间封面 url | |
watched_show | obj | ||
roomid | num | 直播间 id | |
roundStatus | num | 轮播状态 | 0:未轮播 1:轮播 |
broadcast_type | num | 0 |
live_room
中的watched_show
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
switch | bool | ? | |
num | num | total watched users | |
text_small | str | ||
text_large | str | ||
icon | str | watched icon url | |
icon_location | str | ? | |
icon_web | str | watched icon url |
data
中的school
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
name | str | 就读大学名称 | 没有则为空 |
data
中的profession
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
name | str | 资质名称 | |
department | str | 职位 | |
title | str | 所属机构 | |
is_show | num | 是否显示 | 0:不显示 1:显示 |
data
中的user_honour_info
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | 0 | |
colour | str | null | |
tags | array | null |
data
中的series
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
user_upgrade_status | num | (?) | |
show_upgrade_window | bool | (?) |
data
中的elec
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
show_info | obj |
elec
中的show_info
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
show | bool | 是否开通了充电 | |
state | num | 状态 | -1:未开通 1:已开通 |
title | str | 空串 |
|
icon | str | 空串 |
|
jump_url | str | 空串 |
data
中的contract
对象:
字段名 | 类型 | 内容 | 备注 |
---|---|---|---|
is_display | bool | true/false 在页面中未使用此字段 |
|
is_follow_display | bool | 是否在显示老粉计划 | true:显示 false:不显示 |
示例:
查询用户mid=2
的详细信息,Wbi 签名的 wts
、w_rid
生成方式详见 Wbi 签名 文档
curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
--data-urlencode 'mid=2' \
--data-urlencode 'wts=1685070149' \
--data-urlencode 'w_rid=f7b376124782ae8cb42c56fdd69144ed' \
-b 'SESSDATA=xxx'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"face_nft": 0,
"face_nft_type": 0,
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"jointime": 0,
"moral": 0,
"silence": 0,
"coins": 0,
"fans_badge": true,
"fans_medal": {
"show": true,
"wear": true,
"medal": {
"uid": 2,
"target_id": 335115,
"medal_id": 45408,
"level": 21,
"medal_name": "伍千万",
"medal_color": 1725515,
"intimacy": 1980,
"next_intimacy": 2000,
"day_limit": 250000,
"medal_color_start": 1725515,
"medal_color_end": 5414290,
"medal_color_border": 1725515,
"is_lighted": 1,
"light_status": 1,
"wearing_status": 1,
"score": 50001980
}
},
"official": {
"role": 2,
"title": "bilibili创始人(站长)",
"desc": "",
"type": 0
},
"vip": {
"type": 2,
"status": 1,
"due_date": 3931344000000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "十年大会员",
"label_theme": "ten_annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "https://i0.hdslb.com/bfs/activity-plat/static/20220608/e369244d0b14644f5e1a06431e22a4d5/wltavwHAkL.gif",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/802418ff03911645648b63aa193ba67997b5a0bc.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png"
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 7,
"avatar_subscript_url": "",
"tv_vip_status": 1,
"tv_vip_pay_type": 0,
"tv_due_date": 2000822400
},
"pendant": {
"pid": 32257,
"name": "EveOneCat2",
"image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png",
"expire": 0,
"image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp",
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png"
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "https://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数>=10万"
},
"user_honour_info": {
"mid": 0,
"colour": null,
"tags": []
},
"is_followed": true,
"top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
"theme": {},
"sys_notice": {},
"live_room": {
"roomStatus": 1,
"liveStatus": 0,
"url": "https://live.bilibili.com/1024?broadcast_type=0&is_room_feed=0",
"title": "试图恰鸡",
"cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg",
"roomid": 1024,
"roundStatus": 0,
"broadcast_type": 0,
"watched_show": {
"switch": true,
"num": 19,
"text_small": "19",
"text_large": "19人看过",
"icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
"icon_location": "",
"icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png"
}
},
"birthday": "09-19",
"school": {
"name": ""
},
"profession": {
"name": "",
"department": "",
"title": "",
"is_show": 0
},
"tags": null,
"series": {
"user_upgrade_status": 3,
"show_upgrade_window": false
},
"is_senior_member": 0,
"mcn_info": null,
"gaia_res_type": 0,
"gaia_data": null,
"is_risk": false,
"elec": {
"show_info": {
"show": true,
"state": 1,
"title": "",
"icon": "",
"jump_url": "?oid=2"
}
},
"contract": {
"is_display": false,
"is_follow_display": false
}
}
}
用户名片信息
请求方式:GET
认证方式:Cookie(SESSDATA)
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
mid | num | 目标用户mid | 必要 | |
photo | bool | 是否请求用户主页头图 | 非必要 | true:是 false:否 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | obj | 信息本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
card | obj | 卡片信息 | |
following | bool | 是否关注此用户 | true:已关注 false:未关注 需要登录(Cookie) 未登录为false |
archive_count | num | 用户稿件数 | |
article_count | num | 0 | 作用尚不明确 |
follower | num | 粉丝数 | |
like_num | num | 点赞数 |
data
中的card
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | str | 用户mid | |
approve | bool | false | 作用尚不明确 |
name | str | 用户昵称 | |
sex | str | 用户性别 | 男 女 保密 |
face | str | 用户头像链接 | |
DisplayRank | str | 0 | 作用尚不明确 |
regtime | num | 0 | 作用尚不明确 |
spacesta | num | 用户状态 | 0:正常 -2:被封禁 |
birthday | str | 空 | 作用尚不明确 |
place | str | 空 | 作用尚不明确 |
description | str | 空 | 作用尚不明确 |
article | num | 0 | 作用尚不明确 |
attentions | array | 空 | 作用尚不明确 |
fans | num | 粉丝数 | |
friend | num | 关注数 | |
attention | num | 关注数 | |
sign | str | 签名 | |
level_info | obj | 等级 | |
pendant | obj | 挂件 | |
nameplate | obj | 勋章 | |
Official | obj | 认证信息 | |
official_verify | obj | 认证信息2 | |
vip | obj | 大会员状态 | |
space | obj | 主页头图 |
card
中的level_info
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
current_level | num | 当前等级 | 0-6级 |
current_min | num | 0 | 作用尚不明确 |
current_exp | num | 0 | 作用尚不明确 |
next_exp | num | 0 | 作用尚不明确 |
card
中的pendant
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
pid | num | 挂件id | |
name | str | 挂件名称 | |
image | str | 挂件图片url | |
expire | num | 0 | 作用尚不明确 |
card
中的nameplate
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
nid | num | 勋章id | 详细说明有待补充 |
name | str | 勋章名称 | |
image | str | 挂件图片url 正常 | |
image_small | str | 勋章图片url 小 | |
level | str | 勋章等级 | |
condition | str | 勋章条件 |
card
中的Official
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role | num | 认证类型 | 见用户认证类型一览 |
title | str | 认证信息 | 无为空 |
desc | str | 认证备注 | 无为空 |
type | num | 是否认证 | -1:无 0:UP主认证 1:机构认证 |
card
中的official_verify
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
type | num | 是否认证 | -1:无 0:UP主认证 1:机构认证 |
desc | str | 认证信息 | 无为空 |
card
中的vip
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
vipType | num | 大会员类型 | 0:无 1:月度大会员 2:年度及以上大会员 |
dueRemark | str | 空 | 作用尚不明确 |
accessStatus | num | 0 | 作用尚不明确 |
vipStatus | num | 大会员状态 | 0:无 1:有 |
vipStatusWarn | str | 空 | 作用尚不明确 |
theme_type | num | 0 | 作用尚不明确 |
card
中的space
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
s_img | str | 主页头图url 小图 | |
l_img | str | 主页头图url 正常 |
示例:
curl -G 'https://api.bilibili.com/x/web-interface/card' \
--data-urlencode 'mid=2' \
--data-urlencode 'photo=true' \
-b 'SESSDATA=xxx'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"card": {
"mid": "2",
"name": "碧诗",
"approve": false,
"sex": "男",
"rank": "20000",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"DisplayRank": "0",
"regtime": 0,
"spacesta": 0,
"birthday": "",
"place": "",
"description": "",
"article": 0,
"attentions": [],
"fans": 969999,
"friend": 234,
"attention": 234,
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数\u003e=10万"
},
"Official": {
"role": 2,
"title": "bilibili创始人(站长)",
"desc": "",
"type": 0
},
"official_verify": {
"type": 0,
"desc": "bilibili创始人(站长)"
},
"vip": {
"type": 2,
"status": 1,
"due_date": 3896524800000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "十年大会员",
"label_theme": "ten_annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 7,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"vipType": 2,
"vipStatus": 1
}
},
"space": {
"s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
"l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
},
"following": true,
"archive_count": 37,
"article_count": 0,
"follower": 969999,
"like_num": 3547978
}
}
登录用户空间详细信息
请求方式:GET
认证方式:Cookie(SESSDATA)
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -101:未登录 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | obj | 信息本体 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | mid | |
name | str | 昵称 | |
sex | str | 性别 | 男 女 保密 |
face | str | 头像图片url | |
sign | str | 签名 | |
rank | num | 10000 | 作用尚不明确 |
level | num | 当前等级 | 0-6级 |
jointime | num | 0 | 作用尚不明确 |
moral | num | 节操 | 默认70 |
silence | num | 封禁状态 | 0:正常 1:被封 |
email_status | num | 已验证邮箱 | 0:未验证 1:已验证 |
tel_status | num | 已验证手机号 | 0:未验证 1:已验证 |
identification | num | 1 | 作用尚不明确 |
vip | obj | 大会员状态 | |
birthday | num | 生日 | 时间戳 |
is_tourist | num | 0 | 作用尚不明确 |
is_fake_account | num | 0 | 作用尚不明确 |
pin_prompting | num | 0 | 作用尚不明确 |
is_deleted | num | 0 | 作用尚不明确 |
coins | num | 硬币数 | |
following | num | 粉丝数 | |
follower | num | 粉丝数 |
data
中的vip
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
type | num | 会员类型 | 0:无 1:月大会员 2:年度及以上大会员 |
status | num | 会员状态 | 0:无 1:有 |
due_date | num | 会员过期时间 | Unix时间戳(毫秒) |
theme_type | num | 0 | 作用尚不明确 |
label | obj | 会员标签 | |
avatar_subscript | num | 是否显示会员图标 | 0:不显示 1:显示 |
nickname_color | str | 会员昵称颜色 | 颜色码 |
vip
中的label
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
path | str | 空 | 作用尚不明确 |
text | str | 会员名称 | |
label_theme | str | 会员标签 | vip:大会员 annual_vip:年度大会员 ten_annual_vip:十年大会员 hundred_annual_vip:百年大会员 |
data
中的pendant
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
pid | num | 挂件id | 详细说明有待补充 |
name | str | 挂件名称 | |
image | str | 挂件图片url | |
expire | num | 0 | 作用尚不明确 |
data
中的nameplate
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
nid | num | 勋章id | 详细说明有待补充 |
name | str | 勋章名称 | |
image | str | 挂件图片url 正常 | |
image_small | str | 勋章图片url 小 | |
level | str | 勋章等级 | |
condition | str | 勋章条件 |
data
中的Official
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
role | num | 认证类型 | 见用户认证类型一览 |
title | str | 认证信息 | 无为空 |
desc | str | 认证备注 | 无为空 |
type | num | 是否认证 | -1:无 0:认证 |
data
中的level_exp
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
current_level | num | 当前等级 | 0-6级 |
current_min | num | 0 | 指当前等级从多少经验值开始 |
current_exp | num | 0 | 当前账户的经验值 |
next_exp | num | 0 | 下一个等级所需的经验值**(不是还需要多少)** |
示例:
curl -G 'https://api.bilibili.com/x/space/myinfo' \
-b 'SESSDATA=xxx'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"name": "社会易姐QwQ",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"sign": "高考刚结束的普通技术宅一枚,喜欢MC和编程以及电子,是车车人也是术术人,粉丝群:1136462265",
"rank": 10000,
"level": 5,
"jointime": 0,
"moral": 70,
"silence": 0,
"email_status": 1,
"tel_status": 1,
"identification": 1,
"vip": {
"type": 2,
"status": 1,
"due_date": 1644163200000,
"vip_pay_type": 0,
"theme_type": 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",
"role": 3,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
},
"pendant": {
"pid": 2511,
"name": "初音未来13周年",
"image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp",
"image_enhance_frame": "http://i0.hdslb.com/bfs/garb/item/127c507ec8448be30cf5f79500ecc6ef2fd32f2c.png"
},
"nameplate": {
"nid": 4,
"name": "青铜殿堂",
"image": "http://i0.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
"image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
"level": "普通勋章",
"condition": "单个自制视频总播放数\u003e=1万"
},
"official": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"birthday": 1015257600,
"is_tourist": 0,
"is_fake_account": 0,
"pin_prompting": 0,
"is_deleted": 0,
"in_reg_audit": 0,
"is_rip_user": false,
"profession": {
"id": 0,
"name": "",
"show_name": ""
},
"level_exp": {
"current_level": 5,
"current_min": 10800,
"current_exp": 27125,
"next_exp": 28800
},
"coins": 9,
"following": 1122,
"follower": 1122
}
}
多用户详细信息
https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards
请求方式:GET
可以同时获取较多的用户信息(据测试可以一次性获取 2000 多个用户的信息;若获取更多用户信息可能会返回 -504 服务调用超时
)
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用, 分隔 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | obj | 信息本体 | 用户信息随机排序 |
data
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
{用户mid} | obj | 该mid对应的用户信息 | |
…… | obj | …… | …… |
data
中的{用户mid}
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
face | str | 头像链接 | |
face_nft | num | 是否为 NFT 头像 | 0:不是 NFT 头像 1:是 NFT 头像 |
face_nft_new | num | 是否为新版 NFT 头像 | |
mid | str | mid | |
name | str | 昵称 | |
name_render | 有效时:obj 无效时:null |
昵称渲染信息 | |
nameplate | 有效时:obj 无效时:null |
勋章信息 | 基本同「用户空间详细信息」中的 data.nameplate 对象 |
official | obj | 认证信息 | 基本同「用户空间详细信息」中的 data.official 对象 |
pendant | 有效时:obj 无效时:null |
头像框信息 | 基本同「用户空间详细信息」中的 data.pendant 对象,其中有些类型为 num 的字段在本接口中类型为 str |
vip | obj | 会员信息 | 基本同「用户空间详细信息」中的 data.vip 对象,其中有些类型为 num 的字段在本接口中类型为 str |
{用户mid}
中的name_render
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
colors_info | obj | 昵称颜色信息(?) | 作用尚不明确 |
render_scheme | str | "Default" 或 "Colorful" |
作用尚不明确 |
name_render
中的colors_info
对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
color | array | 昵称颜色(?) | 作用尚不明确 |
color_ids | array | ["6"] |
作用尚不明确 |
color
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 颜色1 | |
n | obj | 颜色(n+1) | |
…… | obj | …… | …… |
color
数组中的对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
color_day | str | 浅色模式昵称颜色 | HEX颜色代码 |
color_night | str | 深色模式昵称颜色 | HEX颜色代码 |
示例:
查询用户uids=1,2,3
的详细信息
curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
--data-urlencode 'uids=1,2,3'
查看响应示例:
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"1": {
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"face_nft": 0,
"face_nft_new": 0,
"mid": "1",
"name": "bishi",
"name_render": {
"colors_info": { "color": [], "color_ids": [ "6" ] },
"render_scheme": "Default"
},
"nameplate": null,
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
"pendant": null,
"vip": {
"avatar_icon": {
"icon_resource": {
"type": "ICON_RES_TYPE_IMAGE",
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
},
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
},
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": "1883059200000",
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/fb0a74b14d6a4e119ae301ba2693febeda051030.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png",
"label_theme": "ten_annual_vip",
"path": "",
"text": "十年大会员",
"text_color": "#FFFFFF",
"use_img_label": true
},
"nickname_color": "#FB7299",
"role": "7",
"status": 1,
"theme_type": 0,
"tv_due_date": "1633622400",
"tv_vip_pay_type": 0,
"tv_vip_status": 0,
"type": 2,
"vip_pay_type": 1
}
},
"2": {
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"face_nft": 0,
"face_nft_new": 0,
"mid": "2",
"name": "碧诗",
"name_render": {
"colors_info": { "color": [], "color_ids": [ "6" ] },
"render_scheme": "Default"
},
"nameplate": {
"condition": "所有自制视频总播放数>=10万",
"image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"name": "见习偶像",
"nid": 10
},
"official": { "desc": "", "role": 2, "title": "bilibili创始人(站长)", "type": 0 },
"pendant": {
"expire": "0",
"image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png",
"image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp",
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png",
"n_pid": "32257",
"name": "EveOneCat2",
"pid": 32257
},
"vip": {
"avatar_icon": {
"icon_resource": {
"type": "ICON_RES_TYPE_IMAGE",
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
},
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
},
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": "3968841600000",
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/53845a8ab8b226131c5d89b198d4b61de91d0aa2.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png",
"label_theme": "ten_annual_vip",
"path": "",
"text": "十年大会员",
"text_color": "#FFFFFF",
"use_img_label": true
},
"nickname_color": "#FB7299",
"role": "7",
"status": 1,
"theme_type": 0,
"tv_due_date": "2003500800",
"tv_vip_pay_type": 1,
"tv_vip_status": 1,
"type": 2,
"vip_pay_type": 0
}
},
"3": {
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"face_nft": 0,
"face_nft_new": 0,
"mid": "3",
"name": "囧囧倉",
"name_render": {
"colors_info": {
"color": [
{ "color_day": "#CB7919", "color_night": "#E2963C" },
{ "color_day": "#E6A75B", "color_night": "#E6A75B" },
{ "color_day": "#E9BD67", "color_night": "#F8CE7E" }
],
"color_ids": [ "6" ]
},
"render_scheme": "Colorful"
},
"nameplate": null,
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
"pendant": null,
"vip": {
"avatar_icon": null,
"avatar_subscript": 0,
"avatar_subscript_url": "",
"due_date": "0",
"label": {
"bg_color": "",
"bg_style": 0,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png",
"label_theme": "",
"path": "",
"text": "",
"text_color": "",
"use_img_label": true
},
"nickname_color": "",
"role": "0",
"status": 0,
"theme_type": 0,
"tv_due_date": "0",
"tv_vip_pay_type": 0,
"tv_vip_status": 0,
"type": 0,
"vip_pay_type": 0
}
}
}
}
多用户详细信息2
请求方式:GET
本接口较其他接口相比,只会返回非常有限的信息
url参数:
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用, 分隔,最多50个成员,若超过此限制则返回的data 数组为空 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -400:请求错误 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 | |
data | array | 信息本体 | 用户信息随机排序 |
data
数组:
项 | 类型 | 内容 | 备注 |
---|---|---|---|
0 | obj | 用户1 | |
n | obj | 用户(n+1) | |
…… | obj | …… | …… |
data
数组中的对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
mid | num | mid | |
name | str | 昵称 | |
face | str | 头像链接 | |
sign | str | 签名 | |
rank | num | 用户权限等级 | |
level | num | 当前等级 | 0-6 级 |
silence | num | 封禁状态 | 0:正常 1:被封 |
示例:
查询用户uids=1,2,3
的详细信息
curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
--data-urlencode 'uids=1,2,3'
查看响应示例:
{
"code": 0,
"message": "",
"ttl": 1,
"data": [{
"mid": 1,
"name": "bishi",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"sign": "",
"rank": 10000,
"level": 6,
"silence": 0
}, {
"mid": 2,
"name": "碧诗",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"silence": 0
}, {
"mid": 3,
"name": "囧囧倉",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 6,
"silence": 0
}]
}