bilibili-API-collect/live/info.md

直播间基本信息

• 直播间基本信息
  • 获取用户对应的直播间状态
  • 获取房间页初始化信息
  • 获取主播信息
  • 批量查询直播间状态

---

获取用户对应的直播间状态

https://api.live.bilibili.com/room/v1/Room/getRoomInfoOld

请求方式：GET

url参数：

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

json回复：

根对象：

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

data对象：

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

示例：

查询用户mid=322892的直播间信息

curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \
--data-urlencode 'mid=322892'

查看响应示例：

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"roomStatus": 1,
		"roundStatus": 0,
		"liveStatus": 1,
		"url": "https://live.bilibili.com/5441",
		"title": "好久没当黑铁主播了",
		"cover": "http://i0.hdslb.com/bfs/live/room_cover/833f7ff506bac17c06010e8834922993657505b2.jpg",
		"online": 268602,
		"roomid": 5441,
		"broadcast_type": 0,
		"online_hidden": 0
	}
}

获取房间页初始化信息

http://api.live.bilibili.com/room/v1/Room/room_init

请求方式：GET

url参数：

参数名	类型	内容	必要性	备注
id	num	目标直播间号（短号）	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 60004：直播间不存在
msg	str	错误信息	默认为ok
message	str	错误信息	默认为ok
data	obj	信息本体

data对象：

字段	类型	内容	备注
room_id	num	直播间真实id
short_id	num	直播间id（短号）
uid	num	主播用户mid
need_p2p	num	是否p2p
is_hidden	bool	是否隐藏
is_locked	bool	是否锁定
is_portrait	bool	是否竖屏
live_status	num	直播状态	0：未开播 1：直播中 2：轮播中
hidden_till	num	隐藏时间戳
lock_till	num	锁定时间戳
encrypted	bool	是否加密
pwd_verified	bool	加密房间是否通过密码验证	encrypted=true时才有意义
live_time	num	开播时间	未开播时为-62170012800
room_shield	num	未知
is_sp	num	是否为特殊直播间	0：普通直播间 1：付费直播间
special_type	num	特殊直播间标志	0：普通直播间 1：付费直播间 2：拜年祭直播间

示例：

查询直播间id=76的直播间信息

curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \
--data-urlencode 'id=76'

查看响应示例：

{
	"code":0,
	"msg":"ok",
	"message":"ok",
	"data":{
		"room_id":14073662,
		"short_id":76,
		"uid":50333369,
		"need_p2p":0,
		"is_hidden":false,
		"is_locked":false,
		"is_portrait":false,
		"live_status":1,
		"hidden_till":0,
		"lock_till":0,
		"encrypted":false,
		"pwd_verified":false,
		"live_time":1602151186,
		"room_shield":1,
		"is_sp":0,
		"special_type":0
	}
}

获取主播信息

http://api.live.bilibili.com/live_user/v1/Master/info

请求方式：GET

url参数：

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

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 1：参数错误
msg	str	错误信息	默认为空
message	str	错误信息	默认为空
data	obj	信息本体

data对象：

字段	类型	内容	备注
info	obj	主播信息
exp	obj	经验等级
follower_num	num	主播粉丝数
room_id	num	直播间id（短号）
medal_name	str	粉丝勋章名
glory_count	num	主播荣誉数
pendant	str	直播间头像框url
link_group_num	num	0	作用尚不明确
room_news	obj	主播公告

info对象：

字段	类型	内容	备注
uid	num	主播mid
uname	str	主播用户名
face	str	主播头像url
official_verify	obj	认证信息
gender	num	主播性别	-1：保密 0：女 1：男

info中的official_verify对象：

字段	类型	内容	备注
type	num	主播认证类型	-1：无 0：个人认证 1：机构认证
desc	str	主播认证信息

exp对象：

字段	类型	内容	备注
master_level	obj	主播等级

exp中的master_level对象：

字段	类型	内容	备注
level	num	当前等级
color	num	等级框颜色
current	array	当前等级信息
next	array	下一等级信息

master_level中的current数组：

项	类型	内容	备注
0	num	升级积分
1	num	总积分

master_level中的next数组：

项	类型	内容	备注
0	num	升级积分
1	num	总积分

room_news对象：

