Douyin Live room API

Read the current state of one Douyin live room by room_id: title, is_live, viewer_count, like_count and started_at, plus the stream addresses in streams while it is live, for $0.79 per 1,000 calls.

  • room_id is all digits, and a https://live.douyin.com/<ID> link also works.
  • is_live and viewer_count are the values at the moment of the call.
  • Failed calls and empty results are not charged.

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "douyin",
      "action": "live_room",
      "params": {
        "room_id": "376034101029"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "room_id": string,
          "live_id": string,
          "title": string,
          "is_live": number
        },
        …
      ]
    }
  3. 3Fields

    room_idlive_idtitleis_live
    stringstringstringnumber
  4. 4CSV

    douyin-live_room-sample.csv room_id,live_id,title,is_live,url,cover_image_url,author_name,author_id,author_douyin_id,author_avatar_url,author_is_verified,like_count,viewer_count,started_at,streams,platform

A request with room_id goes in, and one JSON object comes back with fields such as title, is_live and viewer_count, listed as a field table and a CSV file.

What data you get

This endpoint has no public real sample yet. The table lists the fields, types and meanings that each row returns, with no values.

FieldTypeMeaning
room_idstringLive room ID (live_room): the number in live.douyin.com/<room_id>.
live_idstringID of this live session (live_room); the same room gets a new one each time it goes live.
titlestringTitle. null when the platform has no titles (for example text-only posts).
is_livenumberWhether the account (profile, creator_search) or the room (live_room) was live at the moment of the call; a point-in-time state.
urlstringLink to the record on the platform.
cover_image_urlstringCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
author_namestringAuthor's display name.
author_idstringAuthor's unique ID on the platform.
author_douyin_idstringThe author's Douyin ID.
author_avatar_urlstringAuthor avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows.
author_is_verifiedbooleanWhether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is).
like_countnumberLikes. null means the platform or this capability does not disclose it; it is not 0.
viewer_count—People watching the room now (live_room); a point-in-time figure.
started_at—When the live session started (live_room, ISO 8601, UTC); absent when not given.
streams—Live pull URLs (live_room): [{quality, format (such as flv, hls), url}]. The URLs are signed and expire; absent when the room is not live.
platformstringSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Use cases

  • Check whether a room is live

    Read is_live, then title and started_at when it is on.

  • Record viewers over time

    Read viewer_count and like_count at a fixed interval and store your own audience curve for a stream.

  • Identify the host

    author_name, author_id and author_douyin_id tell you who is streaming in the room.

  • Get the session number

    Read live_id and pass it to live_session for the session details, or to live_viewers for the viewer list.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation and EveryInfra live_room compare on which live room you can read and how you get access.

ComparedDouyin Open PlatformEveryInfra
Which live roomThe documentation says the capability only supports jumping to the live rooms of bound Douyin accounts.room_id names one live room. The room does not need to belong to a bound Douyin account.
AccessThe documentation says the capability can be used once the platform review passes.No application and no account binding: the request holds only your EveryInfra API key and room_id.

The Douyin Open Platform documentation is in Chinese. The table shows a translation, checked against the page on 2026-11-22. The page shows no update date. Official sources: Guide users to jump to a live room

Limits and gotchas

  • room_id is required. It is the all-digit live room ID, and a https://live.douyin.com/<ID> link also works.
  • is_live and viewer_count are the state at the moment of the call and change soon after.
  • streams holds the stream addresses (quality, format and link). They are signed, they expire, and they are absent when the room is not live.
  • When Douyin gives no start time, the started_at key is absent.
  • live_id is the number of one live session and is different each time the room goes live. room_id is the ID of the room.
  • One call reads one live room and returns one object.

Pricing

You pay $0.000792 per call, not per field, and one call reads one live room. Failed calls and empty results are not charged.

