bilibili-API-collect/user/info.md
2020-11-27 23:39:07 +08:00

29 KiB
Raw Blame History

用户基本信息


用户详细信息1 (用于空间)

http://api.bilibili.com/x/space/acc/info

请求方式GET

认证方式CookieSESSDATA

url参数

参数名 类型 内容 必要性 备注
mid num 目标用户UID 必要

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-400请求错误
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
mid num UID
name str 昵称
sex str 性别 男/女/保密
face str 头像链接
sign str 签名
rank num 10000
level num 当前等级 0-6级
jointime num 0
moral num 0
silence num 封禁状态 0正常
1被封
birthday str 生日 MM-DD
如设置隐私为空
coins num 硬币数 需要登录(Cookie)
只能查看自己的
默认为0
fans_badge bool 是否具有粉丝勋章 false
true
official obj 认证信息
vip obj 会员信息
pendant obj 头像框信息
nameplate obj 勋章信息
is_followed bool 是否关注此用户 true已关注
false未关注
需要登录(Cookie)
未登录恒为false
top_photo str 主页头图链接
theme obj 作用尚不明确
sys_notice obj 系统通知 无内容则为空
live_room obj 直播间信息

data中的official对象:

字段 类型 内容 备注
role num 认证类型 0
1 2个人认证
3 4 5 6机构认证
title str 认证信息 无为空
desc str 认证备注 无为空
type num 是否认证 -1
0认证

data中的vip对象:

字段 类型 内容 备注
type num 会员类型 0
1月大会员
2年度及以上大会员
status num 会员状态 0
1
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中的sys_notice对象:

字段 类型 内容 备注
id num 系统提示类型ID 详细说明有待补充
content str 提示信息
url str 提示信息链接url

data中的live_room对象:

字段 类型 内容 备注
roomStatus num 直播间状态 0无房间
1有房间
liveStatus num 直播状态 0未开播
1直播中
url str 直播间网页url
title str 直播间标题
cover str 直播间封面url
online num 直播间人气 值为上次直播时刷新
roomid num 直播间ID短号
roundStatus num 轮播状态 0未轮播
1轮播
broadcast_type num 0

示例:

查询用户UID=2的详细信息

curl -G 'http://api.bilibili.com/x/space/acc/info' \
--data-urlencode 'mid=2' \
-b 'SESSDATA=xxx'
查看响应示例:
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "mid": 2,
        "name": "碧诗",
        "sex": "男",
        "face": "http://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
        "sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
        "rank": 20000,
        "level": 6,
        "jointime": 0,
        "moral": 0,
        "silence": 0,
        "birthday": "09-19",
        "coins": 0,
        "fans_badge": true,
        "official": {
            "role": 2,
            "title": "bilibili创始人站长",
            "desc": "",
            "type": 0
        },
        "vip": {
            "type": 2,
            "status": 1,
            "theme_type": 0,
            "label": {
                "path": "",
                "text": "十年大会员",
                "label_theme": "ten_annual_vip"
            },
            "avatar_subscript": 1,
            "nickname_color": "#FB7299"
        },
        "pendant": {
            "pid": 0,
            "name": "",
            "image": "",
            "expire": 0,
            "image_enhance": ""
        },
        "nameplate": {
            "nid": 10,
            "name": "见习偶像",
            "image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
            "image_small": "http://i0.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
            "level": "普通勋章",
            "condition": "所有自制视频总播放数>=10万"
        },
        "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",
            "title": "劲夫专业户",
            "cover": "http://i0.hdslb.com/bfs/vc/266c730abfe5a4716844b1f4d2e308a0020199ee.jpg",
            "online": 16433,
            "roomid": 1024,
            "roundStatus": 0,
            "broadcast_type": 0
        }
    }
}

查询到的信息解析如下:

用户昵称为:碧诗

性别:男

用户的头像为

http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg

等级6级

生日09-19

粉丝勋章状态:拥有

认证:个人认证

认证名称 bilibili创始人站长

大会员类型:年度

大会员状态:已开通