字段	类型	内容	备注
content	str	公告内容
ctime	str	公告时间
ctime_text	str	公告日期

示例：

查询直播间mid=76的主播信息

curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \
--data-urlencode 'uid=2'

查看响应示例：

{
	"code": 0,
	"msg": "",
	"message": "",
	"data": {
		"info": {
			"uid": 2,
			"uname": "碧诗",
			"face": "https://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
			"official_verify": {
				"type": 0,
				"desc": "bilibili个人认证:bilibili创始人（站长）"
			},
			"gender": 1
		},
		"exp": {
			"master_level": {
				"level": 30,
				"color": 10512625,
				"current": [
					2870000,
					11883810
				],
				"next": [
					3730000,
					15613810
				]
			}
		},
		"follower_num": 926624,
		"room_id": 1024,
		"medal_name": "逸国",
		"glory_count": 0,
		"pendant": "",
		"link_group_num": 0,
		"room_news": {
			"content": "",
			"ctime": "",
			"ctime_text": ""
		}
	}
}

批量查询直播间状态

http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids

请求方式：GET/POST

认证方式：无 (无需添加Cookie)

url参数 (GET方式)：

参数名	类型	内容	必要性	备注
uids[]	array	要查询的主播 mid	必要

正文参数 (POST方式)：

参数名	类型	内容	必要性	备注
uids	nums	要查询的主播 mid	必要

json回复：

根对象：

字段	类型	内容	备注
code	num	返回值	0：成功 -111：csrf校验失败
message	str	错误信息	默认为success
msg	str	错误信息	默认为success
ttl	num	1
data	obj	信息本体

data对象：

字段	类型	内容	备注
uid	str	直播间信息	实际字段为主播mid

uid对象：

字段	类型	内容	备注
area	num	直播间分区id
area_name	str	直播间分区名
area_v2_id	num	直播间新版分区id
area_v2_name	str	直播间新版分区名
area_v2_parent_id	num	直播间父分区id
area_v2_parent_name	str	直播间父分区名
broadcast_type	num	直播类型	0:普通直播 1：手机直播
cover_from_user	str	直播间封面url
face	str	主播头像url
hidden_till	str	直播间隐藏信息
keyframe	str	直播间关键帧url
live_status	num	直播间开播状态	0：未开播 1：正在直播 2：轮播中
live_time	num	直播持续时长
lock_till	str	直播间封禁信息
online	num	直播间在线人数
room_id	num	直播间房间号	直播间实际房间号
short_id	num	直播间房间号	直播间短房间号，常见于签约主播
tag_name	str	直播间标签
tags	str	直播间自定标签
title	str	直播间标题
uid	num	主播mid
uname	str	主播用户名

示例：

查询用户`mid=672328094的直播间信息

# GET方式
curl -G 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids'
--data-urlencode 'uids[]=672328094'

# POST方式
curl 'http://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids' \
-H "Content-Type: application/json" \
-d "{\"uids\": [672328094]}" 

查看响应示例：

{
    "code": 0,
    "msg": "success",
    "message": "success",
    "data": {
        "672328094": {
            "title": "【B限】玩个毛线",
            "room_id": 22637261,
            "uid": 672328094,
            "online": 4087370,
            "live_time": 0,
            "live_status": 2,
            "short_id": 0,
            "area": 6,
            "area_name": "生活娱乐",
            "area_v2_id": 371,
            "area_v2_name": "虚拟主播",
            "area_v2_parent_name": "虚拟主播",
            "area_v2_parent_id": 9,
            "uname": "嘉然今天吃什么",
            "face": "http://i2.hdslb.com/bfs/face/d399d6f5cf7943a996ae96999ba3e6ae2a2988de.jpg",
            "tag_name": "日常,学习,萌宠,厨艺,手机直播",
            "tags": "",
            "cover_from_user": "http://i0.hdslb.com/bfs/live/new_room_cover/f3ed7a782c13086e536ec8bc6e9593bb4918f905.jpg",
            "keyframe": "http://i0.hdslb.com/bfs/live-key-frame/keyframe041722000000226372619dr3m8.jpg",
            "lock_till": "0000-00-00 00:00:00",
            "hidden_till": "0000-00-00 00:00:00",
            "broadcast_type": 0
        }
    }
}