TikTokPOST /v1/tiktok/live

TikTok Live Status Scraper API

Whether a TikTok account is live right now, with the live room ID, title, start time, current and total viewers and cover image while it is live.

Cost
1 credit
Blocks and errors
Refunded
Cache hits
Free
Response fields
15
Limits
Live status and room stats, no chatAll limits

Updated · Maintained by the Scrape Everything team

What the TikTok Live Status Scraper API does

The TikTok Live API checks whether a TikTok account is broadcasting right now. Send a username, an @handle or a profile URL and you get is_live, the account's user ID, secUid, nickname, verified badge, avatar and the link to its live page. While the account is live, the response adds the live room ID, the stream title, the start time in ISO 8601, current viewers, the total number of people who have joined, a subscriber-only flag and the cover image; when it is offline, those room fields are null. If TikTok does not return a live status, the call fails and is refunded rather than reporting the account as offline. The stream video, chat and gifts are not returned. Each check costs 1 credit, live or not.

What you get

Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.

FieldTypeDescription
usernamestringTikTok username
user_idstring | nullTikTok numeric user ID
sec_uidstring | nullTikTok secUid
nicknamestringDisplay name; empty string if none
is_verifiedbooleanHas the verified badge
avatar_urlstring | nullProfile picture URL
is_livebooleanThe account is live right now
room_idstring | nullLive room ID; null when not live
titlestring | nullLive title; null when not live or untitled
started_atstring | nullLive start time, ISO 8601; null when not live
viewer_countinteger | nullCurrent viewers; null when not live
total_viewersinteger | nullEveryone who has joined this live; null when not live
subscriber_onlyboolean | nullSubscriber-only live; null when not live
cover_urlstring | nullLive cover image URL; null when not live
live_urlstringLive page URL

Request example

Send the API key as a Bearer token. The body is a small JSON object.

curl -X POST https://api.scrapeeverything.com/v1/tiktok/live \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'
ParameterRequiredDescription
usernameYesTikTok username, @handle or profile URL.

Response example

A real response from the live API, captured on November 12, 2026 for the request above. Lists are cut to two items and long links and texts are shortened.

200 OK
{
  "success": true,
  "data": {
    "username": "khaby.lame",
    "user_id": "127905465618821121",
    "sec_uid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
    "nickname": "Khabane lame",
    "is_verified": true,
    "avatar_url": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tikt…",
    "is_live": false,
    "room_id": null,
    "title": null,
    "started_at": null,
    "viewer_count": null,
    "total_viewers": null,
    "subscriber_only": null,
    "cover_url": null,
    "live_url": "https://www.tiktok.com/@khaby.lame/live"
  },
  "meta": {
    "request_id": "req_zuxHT5cLuiwfZYqz7s3e",
    "scraper": "tiktok.live",
    "cached": false,
    "cached_at": null,
    "cache_age_seconds": null,
    "credits_charged": 1,
    "credits_remaining": 99,
    "duration_ms": 758
  }
}

Empty in this capture: room_id, title, started_at, viewer_count, total_viewers, subscriber_only, cover_url. A null field means the value was not available for this request.

Try it with your own input: open this endpoint in the playground with your 100 free credits. Errors use the same envelope with success: false and a documented code; which of them are billed is answered below.

How much does the TikTok Live Status Scraper API cost?

Each request costs 1 credit, so 1,000 requests use 1,000 credits. You are charged only when a request returns data or a definitive answer. Credits come in one-time packs that never expire; the cards below show what 1,000 requests cost with each pack. New accounts get 100 free credits.

  • Builder pack

    $0.80

    25,000 credits for $19.99

  • Growth pack

    $0.60

    500,000 credits for $299.00

  • Scale pack

    $0.50

    1,200,000 credits for $599.00

See pricing for all packs and rate limits.

Which requests are billed and which are refunded?

A request is billed (1 credit) when it returns data or a definitive answer. A 404 with a code such as NOT_FOUND or PRIVATE_ACCOUNT means the target is missing or not public, so drop it from your list instead of retrying. Blocks, timeouts and errors on our side are refunded automatically, and invalid requests are never charged.

  • Billing: 1 credit per completed check, whether is_live is true or false. A username that does not exist is a billed 404 NOT_FOUND. When TikTok returns no live status, the call fails and is refunded, so is_live: false is always TikTok's answer, never a guess.
  • room_id, title, started_at, viewer_count, total_viewers, subscriber_only and cover_url are null when is_live is false. title can also be null during an untitled live.
  • Caching: do not send cache_days for live checks. A cached answer can be up to that many days old; without it, every check asks TikTok at that moment.

Every billed and refunded case is listed under credits and billing and errors.

Use cases

  • Alert your team or community when a creator goes live by checking a list of accounts on a schedule.
  • Log start times and viewer counts sampled during the streams of creators you sponsor, for campaign reports.
  • Find out which creators on a shortlist go live regularly before you plan a live collaboration.

What are the limits of the TikTok Live Status Scraper API?

Each request looks up one target, given as username. New accounts can send 60 requests a minute, rising to 300 a minute once your purchases total $19.99 or more. Every endpoint returns public data only, never private or login-only content; the limitations and notes below list what this one leaves out.

Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only. The videos endpoint returns the newest publicly visible videos (up to 12); private, removed or region-restricted videos are missing; TikTok hides some comments and replies; live checks describe the live room, not the stream itself.

  • A completed check costs 1 credit whether or not the account is live. Room fields are null when is_live is false.
  • A missing account returns 404. If TikTok does not return the live status, the call fails and the credits are refunded: an offline answer is never guessed.

Need more than that? Rate limits explains the per-minute and concurrency limits, or contact us for higher limits.

Questions

How do I get notified when someone goes live?

Call the endpoint on a schedule and act when is_live turns true. Each check costs 1 credit, so checking one account every 5 minutes uses 288 credits a day. Leave cache_days out, or you may get a stored answer.

What is the difference between viewer_count and total_viewers?

viewer_count is how many people are watching at the moment of the check. total_viewers counts everyone who has joined this live so far, including people who already left.

Can I get the stream itself or its chat?

No. The response describes the live room (ID, title, start time, viewers, cover) but has no stream URL, chat messages or gifts.

Can I re-read a result without paying again?

Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.

Use the TikTok Live Status Scraper API without code

Open this endpoint in the dashboard playground, switch to Multi and paste up to 500 username values, one per line. Each line runs as one request (1 credit) and the results download as CSV or JSON. In n8n, Make, Zapier or Google Sheets, send the same request from a workflow or a sheet.

TikTok guides and API reference

More TikTok endpoints

Start with 100 free credits.

Continue with Google, create an API key and send your first request in under a minute.

Get 100 free credits