Unofficial TikTok Live Gifts API — Gift Events

Your API key — used by the Try-it console below, stored only in this browser.

GET/api/v1/live_gifts

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.

Parameter		Description
`room_id`	required	TikTok live room id (get one from /room_id by username).
`cursor`	optional	Omit (or 0) for the latest batch; pass the previous response's `next_cursor` for newer gifts. Poll every ~1-2s.

Returns

room_id, next_cursor, count, and a gifts array. Each gift has username, nickname, user_id, gift (name), gift_id, diamonds (coin cost each), count (combo), value (diamonds×count), and text (a ready 'X gifted the host N Gift' line).

Example Request

https://dev.omar-thing.site/api/v1/live_gifts?room_id=7649810043075971853&cursor=0&key=YOUR_API_KEY

Example Response

{
  "data": {
    "count": 2,
    "gifts": [
      {
        "count": 1,
        "diamonds": 6,
        "gift": "Divine Fingers",
        "gift_id": 118812,
        "nickname": "MA",
        "text": "MA: gifted the host 1 Divine Fingers",
        "user_id": "70...",
        "username": "ma_qahtaney",
        "value": 6
      },
      {
        "count": 7,
        "diamonds": 1,
        "gift": "Rose",
        "gift_id": 5655,
        "nickname": "♡",
        "text": "♡: gifted the host 7 Rose",
        "user_id": "70...",
        "username": "woow_84",
        "value": 7
      }
    ],
    "next_cursor": "1781120933723_7649856157456119073_1_1_...",
    "room_id": "7649810043075971853"
  },
  "status": "success"
}

room_id required

cursor optional

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 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).