Douyin User live API

Check by user_id (a secUid or a profile link) whether a host is live right now. When is_live is true, the object adds room_id, live_id, title, viewer_count and streams, for $0.79 per 1,000 calls.

  • Nicknames, Douyin IDs and short links are not accepted.
  • While live, live_id goes straight into live_session and live_viewers.
  • 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": "user_live",
      "params": {
        "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
      }
    }
  2. 2JSON response

    {
      "results": {
        "author_name": "木•••语",
        "is_live": false,
        "author_id": "MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",
        "author_is_verified": false,
        …
      }
    }
  3. 3Fields

    author_nameis_liveauthor_idauthor_is_verified
    木•••语falseMS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezSfalse
  4. 4CSV

    douyin-user_live-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,author_uid,author_follower_count,is_paid

A request with user_id goes in, and one JSON object comes back with fields such as is_live and author_name, plus room_id and live_id while live, listed as a field table and a CSV file.

What data you get

The table shows a real call for douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS, captured November 21, 2026 at 07:17 (UTC), that returned one object; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.

room_idlive_idtitleis_liveurlcover_image_urlauthor_nameauthor_idauthor_douyin_idauthor_avatar_urlauthor_is_verifiedlike_countviewer_countstarted_atstreamsplatformauthor_uidauthor_follower_countis_paid
nullnullnullfalsenullnull木•••语MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezSfalsenullnullnullnulldouyinnullnull

Use cases

  • Detect when a host goes live

    Read is_live at a fixed interval, and when it turns true, note started_at and title.

  • Find the room that is on air

    When is_live is true, read room_id and pass it to live_room for the room state.

  • Link to the session and the viewer list

    Pass live_id to live_session for the session details and to live_viewers for the viewer list.

  • Confirm the host account

    When the host is not live, the object still carries author fields such as author_name, author_id and author_douyin_id, so you can confirm the account is the one you meant.

Douyin Open Platform vs EveryInfra

Here is how the Douyin Open Platform documentation for the live room status component and EveryInfra user_live compare on which account and the access you need.

ComparedDouyin Open PlatformEveryInfra
Which accountFor the aweme-id parameter, the documentation says only brand accounts and partner accounts bound to the mini program are supported.user_id takes a Douyin user's secUid (starting with MS4w) or a profile link https://www.douyin.com/user/<secUid>. The account does not need to be bound to a mini program.
AccessThe documentation says developers must first apply, in the developer console, for the live breathing-light component capability for the Douyin account.No capability to apply for: the request holds only your EveryInfra API key and user_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: aweme-data live room status component

Limits and gotchas

  • user_id is required. Pass a Douyin user's secUid (starting with MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
  • Only when is_live is true does the object carry room_id, live_id, title, viewer_count and streams; they are absent when the host is not live.
  • is_live is the state at the moment of the call. To detect a stream starting, read again at a fixed interval.
  • streams holds signed stream addresses that expire.
  • is_paid is true when the session is a paid live stream.
  • One call checks one host and returns one object.

Pricing

You pay $0.000792 per call, not per field, and one call checks one host. 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": "user_live",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}'

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 user_live, 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 User live endpoint (douyin/user_live).

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 user_live, and put the parameters inside params.
- Required parameters:
  - user_id: The host whose live status you want: their secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.
- 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; 18 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=douyin.
- Example request body:
{
  "platform": "douyin",
  "action": "user_live",
  "params": {
    "user_id": "https://www.douyin.com/user/MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS"
  }
}
- 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.
actionbodystringYesuser_liveCapability identifier, fixed value.
user_idbody.paramsstringYes-The host whose live status you want: their secUid (starting MS4w) or a profile link https://www.douyin.com/user/<secUid>. Nicknames, Douyin IDs and short links are not accepted.

Response example

#
Captured November 21, 2026 at 07:17 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "douyin",  "action": "user_live",  "results": {    "is_live": false,    "author_name": "木•••语",    "author_id": "MS4wLjABAAAAk1tZ-L085zZf2yW_H5dnVFZWyk8Rt8v4RAvf9KhTyPoVdMDxTs7Q_rvgTJGWXezS",    "author_douyin_id": "•••",    "author_avatar_url": "https://p3-pc.douyinpic.com/•••",    "author_is_verified": false,    "platform": "douyin",    "author_uid": "•••"  },  "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).
author_uidNumeric user ID of the author (on comments, of the commenter). author_id is the secUid; both identify the same person.
author_follower_countAuthor's follower count. null means not disclosed.
is_paidKeeps the platform's own meaning

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 host live status API return?

One object: is_live, author_name, author_id, author_douyin_id, author_avatar_url, author_is_verified and author_uid; while live, also room_id, live_id, title, url, like_count, viewer_count, started_at, streams and is_paid.

What comes back when the host is not live?

is_live is false. room_id, live_id, title, viewer_count and streams are absent, and the author fields such as author_name and author_id are still there.

When do I use user_live and when live_room?

Use user_live when you hold the host's account (a secUid or profile link) and want to know whether they are live. Use live_room when you already hold the room ID (room_id).

How much does it cost to check a host?

$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