Social

Query Bilibili Live Room

0calls

4 credits / call

Want to know whether your favourite streamer is on air? Or integrate Bilibili live status into your app? This endpoint covers both cases.

Overview

This is a smart endpoint: you can look up by streamer mid (user ID) or by room_id (the live-room long or short ID). It returns the room's detailed information — including whether the streamer is live, the title, cover, popularity, category, and more.

Response fields

live_status: 0 = not live, 1 = live, 2 = looping pre-recorded content.

Query parameters

mid

stringoptional

Streamer user ID (mid). Pass either mid or room_id.

room_id

stringoptional

Live-room ID, either the long form (real ID) or the short form (room number). Pass either mid or room_id.

Name	Type	Attributes	Description
`mid`	string	optional	Streamer user ID (`mid`). Pass either `mid` or `room_id`.
`room_id`	string	optional	Live-room ID, either the long form (real ID) or the short form (room number). Pass either `mid` or `room_id`.

Response

200 / OK

Success. Returns the live-room details.

JSON

{
  // Streamer user ID (mid).
  "uid": 672328094,
  // Live-room real room number (long form).
  "room_id": 22637261,
  // Live-room short room number. `0` when not configured.
  "short_id": 22625027,
  // Streamer follower count.
  "attention": 1789089,
  // Current popularity value for the live room (matches the on-screen popularity value; not real-time viewer count).
  "online": 3662242,
  // Whether the live stream is blocked.
  "is_portrait": false,
  // Contribution-activity data (returned when `activity=true`).
  "live_status": 1,
  // Category ID.
  "area_id": 372,
  // Parent category name.
  "parent_area_name": "Virtual streamer",
  // Parent category ID.
  "parent_area_id": 9,
  // Subcategory name.
  "area_name": "Virtual idol",
  // Live-room background URL.
  "background": "http://i0.hdslb.com/bfs/live/room_bg/672328094.jpg",
  // Current live-room title.
  "title": "[Limited] Chatting — come hang out",
  // User-set live-stream cover URL.
  "user_cover": "http://i0.hdslb.com/bfs/live/user_cover/672328094.jpg",
  // Live-room announcement, supports line breaks.
  "description": "Sample announcement text",
  // Stream start time, formatted as `YYYY-MM-DD HH:mm:ss`. Empty string when not live.
  "live_time": "2023-10-27 20:00:00",
  // Keyframe image URL.
  "keyframe": "http://i0.hdslb.com/bfs/live-key-frame/keyframe.jpg",
  // Live-room tags, comma-separated.
  "tags": "VUP,Virtual idol,A-SOUL,嘉然",
  // Live-room keywords, typically used in chat interactions.
  "hot_words": [
    "嘉然"
  ],
  // Streamer-equipped badge information.
  "new_pendants": null
}

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/social/bilibili/liveroom'

Frequently asked questions

Are there any special restrictions for the Query Bilibili Live Room API?

Query Bilibili Live Room follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

Related APIs

Query Bilibili User

Want to surface Bilibili user profiles inside your application? This endpoint returns the user's public information.

Query Bilibili Archives

Want to fetch all of a creator's archived videos? Or display a creator's portfolio inside your app? This endpoint makes that easy.

Query Bilibili Video

Want to surface detailed Bilibili video information in your app? Whether it's the cover, title, play count, or creator info — this endpoint returns it all in one call.

Query Hotboards

Want to keep up with what is trending online? This endpoint pulls real-time hot boards from a wide range of major platforms in one call.

PreviousQuery Bilibili Replies

NextQuery QQ Group