# TikTok Creator Search Insights API

> Get TikTok Creator Search Insights: trending search queries with popularity scores, trend history and video counts, including content-gap topics, by category and language.

Source: https://www.sandbase.ai/apis/tiktok/app-v3/creator-search-insights
API reference: https://www.sandbase.ai/apis/tiktok/app-v3/creator-search-insights/docs

## Facts

- Provider: TikTok
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/tiktok/app-v3/creator-search-insights`
- Price: $0.0015 per call
- Free allowance: 100 calls per organization per UTC day, shared across eligible APIs
- 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/app-v3/creator-search-insights` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `category_filters` | string | no |  |
| `creator_source` | string | no |  |
| `force_refresh` | boolean | no |  |
| `language_filters` | string | no |  |
| `limit` | integer | no |  |
| `offset` | integer | no |  |
| `tab` | string | no |  |

## FAQ

### How do I use the TikTok Creator Search Insights API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/app-v3/creator-search-insights 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 Creator Search Insights API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

### What parameters does the TikTok Creator Search Insights API accept?

No parameters are required. Optional: category_filters (string), creator_source (string), force_refresh (boolean), language_filters (string), limit (integer) and offset (integer) and 1 more. The Parameters table and the Playground on this page list every field.

### What does the TikTok Creator Search Insights 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 Creator Search Insights 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 Creator Search Insights API

Fetch the search topics TikTok shows creators in Creator Search Insights. Each query includes a popularity score, a recent trend series and how many videos already cover it.

#### Use cases

- Find trending search topics to create content for.
- Spot content gaps with high demand and few videos (`tab=content_gap`).
- Track topic popularity by category and language.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/creator-search-insights" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `tab` | string | No | Tab type (all/content_gap/follower_searched/life_style/topics/challenges/sounds/hashtags) |
| `limit` | integer | No | Number per page, default 20 |
| `offset` | integer | No | Pagination offset, default 0 |
| `force_refresh` | boolean | No | Force refresh, default False |
| `creator_source` | string | No | Creator source, default "general_search" |
| `category_filters` | string | No | Category filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports |
| `language_filters` | string | No | Language filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko |

#### Example response

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

```json
{
  "has_more": true,
  "cursor": 20,
  "inspiration_list": [
    {
      "query_text": "new account on tiktok",
      "query_id_str": "7449584484497752069",
      "popularity": 72,
      "popularity_v2": 202860,
      "video_num": 123206,
      "trending_seq": [
        80,
        80,
        79,
        75,
        74,
        80,
        72
      ],
      "inspiration_types": [
        "search"
      ]
    }
  ]
}
```

#### Notes

- `tab`: all, content_gap, follower_searched, life_style, topics, challenges, sounds or hashtags.
- Filter with `category_filters` (e.g. Gaming, Fashion) and `language_filters` (e.g. en, es).

#### Related APIs

- [TikTok LIVE Status](/model/tiktok/app-v3/check-live-room-online): Check if live room is online The Room ID of the live room can be obtained from the `/api/v1/tiktok/web/get_live_room_id` interface through the live room link.
- [Batch check if live rooms are online](/model/tiktok/app-v3/check-live-room-online-batch): Batch check TikTok live rooms' online status, supports up to 50 room IDs Room IDs can be retrieved from `/api/v1/tiktok/web/get_live_room_id`.
- [Get content translation data](/model/tiktok/app-v3/content-translate): Get content translation data.