Unofficial TikTok API — Live Stats
GET/api/v1/live_stats
A creator's live-centre stats: live status, fans club and gifts, and the full broadcast history with per-stream likes and duration, plus a summary.
| Parameter | Description | |
|---|---|---|
username | optional | TikTok username, @handle, or profile URL. (Use this OR user_id.) |
user_id | optional | The numeric TikTok user id (from /profile → data.user.id). (Use this OR username.) |
history_limit | optional | Return only the N most recent broadcasts. Defaults to all. |
Returns
username, user_id, anchor (nickname, bio, avatar_url), is_live, room_id, fans_club (count, level), gifts (total, lighted, sponsored), summary (broadcasts, total_likes, total_minutes, average_likes, best), and history — each entry with room_id, title, started_at, ended_at, duration_minutes, likes.
Example Request
https://dev.omar-thing.site/api/v1/live_stats?username=tiktok&user_id=107955&history_limit=20&key=YOUR_API_KEY
Example Response
{
"data": {
"anchor": {
"avatar_url": "https://p16-common-sign.tiktokcdn.com/.../avatar.webp",
"bio": "live every evening",
"nickname": "Some Creator"
},
"fans_club": {
"count": 4200,
"level": 12
},
"gifts": {
"lighted": 3,
"sponsored": false,
"total": 38
},
"history": [
{
"duration_minutes": 220,
"ended_at": 1790286078,
"likes": 131000,
"room_id": "7460000000000000000",
"started_at": 1790272844,
"title": "come hang out"
},
{
"duration_minutes": 225,
"ended_at": 1787029918,
"likes": 310000,
"room_id": "7460000000000000001",
"started_at": 1787016414,
"title": "big night"
},
{
"...": "older broadcasts",
"room_id": "...",
"title": "..."
}
],
"is_live": true,
"room_id": "7460000000000000000",
"summary": {
"average_likes": 45000,
"best": {
"duration_minutes": 225,
"ended_at": 1787029918,
"likes": 310000,
"room_id": "7460000000000000001",
"started_at": 1787016414,
"title": "big night"
},
"broadcasts": 120,
"total_likes": 5400000,
"total_minutes": 18600
},
"user_id": "6700000000000000000",
"username": "someuser"
},
"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 Live API — Check if a user is live and get the stream URLs (HLS + FLV) per quality.
- 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).