TikTok LIVE Status Scraper

Check whether TikTok accounts are broadcasting right now. Give it usernames; each row tells you if they are live, and if so the room ID, title and start time.

Built for polling -- run it on a schedule against a watchlist and act on the is_live flag.

Input

Field	Use it for
username	Usernames or profile URLs, one per line. Required.
room_id	An escape hatch. Only useful if you already hold a room ID from somewhere else.

{
  "username": [
    "khaby.lame",
    "https://www.tiktok.com/@tiktok"
  ]
}

Why you give it a username, not a room ID

A TikTok LIVE room ID appears in no public URL. A /@user/live page does not carry one. So an Actor that demanded a room ID up front had no usable starting point for anybody who did not already have an ID -- which was almost everybody.

Usernames are the front door. The room ID comes back in the output, as room_id, ready for anything downstream that needs it.

Output

One row per account you asked about, live or not.

Field	Contents
username, user_id, sec_user_id	Identifiers
nickname, avatar_url, is_verified	Display name, picture, verification
is_live	true only if the account is broadcasting right now
room_id	The account's LIVE room ID
live_title	Broadcast title, when one is running
live_started_at	Broadcast start time, when one is running
live_room	The full room record, when broadcasting
stats	Account stats, when reported

{
  "username": "khaby.lame",
  "user_id": "6912129165957842438",
  "nickname": "Khabane lame",
  "is_verified": true,
  "is_live": true,
  "room_id": "7530891234567890123",
  "live_title": "Q&A before the weekend",
  "live_started_at": 1722351600
}

Questions

room_id is filled in but is_live is false. Which do I trust? is_live. A room ID sticks to an account between broadcasts, so its presence proves the account has a LIVE room, not that anything is happening in it. is_live is only true when TikTok reports the live-now status and returns an actual room record. Never infer "live" from a non-empty room_id.

One username in my list is wrong. Does the run fail? No. Each account is checked on its own and a failure is logged as a warning before the run moves on. A watchlist with one dead handle still returns every other row.

Do I get a row for accounts that are offline? Yes -- with is_live: false and the live fields left empty. That is what makes it usable on a schedule: every run produces the same rows and you diff the flag.

Can I get viewer counts or the chat? No. This is a status snapshot, not a live stream reader. What you get is whether they are on, since when, and under what title.

How often can I poll it? As often as your schedule allows -- there is no state carried between runs. Each run is an independent check.

Related Actors

Actor	Purpose
Bulk TikTok Profile Scraper	Full profile detail for the accounts on your watchlist
TikTok Profile Videos Scraper	What they post when they are not live