头像框:管理员

http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png

粉丝勋章 见习偶像

http://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png

空间头图

http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png

用户详细信息2 (用于名片)

http://api.bilibili.com/x/web-interface/card

请求方式GET

认证方式CookieSESSDATA

url参数

参数名 类型 内容 必要性 备注
mid num 目标用户UID 必要
photo bool 是否请求用户主页头图 非必要 true
false

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-400请求错误
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
card obj 卡片信息

data中的card对象:

字段 类型 内容 备注
mid num 用户UID
approve bool false 作用尚不明确
name str 用户昵称
sex str 用户性别 男 女 保密
face str 用户头像链接
DisplayRank str 0 作用尚不明确
regtime num 0 作用尚不明确
spacesta num 0 作用尚不明确
birthday str 作用尚不明确
place str 作用尚不明确
description str 作用尚不明确
article num 0 作用尚不明确
attentions array 作用尚不明确
fans num 粉丝数
friend num 关注数
attention num 关注数
level_info obj 等级
pendant obj 挂件
nameplate obj 勋章
Official obj 认证信息
official_verify obj 认证信息2
vip obj 大会员状态
space obj 主页头图
following bool 是否关注此用户 true已关注
false未关注
需要登录(Cookie)
未登录为false
archive_count num 用户稿件数
article_count num 0 作用尚不明确
follower num 粉丝数

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 认证类型 0
1 2个人认证
3 4 5 6机构认证
title str 认证信息 无为空
desc str 认证备注 无为空
type num 是否认证 -1
0认证

card中的official_verify对象:

字段 类型 内容 备注
type num 是否认证 -1
0认证
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 '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://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg",
			"DisplayRank": "0",
			"regtime": 0,
			"spacesta": 0,
			"birthday": "",
			"place": "",
			"description": "",
			"article": 0,
			"attentions": [],
			"fans": 810968,
			"friend": 192,
			"attention": 192,
			"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
			"level_info": {
				"current_level": 6,
				"current_min": 0,
				"current_exp": 0,
				"next_exp": 0
			},
			"pendant": {
				"pid": 76,
				"name": "管理员",
				"image": "http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png",
				"expire": 0
			},
			"nameplate": {
				"nid": 10,
				"name": "见习偶像",
				"image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
				"image_small": "http://i1.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": {
				"vipType": 2,
				"dueRemark": "",
				"accessStatus": 0,
				"vipStatus": 1,
				"vipStatusWarn": "",
				"theme_type": 0
			}
		},
		"space": {
			"s_img": "http://i2.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
			"l_img": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
		},
		"following": true,
		"archive_count": 35,
		"article_count": 0,
		"follower": 810968
	}
}

本用户详细信息

http://api.bilibili.com/x/space/myinfo

请求方式GET

认证方式CookieSESSDATA

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101未登录
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data对象:

字段 类型 内容 备注
mid num UID
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
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 认证类型 0
1 2个人认证
3 4 5 6机构认证
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 '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&电子&8-bit音乐&数码&编程粉丝群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": 1612454400000,
            "vip_pay_type": 1,
            "theme_type": 0,
            "label": {
                "path": "",
                "text": "年度大会员",
                "label_theme": "annual_vip"
            },
            "avatar_subscript": 1,
            "nickname_color": "#FB7299"
        },
        "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"
        },
        "nameplate": {
            "nid": 4,
            "name": "青铜殿堂",
            "image": "http://i2.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
            "image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
            "level": "普通勋章",
            "condition": "单个自制视频总播放数>=1万"
        },
        "official": {
            "role": 0,
            "title": "",
            "desc": "",
            "type": -1
        },
        "birthday": 1015257600,
        "is_tourist": 0,
        "is_fake_account": 0,
        "pin_prompting": 0,
        "is_deleted": 0,
        "level_exp": {
            "current_level": 5,
            "current_min": 10800,
            "current_exp": 20528,
            "next_exp": 28800
        },
        "coins": 40.2,
        "following": 888,
        "follower": 888
    }
}