Social Fetch
Start for freeStart free
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 Failed requests are free

Try in playgroundFull API docs

About this endpoint

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. Bill from meta.creditsCharged.

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