CallsCost
10,000$7.92
100,000$79.17
1,000,000$791.67

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "live_room",
  "params": {
    "room_id": "376034101029"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for live_room, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Douyin Live room endpoint (douyin/live_room).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to douyin and action to live_room, and put the parameters inside params.
- Required parameters:
  - room_id: Numeric Douyin live room ID, the number in https://live.douyin.com/<room_id>; the link itself is accepted too.
- Returns one object. Main fields: room_id (Live room ID (live_room): the number in…), live_id (ID of this live session (live_room)), title, is_live (Whether the account (profile, creator_s…), url, cover_image_url (Cover image URL: the cover of a video o…), author_name, author_id, author_douyin_id (The author's Douyin ID), author_avatar_url (Author avatar image URL: the creator on…), author_is_verified (Whether the author is verified (search…), like_count; 15 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "live_room",
  "params": {
    "room_id": "376034101029"
  }
}
- Price: $0.79 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesdouyinPlatform identifier, fixed value.
actionbodystringYeslive_roomCapability identifier, fixed value.
room_idbody.paramsstringYes-Numeric Douyin live room ID, the number in https://live.douyin.com/<room_id>; the link itself is accepted too.

Response example

#
No sample response is available for these parameters yet. This preview shows the response shape and fields from the API definition, with … as placeholders; it is not the result of a live call.
json
{  "id": "req_…",  "platform": "douyin",  "action": "live_room",  "results": {    "room_id": …,    "live_id": …,    "title": …,    "is_live": …,    "url": …,    "cover_image_url": …,    "author_name": …,    "author_id": …,    "author_douyin_id": …,    "author_avatar_url": …,    "author_is_verified": …,    "like_count": …,    "viewer_count": …,    "started_at": …,    "streams": …,    "platform": …  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
room_idLive room ID (live_room): the number in live.douyin.com/<room_id>.
live_idID of this live session (live_room); the same room gets a new one each time it goes live.
titleTitle. null when the platform has no titles (for example text-only posts).
is_liveWhether the account (profile, creator_search) or the room (live_room) was live at the moment of the call; a point-in-time state.
urlLink to the record on the platform.
cover_image_urlCover image URL: the cover of a video or image post on search, user_posts, posts_batch, related_posts, mix_posts, music_posts and media_links rows; the music cover on music_search and music_detail; the topic image on billboard_topic_hot; the collection cover on user_mixes; the room cover on live_room. Signed links expire.
author_nameAuthor's display name.
author_idAuthor's unique ID on the platform.
author_douyin_idThe author's Douyin ID.
author_avatar_urlAuthor avatar image URL: the creator on search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows, the host on live_room, the commenter on comments rows.
author_is_verifiedWhether the author is verified (search / user_posts / video / posts_batch / related_posts / mix_posts / music_posts rows; on live_room, whether the host is; on comments rows, whether the commenter is).
like_countLikes. null means the platform or this capability does not disclose it; it is not 0.
viewer_countPeople watching the room now (live_room); a point-in-time figure.
started_atWhen the live session started (live_room, ISO 8601, UTC); absent when not given.
streamsLive pull URLs (live_room): [{quality, format (such as flv, hls), url}]. The URLs are signed and expire; absent when the room is not live.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Douyin live room API return?

One object: room_id, live_id, title, is_live, url, cover_image_url, author_name, author_id, author_douyin_id, like_count, viewer_count, started_at, streams and more.

What is the difference between room_id and live_id?

room_id is the number in a live.douyin.com link and names a room. live_id numbers one session of that room and changes each time it goes live. Use live_id to read the details and the viewer list of one session.

Can I use is_live and viewer_count as history?

No. They are the values at the moment you read. To track change, read again at a fixed interval and store the results yourself. To look up a session that has ended, use live_session with its live_id; it works after the session ends.

How much does it cost to read a live room?

$0.000792 per call, or $0.79 per 1,000 calls, counted by calls and not by fields. Failed calls and empty results are not charged.

You can call the other Douyin endpoints with the same EveryInfra API key.

Google Analytics needs consent. Privacy