TikTok API

TikTok Live API

Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle.

POST/v1/run/tiktok.live
Requests
-
30d

Provider network

Providers ranked by traffic

Try it

Make your first request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "coverUrl": "https://example.com/page",
    "displayName": "Alex Rivera",
    "enterCount": 12500,
    "handle": "alex_rivera",
    "roomId": "a1b2c3d4",
    "startTime": 42,
    "status": 42,
    "title": "Example title",
    "viewers": 12500
  },
  "found": true
}
Response interface
interface TiktokLiveResponse {
  data: {
    coverUrl: string;
    displayName: string;
    enterCount: number;
    handle: string;
    roomId: string;
    startTime: number;
    status: number;
    title: string;
    viewers: number;
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-16 · uptime and latency measured over 30d
POST /v1/run/tiktok.live
curl -X POST https://api.getanyapi.com/v1/run/tiktok.live \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"thejustalex"}'
FieldTypeExample value
Request body
handlestring"thejustalex"TikTok username without the leading @ (e.g. "thejustalex").
Response
dataobject
data.coverUrlstringPopulated whenever the provider has data for the entity.
data.displayNamestringPopulated whenever the provider has data for the entity.
data.enterCountinteger
data.handlestringPopulated whenever the provider has data for the entity.
data.roomIdstringPopulated whenever the provider has data for the entity.
data.startTimeinteger
data.statusinteger
data.titlestringPopulated whenever the provider has data for the entity.
data.viewersinteger
foundboolean
Price
Price per requestUSD$0.0012
Price /1k reqUSD$1.20

FAQ

About the TikTok Live API

The AnyAPI TikTok Live API returns TikTok live data as normalized JSON from one POST call to /v1/run/tiktok.live. Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum.

It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.