# 用户基本信息
## 用户空间详细信息
> https://api.bilibili.com/x/space/wbi/acc/info
*请求方式:GET*
认证方式:Cookie(SESSDATA)
鉴权方式:[Wbi 签名](../misc/sign/wbi.md), Cookie (对于某些 IP 地址,需要在 Cookie 中提供任意非空的 `buvid3` 字段)
~~该接口的旧版 API :~~(已废弃,不建议使用)
**url参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ------------------------------------ |
| mid | num | 目标用户mid | 必要 | |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**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 | 认证类型 | 见 [用户认证类型一览](official_role.md) |
| 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 ||
| 8 | 该用户存在较大争议,请谨慎甄别其内容 | 1 | [28062215](https://space.bilibili.com/28062215) |
| 11 | 该账号涉及合约争议,暂冻结其账号功能使用。详见公告-> | 1 ||
| 16 | 该UP主内容存在争议,请注意甄别视频内信息 | 1 | [382534165](https://space.bilibili.com/382534165) |
| 20 | 请允许我们在此献上最后的告别,以此纪念其在哔哩哔哩留下的回忆与足迹。请点此查看纪念账号相关说明 | 2 |[212535360](https://space.bilibili.com/212535360)|
|22| 该账号涉及合约诉讼,封禁其账号使用 | ||
| 24 | 该账号涉及合约争议,暂冻结其账号功能使用 | 1 | [291229008](https://space.bilibili.com/291229008) |
| 25 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | [81447581](https://space.bilibili.com/81447581) |
| 31 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | [22439273](https://space.bilibili.com/22439273) |
| 34 | 该用户涉及严重指控,暂冻结其账号功能使用 | 1 | [1640486775](https://space.bilibili.com/1640486775) |
| 36 | 该账户存在争议,请谨慎甄别 | 1 ||
`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 签名](../misc/sign/wbi.md) 文档
```shell
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'
```
查看响应示例:
```json
{
"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
}
}
}
```
## 用户名片信息
> https://api.bilibili.com/x/web-interface/card
*请求方式:GET*
**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 | 认证类型 | 见[用户认证类型一览](official_role.md) |
| 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 正常 | |
**示例:**
```shell
curl -G 'https://api.bilibili.com/x/web-interface/card' \
--data-urlencode 'mid=2' \
--data-urlencode 'photo=true'
```
查看响应示例:
```json
{
"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
}
}
```
## 登录用户空间详细信息
> https://api.bilibili.com/x/space/myinfo
*请求方式: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 | 认证类型 | 见[用户认证类型一览](official_role.md) |
| 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 | 下一个等级所需的经验值**(不是还需要多少)** |
**示例:**
```shell
curl -G 'https://api.bilibili.com/x/space/myinfo' \
-b 'SESSDATA=xxx'
```
查看响应示例:
```json
{
"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*
**url参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | ---------------------------------- |
| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔,最多200个成员 |
**json回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | -------------------------------------------------------- |
| code | num | 返回值 | 0:成功
-400:请求错误
40143:批量大小超过限制 |
| 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`的详细信息
```shell
curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
--data-urlencode 'uids=1,2,3'
```
查看响应示例:
```json
{
"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
> https://api.vc.bilibili.com/account/v1/user/cards
*请求方式: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`的详细信息
```shell
curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
--data-urlencode 'uids=1,2,3'
```
查看响应示例:
```json
{
"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
}]
}
```