Unofficial TikTok Live Gifts Streaming API (SSE)
GET/api/v1/live_gifts_stream
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).
| Parameter | Description | |
|---|---|---|
room_id | required | TikTok live room id (get one from /room_id by username). |
Returns
An text/event-stream (SSE). Events: open (limits info once), message (one gift — same shape as /live_gifts items: username, gift, diamonds, count, value, text), limit (hit the 10-min cap; reconnect), error (room offline). Connect with EventSource; no cursor needed. Plain JSON polling? use /live_gifts instead.
Example Request
https://dev.omar-thing.site/api/v1/live_gifts_stream?room_id=7649810043075971853&key=YOUR_API_KEY
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.