TikTok Room Gift List API

Retrieve the catalog of virtual gifts for TikTok broadcasts by providing an optional room_id. This endpoint returns gift details such as gift names, IDs, duration, and diamond counts.

Use cases

• Display available broadcast gifts and their diamond values within an analytics dashboard.
• Monitor available gift types and configurations across different broadcast rooms.
• Map gift identifiers and names to incoming broadcast event notifications.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/live-gift-list" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "data": {
    "gifts": [
      {
        "describe": "sent Lyric Mail",
        "diamond_count": 15,
        "duration": 1000,
        "expiration_timestamp": 0,
        "for_linkmic": true,
        "gift_label_type": 0,
        "gift_sub_type": 0,
        "id": 1329117,
        "name": "Lyric Mail",
        "primary_effect_id": 0,
        "image": {
          "image_type": 0
        },
        "lock_info": {
          "highlight_enabled": false,
          "lock_type": 0
        }
      }
    ]
  }
}

Notes

• The room_id parameter is optional when requesting the gift catalog.

Related APIs

• TikTok Video IDs from URLs (Batch): Resolves and extracts TikTok video IDs from a list of video URLs.
• TikTok User Sec User ID Extractor: Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
• TikTok Profile Unique IDs: Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.