Unofficial TikTok Live API — Live Status and Stream URLs
GET/api/v1/live
Check if a user is live and get the stream URLs (HLS + FLV) per quality.
| Parameter | Description | |
|---|---|---|
username | optional | TikTok username, @handle, or profile URL. (Use this OR room_id.) |
room_id | optional | TikTok live room id (e.g. from /room_id). (Use this OR username.) |
Returns
username, live_info (status LIVE/OFFLINE, room_id, title, viewers, cover_url, age_restricted, third_party), user_info, and a streams array — each with quality, hls_url, flv_url, resolution, bitrate, codec.
Example Request
https://dev.omar-thing.site/api/v1/live?username=tiktok&room_id=7649810043075971853&key=YOUR_API_KEY
Example Response
{
"data": {
"live_info": {
"age_restricted": false,
"cover_url": "https://p16-sign.../cover.jpeg",
"owner_user_id": "6700000000000000000",
"room_id": "7460000000000000000",
"status": "LIVE",
"third_party": false,
"title": "come hang out",
"viewers": 1284
},
"streams": [
{
"bitrate": 1500000,
"codec": "h264",
"flv_url": "https://pull-flv-...tiktokcdn.com/.../stream.flv",
"hls_url": "https://pull-hls-...tiktokcdn.com/.../stream.m3u8",
"quality": "ORIGIN",
"resolution": "720x1280"
},
{
"bitrate": 900000,
"codec": "h264",
"flv_url": "...",
"hls_url": "...",
"quality": "HD",
"resolution": "540x960"
},
{
"...": "more qualities (sd, ld, ao)"
}
],
"user_info": {
"avatar": "https://p16-sign.../avatar.jpeg",
"nickname": "Some User",
"sec_uid": "MS4wLjABAAAA...",
"user_id": "6700000000000000000",
"username": "someuser"
},
"username": "someuser"
},
"note": "When the user isn't live, live_info.status is OFFLINE and streams is [].",
"status": "success"
}Sends a live request using your API key above.
More Live endpoints
- Unofficial TikTok Room ID API — Get a user's live room_id by username (null if they're not live right now).
- Unofficial TikTok Last Live API — Get a user's most recent live room by username — live now OR already ended — with its stats, duration, and top_fans (top supporters by gift value).
- Unofficial TikTok Live Audience API — Top viewers currently in a live stream (the online-audience ranking, by contribution). Pass a room_id from /top_live or /live_room.
- Unofficial TikTok Live Chat API — Live chat & events of a LIVE room (comments, gifts, joins, likes). Pass a room_id (get one from /room_id by username). Poll with next_cursor to follow along.
- Unofficial TikTok Live Chat Streaming API (SSE) — LIVE chat pushed to you over one open SSE connection instead of polling. Same events as /live_chat (comments, joins, likes, gifts). Optional alternative — /live_chat polling still works. Duplicate events are removed automatically. Auto-closes after 10 min (or 15000 events), then asks you to reconnect. Each API key may hold up to 3 live streams at once (chat+gifts).
- Unofficial TikTok Live Gifts API — Gifts being sent in a LIVE room right now (sender, gift name, coins, combo). Pass a room_id (get one from /room_id by username). Poll with next_cursor.
- Unofficial TikTok Live Gifts Streaming API (SSE) — LIVE gifts pushed to you over one open SSE connection instead of polling. Same gifts as /live_gifts (sender, gift, coins, combo). Optional alternative — /live_gifts polling still works. Duplicate gifts are removed automatically. Auto-closes after 10 min (or 15000 events), then asks you to reconnect. Each API key may hold up to 3 live streams at once (chat+gifts).