社交

查询 B站直播间

0次调用
4 积分/次

想知道你喜欢的主播开播了吗?或者想在你的应用里集成B站直播间状态?这个接口能满足你。

GET
uapis.cn
/api/v1/social/bilibili/liveroom
查询参数
2
mid
string

主播的用户ID (mid)。与 room_id 任选其一。

room_id
string

直播间ID,可以是长号(真实ID)或短号(靓号)。与 mid 任选其一。

功能概述

这是一个智能接口,你可以用主播的 mid (用户ID) 或者直播间的 room_id (长号或短号)来查询。它会返回直播间的详细信息,包括是否在直播、标题、封面、人气、分区等。

响应体字段说明

  • live_status (直播状态): 0 代表未开播,1 代表直播中,2 代表轮播中。

查询参数

mid
string可选

主播的用户ID (mid)。与 room_id 任选其一。

room_id
string可选

直播间ID,可以是长号(真实ID)或短号(靓号)。与 mid 任选其一。

响应

200 / 请求成功

成功!返回直播间的详细信息。

JSON
{
  // 主播的用户ID (mid)。
  "uid": 672328094,
  // 直播间的真实房间号(长号)。
  "room_id": 22637261,
  // 直播间的短号(靓号)。如果没有设置,则为0。
  "short_id": 22625027,
  // 主播的粉丝数(关注数量)。
  "attention": 1789089,
  // 直播间当前的人气值(对应你文档里的 PopularValue,不代表真实在线人数)。
  "online": 3662242,
  // 是否为竖屏直播。
  "is_portrait": false,
  // 直播状态。0:未开播, 1:直播中, 2:轮播中。
  "live_status": 1,
  // 分区ID。
  "area_id": 372,
  // 父分区名称。
  "parent_area_name": "虚拟主播",
  // 父分区 ID。
  "parent_area_id": 9,
  // 子分区名称。
  "area_name": "虚拟偶像",
  // 直播间背景图的URL。
  "background": "http://i0.hdslb.com/bfs/live/room_bg/672328094.jpg",
  // 当前直播间的标题。
  "title": "【B限】杂谈~来聊聊天吧~",
  // 用户设置的直播间封面URL。
  "user_cover": "http://i0.hdslb.com/bfs/live/user_cover/672328094.jpg",
  // 直播间公告或描述,支持换行符。
  "description": "这里是嘉然的直播间,欢迎回家!",
  // 本次直播开始的时间,格式为 `YYYY-MM-DD HH:mm:ss`。如果未开播,则为空字符串。
  "live_time": "2023-10-27 20:00:00",
  // 关键帧封面图链接。
  "keyframe": "http://i0.hdslb.com/bfs/live-key-frame/keyframe.jpg",
  // 直播间设置的标签,以逗号分隔。
  "tags": "VUP,虚拟偶像,A-SOUL,嘉然",
  // 直播间热词列表,通常用于弹幕互动。
  "hot_words": [
    "嘉门"
  ],
  // 主播佩戴信息。
  "new_pendants": null
}