Get TikTok live info
Get current room details and engagement counts for a TikTok live broadcast.
Headers
Get your API keyAPI key (`sfk_...`)
TikTok live room id, available from the profile live lookup when the creator is broadcasting.
min 1 chars · pattern: ^\d+$
TikTok numeric user id for the live owner, available from the profile live lookup.
min 1 chars · pattern: ^\d+$
Endpoint-specific response payload.
Whether the requested live room was found.
one of: found, not_found
Live room details when found; null when the room was not found.
TikTok live room identifier.
min 1 chars
Like count reported for the live room.
≥ 0
Current viewer count reported for the live room.
≥ 0
Live room status reported by TikTok.
min 1 chars
Live stream title when available.
Cover image URL for the live stream.
Owner of the live room.
TikTok numeric user id for the live owner.
min 1 chars
TikTok username of the live owner, without the leading @.
min 1 chars
Public display name shown on the TikTok profile.
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/tiktok/live?roomId=123&userId=6659752019493208069" \
-H "x-api-key: YOUR_API_KEY"Responses
TikTok live room info.