Social Fetch
Get API key
TikTok hub

TikTok live stream API

Check whether a TikTok handle is broadcasting right now, and pull room title, viewers, and playback variants when they are live.

GET /v1/tiktok/profiles/{handle}/live

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Alerting jobs, creator dashboards, and clip pipelines often need a yes/no on whether someone is live before they spend credits on transcripts, comments, or video lists. You already have the handle; you want `live` or `offline` plus room metadata when a broadcast is up. Hitting TikTok's live surfaces yourself means chasing room payloads and stream CDN URLs that change shape often.

`GET /v1/tiktok/profiles/{handle}/live` takes a TikTok handle (with or without a leading `@`) and returns `data.lookupStatus`, `data.liveStatus`, a compact `data.profile`, and `data.live` when the account is broadcasting. On `liveStatus: "live"`, `data.live` includes `roomId`, `title`, `coverUrl`, `startedAt`, `viewerCount`, `enterCount`, optional `streamId`, and a `streams` array of playback variants (`codecFamily`, `source`, `qualityKey`, optional `flvUrl` / `hlsUrl` / `cmafUrl`, resolution, bitrate). On `offline`, `live` is null. On `lookupStatus: "not_found"`, `liveStatus`, `profile`, and `live` are null.

This route is a live-status check for one handle, not a profile card refresh and not a video list. Full identity and aggregate metrics live on `GET /v1/tiktok/profiles/{handle}`. Recent uploads are `GET /v1/tiktok/profiles/{handle}/videos`. Pricing is on the credit badge for this operation; bill from `meta.creditsCharged` on every response.

TikTok live stream API FAQ

How do I check if a TikTok creator is live via API?

Call `GET /v1/tiktok/profiles/{handle}/live` with your Social Fetch API key (`x-api-key`). Pass the TikTok username as the path parameter, with or without a leading `@`. Read `data.lookupStatus`, then `data.liveStatus` and `data.live` when the profile resolved.

How much does the TikTok live stream API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What does the TikTok live stream API return?

`data.lookupStatus` (`found` or `not_found`), `data.liveStatus` (`live`, `offline`, or null when the handle did not resolve), a compact `data.profile` when found, and `data.live` with room metadata and stream variants when `liveStatus` is `live`. The envelope also includes `meta.requestId` and `meta.creditsCharged`.

What is in data.live when the creator is broadcasting?

`roomId`, `title`, `coverUrl`, `startedAt`, `viewerCount`, `enterCount`, optional `streamId`, and `streams` (each variant can include `codecFamily`, `source`, `qualityKey`, optional FLV/HLS/CMAF URLs, resolution, and bitrate). When `liveStatus` is `offline` or the lookup failed, `data.live` is null.

What happens if the TikTok handle does not exist?

`data.lookupStatus` is `not_found`. `liveStatus`, `profile`, and `live` are null. Always branch on `lookupStatus` before treating a null `liveStatus` as offline.

Do I need TikTok OAuth to check live status?

No. You authenticate to Social Fetch with an API key. The route reads public live-status data for the handle; it does not act on behalf of a logged-in TikTok user.

How is this different from the TikTok profile API?

This route answers whether the handle is live right now and returns room/stream fields when it is. `GET /v1/tiktok/profiles/{handle}` returns the identity card and aggregate metrics (followers, likes, posts) without live room state. Use the profile route to seed a creator row; poll this live route for broadcast alerts.

Other TikTok endpoints