# TikTok Gift Names by IDs API

> Returns gift names for a batch of TikTok gift identifiers. Provide a list of gift IDs to look up their corresponding gift labels.

Source: https://www.sandbase.ai/model/tiktok/web/gift-names-by-ids
API reference: https://www.sandbase.ai/model/tiktok/web/gift-names-by-ids/docs

## Facts

- Provider: TikTok
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/tiktok/web/gift-names-by-ids`
- 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/gift-names-by-ids` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `gift_ids` | array | yes |  |

## FAQ

### How do I use the TikTok Gift Names by IDs API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/web/gift-names-by-ids 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 Gift Names by IDs 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 Gift Names by IDs API accept?

Required: gift_ids (array). The Parameters table and the Playground on this page list every field.

### What does the TikTok Gift Names by IDs API return?

A JSON response returned in the same HTTP request (synchronous).

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

No. TikTok Gift Names by IDs 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 Gift Names by IDs API

Look up gift names for multiple items using `gift_ids`. The endpoint resolves names for each specified gift identifier in batches.

#### Use cases

- Map raw TikTok gift identifiers to readable gift names.
- Enrich live stream gift event logs with display labels.
- Build a local catalog of TikTok virtual gifts.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/gift-names-by-ids" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gift_ids": "<gift_ids>"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `gift_ids` | array | Yes | Gift ID list, recommend 50/call for best value ($0.025), auto-process first 50 if more than 50 |

#### Notes

- Accepts a list of identifiers via `gift_ids` and automatically processes the first 50 if more are provided.

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