# TikTok Room Gift List API

> Returns the catalog of gifts available in a TikTok broadcast, including gift identifiers, names, and diamond values. Accepts an optional room identifier to retrieve room-specific options.

Source: https://www.sandbase.ai/model/tiktok/web/live-gift-list
API reference: https://www.sandbase.ai/model/tiktok/web/live-gift-list/docs

## Facts

- Provider: TikTok
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/tiktok/web/live-gift-list`
- Price: $0.04 per call
- Capabilities: api, tiktok
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/tiktok/web/live-gift-list` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `room_id` | string | no |  |

## FAQ

### How do I use the TikTok Room Gift List API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/web/live-gift-list with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the TikTok Room Gift List API cost?

$0.04 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the TikTok Room Gift List API accept?

No parameters are required. Optional: room_id (string). The Parameters table and the Playground on this page list every field.

### What does the TikTok Room Gift List API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

### Do I need a TikTok developer account or API key?

No. TikTok Room Gift List runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.

## README

### 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

```bash
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

| Name | Type | Required | Description |
|---|---|---|---|
| `room_id` | string | No | Live room ID (optional) |

#### Example response

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

```json
{
  "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)](/model/tiktok/web/all-aweme-id): Resolves and extracts TikTok video IDs from a list of video URLs.
- [TikTok User Sec User ID Extractor](/model/tiktok/web/all-sec-user-id): Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
- [TikTok Profile Unique IDs](/model/tiktok/web/all-unique-id): Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.