Get TikTok live stream
Looks up a TikTok handle and returns live stream details when broadcasting, with profile fields for lookup context.
Operation
/v1/tiktok/profiles/{handle}/liveHeaders
API key (`sfk_...`)
Parameters
TikTok handle to look up, with or without a leading @.
min 1 chars · max 64 chars
Response fields
Endpoint-specific response payload.
Whether a TikTok profile identity could be resolved for the handle.
one of: found, not_found
When `lookupStatus` is `found`, whether the profile is `live` or `offline`. Null when the profile could not be resolved.
one of: live, offline, null
Profile identity when the lookup resolved.
Social platform for this profile.
one of: tiktok
TikTok username without the leading @.
Public display name shown on the TikTok profile.
Best available avatar image URL for the profile.
Whether TikTok marks the profile as verified.
Canonical public TikTok profile URL.
min 1 chars
TikTok numeric user id as a string (stable within TikTok).
TikTok opaque stable user identifier (for advanced integrations).
Follower count reported by TikTok when available.
≥ 0
Following count reported by TikTok when available.
≥ 0
Profile biography text when TikTok provides it.
Live broadcast details when `liveStatus` is `live`. Null when not live or when the profile could not be resolved.
TikTok live room identifier for the current broadcast.
min 1 chars
Live stream title when TikTok provides one.
Cover image URL for the live stream when available.
ISO-8601 timestamp when the live stream started, when TikTok provides a valid start time.
Approximate concurrent viewers reported by TikTok.
≥ 0
Cumulative enters reported by TikTok for this live room.
≥ 0
TikTok stream identifier when TikTok provides one.
Flattened playback variants for the live stream.
Video codec family for this variant.
one of: h264, h265
Which upstream stream bundle this variant came from (standard vs alternate encoding).
one of: primary, hevc
Stable quality key for this variant (for example origin, hd, sd).
min 1 chars
Human-readable quality label when TikTok provides one.
FLV playback URL when TikTok provides one.
HLS playback URL when TikTok provides one.
CMAF playback URL when TikTok provides one.
Video resolution string when TikTok reports it.
Target bitrate in bits per second when TikTok reports it.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found` or `not_found`; when found, `data.liveStatus` is `live` or `offline`, with profile context in `data.profile` and live stream payload in `data.live` when broadcasting.
Error codes
Video transcript
Returns transcript text for a TikTok video when one is available.
Search products
Returns product cards for a TikTok Shop catalog search. Pass a `query` string and optional `page` (1-based) and `region` code. Pagination is page-based; `data.page.hasMore` indicates whether another page can be requested.