Douyin Broadcast details API

Read the details of one Douyin live session by live_id: title, is_live, like_count, the host's author_name and author_follower_count, plus is_paid. It works after the session ends, for $0.79 per 1,000 calls.

  • live_id comes from live_room or user_live and changes each time the room goes live.
  • Compared with live_room, it adds author_uid, author_follower_count and is_paid.
  • 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_session",
      "params": {
        "live_id": "7710380709042457398"
      }
    }
  2. 2JSON response

    {
      "results": {
        "author_name": "查•••A",
        "room_id": "569635859833",
        "live_id": "7710380709042457398",
        "title": "GTA6全流程直播!",
        …
      }
    }
  3. 3Fields

    author_nameroom_idlive_idtitle
    查•••A5696358598337710380709042457398GTA6全流程直播!
  4. 4CSV

    douyin-live_session-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 live_id goes in, and one JSON object comes back with fields such as title, is_live and like_count, listed as a field table and a CSV file.

What data you get

The table shows a real call for 7710380709042457398, 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
5696358598337710380709042457398GTA6全流程直播!falsehttps://live.douyin.com/569635859833https://p3-webcast-sign.douyinpic.com/webcast-cover/1ccc80989283734120840ef99ad9b8bc.jpg~tplv-qz53dukwul-common-resize:0:0.image?biz_tag=aweme_webcast&from=webcast.room.pack&l=20261121151818BE5B5186EDE8EE71C48C&lk3s=39e7556e&s=reflow_room_info&sc=webcast_cover&x-expires=179783749…查•••Afalse68406nullnullnulldouyin516344false

Use cases

  • Look back at a session that has ended

    You can still query by live_id after the session ends. is_live is false, and you read title and like_count, plus started_at when Douyin gives a start time.

  • Check the host's size

    Read author_follower_count to see how big the host is.

  • Tell paid streams apart

    is_paid says whether the session is a paid live stream.

  • Read the viewer list next

    Pass the same live_id to live_viewers to read the viewer list of this session.

Limits and gotchas

  • live_id is required. It is the all-digit session number from the live_id on rows returned by live_room or user_live. It changes each time the room goes live and is not the number in the live room link.
  • A session that has ended can still be queried; then is_live is false.
  • viewer_count is the value at the moment of the call. streams holds signed stream addresses that expire, and it is absent when the room is not live.
  • When Douyin gives no start time, the started_at key is absent.
  • is_paid is true when the session is a paid live stream.
  • One call reads one live session and returns one object.

Pricing

You pay $0.000792 per call, not per field, and one call reads one live session. 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_session",
  "params": {
    "live_id": "7710380709042457398"
  }
}'

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_session, 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 Broadcast details endpoint (douyin/live_session).

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_session, and put the parameters inside params.
- Required parameters:
  - live_id: The numeric ID of one broadcast, from the live_id of live_room or user_live rows. It changes each time the host goes live and is not the number in the live-room link. You can still look up a broadcast after it ends.
- 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": "live_session",
  "params": {
    "live_id": "7710380709042457398"
  }
}
- 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_sessionCapability identifier, fixed value.
live_idbody.paramsstringYes-The numeric ID of one broadcast, from the live_id of live_room or user_live rows. It changes each time the host goes live and is not the number in the live-room link. You can still look up a broadcast after it ends.

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": "live_session",  "results": {    "room_id": "569635859833",    "live_id": "7710380709042457398",    "title": "GTA6全流程直播!",    "is_live": false,    "url": "https://live.douyin.com/569635859833",    "cover_image_url": "https://p3-webcast-sign.douyinpic.com/webcast-cover/1ccc80989283734120840ef99ad9b8bc.jpg~tplv-qz53dukwul-common-resize:0:0.image?biz_tag=aweme_webcast&from=webcast.room.pack&l=20261121151818BE5B5186EDE8EE71C48C&lk3s=39e7556e&s=reflow_room_info&sc=webcast_cover&x-expires=179783749…",    "author_name": "查•••A",    "author_id": "•••",    "author_douyin_id": "•••",    "author_avatar_url": "https://p3.douyinpic.com/•••",    "author_is_verified": false,    "like_count": 68406,    "platform": "douyin",    "author_uid": "•••",    "author_follower_count": 516344,    "is_paid": false  },  "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 live session API return?

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

When do I use live_session and when live_room?

Use live_room when you know the room ID (room_id) and want its state right now. Use live_session when you hold the session number live_id and want that one session, including one that has ended. It also returns author_uid, author_follower_count and is_paid.

Where does live_id come from?

Take live_id from a row returned by live_room or user_live. The same room gets a new live_id each time it goes live.

How much does it cost to read a live session?

$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