TikTok Creator Search Insights

API docs
https://api.sandbase.ai/v1/api/tiktok/app-v3/creator-search-insights

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

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
0 required · 7 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Category filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports
Creator source, default "general_search"
Force refresh, default False
Language filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko
Number per page, default 20
Pagination offset, default 0
Tab type (all/content_gap/follower_searched/life_style/topics/challenges/sounds/hashtags)
OutputExample
Responseoutputs · 14.7 KB · 399 lines
[
  {
    "data": {
      "banners": {
        "conversion_bar_list": [
          {
            "item_link": "https://activity.tiktokw.us/magic/eco/runtime/release/66581e19df4daf02866b5cc9?appType=muse&magic_page_no=1&lang=en&region=Default&use_spark=1",
            "item_text": "Learn more"
          }
        ],
        "event_banners": {
          "ecommerce_education": {
            "eligible": {
              "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/6cjd5rh91716193010532",
              "link": "https://activity.tiktokw.us/magic/eco/runtime/release/664c4298f65e08d77319049b?appType=muse&magic_page_no=1&lang=en-US&region=US&use_spark=1 ",
              "text": "Promote products people want to buy. Start earning now!"
            },
            "enrolled": {
              "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/b0fmjabl1716192964040",
              "link": "https://activity.tiktokw.us/magic/eco/runtime/release/6645db2e6f3a610291d0b0ac?appType=muse&magic_page_no=1&lang=en-US&region=US&use_spark=1",
              "text": "Create shoppable videos with products people want to buy!"
            },
            "non_eligible": {
              "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/hdskk6yq1716193026366",
              "link": "https://activity.tiktokw.us/magic/eco/runtime/release/664c4c03f33586028244e7fb?appType=muse&magic_page_no=1&lang=en-US&region=US&use_spark=1",
              "text": "Explore opportunities to earn with shopping insights"
            }
          }
        },
        "home_page_banner": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/q8hl7ump1713411026852",
        "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/r8z2ni6s1708410808360",
        "image_url_dark": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/a1av24511708410895413",
        "loading_page_banner": "https://p16-search-fe-static.tiktokcdn-us.com/tos-alisg-i-baf7wf9fmw-sg/e06d4221d05a4859be4def9f58c37540~tplv-baf7wf9fmw-image.image"
      },
      "cost_tracker": {
        "es_cost": 23,
        "model_cost": 168,
        "post_process_cost": 24,
        "recall_cost": 96,
        "recommend_reason_cost": 3,
        "rough_sort_cost": 1,
        "total_cost": 308
      },
      "cursor": 10,
      "extra": {
        "cold_start": true,
        "latency": 308,
        "logid": "20260815021659BB17A4C704827E39312B",
        "now": 1786760220340,
        "vgeo": "VGeo-US"
      },
      "has_follower_searched": false,
      "has_more": true,
      "inspiration_list": [
        {
          "business_types": [
            "basic",
            "experience",
            "content_gap",
            "… 5 more items in the full response"
          ],
          "cover_image": "",
          "debug_info": {
            "creator_category": [
              {
                "reason": "byFollowerCnt",
                "type": "new_creator"
              },
              {
                "type": "csi_new_user"
              }
            ],
            "creator_lang": {
              "infer_languages": [
                "en"
              ],
              "use_mul_lang": false
            },
            "experiment": {
              "csi_analytics_filtered_query_token_ids": "exp_group_strict",
              "csi_csi_dynamic_tab": "csi_dynamic_tab_v4",
              "csi_csi_exp_base_trending": "csi_exp_base_trending",
              "csi_csi_info_exp_recall_v2": "csi_info_exp_recall_v2",
              "csi_csi_useful_exp_gen": "csi_useful_eu_ttp_exp_gen_v1"
            },
            "language": "en",
            "recall_scores": [
              0,
              0
            ],
            "recall_source": [
              "FromRegionHotQueryMulLang",
              "FromLangHotQuery"
            ],
            "recall_source_position": {
              "FromLangHotQuery": 88,
              "FromRegionHotQueryMulLang": 76
            },
            "rough_score": 0,
            "score": 0.22210450172424315,
            "target_score": {
              "all_boost": 1.100000023841858,
              "before_boost": 0.16826099157333374,
              "csi_relevance_roughsort__base": 0.1,
              "dssm_roughsort__base": 0.1,
              "keyword_reward_model__total": 0,
              "laplace_csi_qwen3_emb_6b_vllm__base": 0.1,
              "multitasks_click_score": 0.41241759061813354,
              "multitasks_collection_score": 0.01129099726676941,
              "multitasks_info_collection_score": 0.0038296282291412354,
              "multitasks_info_shoot_score": 0.30161842703819275,
              "multitasks_shoot_score": 0.20201215147972107,
              "multitasks_strict_publish_score": 0.2062912285327911,
              "rank_relevance_score": 0.5170366168022156,
              "recall_relevance_score": 0.5120057463645935,
              "video_quality_publish_score": 0.005695223808288574,
              "video_quality_strict_search_vv_score": 0.12316220253705978
            }
          },
          "dislike_option_enabled": true,
          "entity_id": 0,
          "favorited_updated_at": 0,
          "inspiration_types": [
            "search"
          ],
          "is_favorited": false,
          "order_popularity_seq": [],
          "popularity": 87,
          "popularity_updated_at": 1786756428,
          "popularity_v2": 4741221,
          "query_id": 7449584484497752000,
          "query_id_str": "7449584484497752069",
          "query_labels": [],
          "query_text": "new account on tiktok",
          "rewrite_version": "",
          "show_ai_canvas_entry": false,
          "sug_id_str": "3689601110723670296",
          "textnet": {
            "layer1": "Science and Technology",
            "layer2": "Software",
            "layer3": "Apps/Computer Software",
            "layer4": "Apps/Computer Software Function Tutorials"
          },
          "trending_seq": [
            45,
            70,
            74,
            "… 4 more items in the full response"
          ],
          "trending_seq_v2": [
            9802,
            108332,
            295888,
            "… 4 more items in the full response"
          ],
          "use_csi_api_for_related_videos": false,
          "user_avatars": [],
          "video_num": 78782
        },
        {
          "business_types": [
            "basic",
            "local service old",
            "experience",
            "… 7 more items in the full response"
          ],
          "cover_image": "",
          "debug_info": {
            "creator_category": [
              {
                "reason": "byFollowerCnt",
                "type": "new_creator"
              },
              {
                "type": "csi_new_user"
              }
            ],
            "creator_lang": {
              "infer_languages": [
                "en"
              ],
              "use_mul_lang": false
            },
            "experiment": {
              "csi_analytics_filtered_query_token_ids": "exp_group_strict",
              "csi_csi_dynamic_tab": "csi_dynamic_tab_v4",
              "csi_csi_exp_base_trending": "csi_exp_base_trending",
              "csi_csi_info_exp_recall_v2": "csi_info_exp_recall_v2",
              "csi_csi_useful_exp_gen": "csi_useful_eu_ttp_exp_gen_v1"
            },
            "language": "en",
            "recall_scores": [
              0.17337918281555176,
              0.17337918281555176,
              0.17337918281555176,
              "… 2 more items in the full response"
            ],
            "recall_source": [
              "FromMidLongTailDssmViking",
              "FromDssmVikingL1",
              "FromDssmViking",
              "… 2 more items in the full response"
            ],
            "recall_source_position": {
              "FromDssmViking": 0,
              "FromDssmVikingL1": 0,
              "FromLangHotQuery": 8,
              "FromMidLongTailDssmViking": 0,
              "FromRegionHotQueryMulLang": 96
            },
            "rough_score": 0,
            "score": 0.20432190299034117,
            "target_score": {
              "all_boost": 1.100000023841858,
              "before_boost": 0.15478931367397308,
              "csi_relevance_roughsort__base": 0.1,
              "dssm_roughsort__base": 0.1,
              "keyword_reward_model__total": 0,
              "laplace_csi_qwen3_emb_6b_vllm__base": 0.1,
              "multitasks_click_score": 0.38035041093826294,
              "multitasks_collection_score": 0.01493045687675476,
              "multitasks_info_collection_score": 0.0023025572299957275,
              "multitasks_info_shoot_score": 0.2720780372619629,
              "multitasks_shoot_score": 0.22638365626335144,
              "multitasks_strict_publish_score": 0.21026527881622312,
              "rank_relevance_score": 0.24868610501289368,
              "recall_relevance_score": 0.4820883572101593,
              "video_quality_publish_score": 0.042238205671310425,
              "video_quality_strict_search_vv_score": 0.1759287416934967
            }
          },
          "dislike_option_enabled": true,
          "entity_id": 0,
          "favorited_updated_at": 0,
          "inspiration_types": [
            "search"
          ],
          "is_favorited": false,
          "order_popularity_seq": [],
          "popularity": 87,
          "popularity_updated_at": 1786756143,
          "popularity_v2": 5771167,
          "query_id": 7509091202382168000,
          "query_id_str": "7509091202382168120",
          "query_labels": [],
          "query_text": "creators sight insights",
          "rec_reason": {
            "rec_reason_code": "BeginnerFriendly",
            "rec_reason_detail_show_text": "A perfect topic for your first post. Try it out now!",
            "rec_reason_short_show_text": "Great for a first post"
          },
          "rewrite_version": "",
          "show_ai_canvas_entry": false,
          "sug_id_str": "3990856894084740922",
          "textnet": {
            "layer1": "TikTok's Featured Content",
            "layer2": "Others TikTok and Video Contents",
            "layer3": "",
            "layer4": ""
          },
          "trending_seq": [
            90,
            89,
            89,
            "… 4 more items in the full response"
          ],
          "trending_seq_v2": [
            16569726,
            8924921,
            9322701,
            "… 4 more items in the full response"
          ],
          "use_csi_api_for_related_videos": false,
          "user_avatars": [],
          "video_num": 30685912
        },
        {
          "business_types": [
            "basic",
            "hot_event_v2",
            "generic_query"
          ],
          "cover_image": "",
          "debug_info": {
            "creator_category": [
              {
                "reason": "byFollowerCnt",
                "type": "new_creator"
              },
              {
                "type": "csi_new_user"
              }
            ],
            "creator_lang": {
              "infer_languages": [
                "en"
              ],
              "use_mul_lang": false
            },
            "experiment": {

Examples

Select an example to load its inputs and result into the playground.

API README

TikTok Creator Search Insights API

Returns the search topics TikTok shows creators in Creator Search Insights. Each topic has a popularity score, a short trend series and a video count. All inputs are optional; schema defaults select the all tab, offset 0 and English preference. This does not guarantee every returned phrase is English or prove a new empty-request execution.

Use cases

  • Find trending search topics to build new videos around.
  • Filter with tab=content_gap to find topics that carry the content_gap label.
  • Inspect returned textnet category layers without inferring which areas are growing from one snapshot.
  • Preserve reported trend arrays; their per-point time basis and a reliable repeated-call comparison are not established here.

Request

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 '{}'

The result is returned in outputs[0].data.

Parameters

NameTypeRequiredDescription
category_filtersstringNoCategory filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports
creator_sourcestringNoCreator source, default "general_search"
force_refreshbooleanNoForce refresh, default False
language_filtersstringNoLanguage filters, separated by comma, options: id, de, en, es, fr, pt, vi, tr, ar, th, ja, ko
limitintegerNoNumber per page, default 20
offsetintegerNoPagination offset, default 0
tabstringNoTab type (all/content_gap/follower_searched/life_style/topics/challenges/sounds/hashtags)

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "banners": {
    "conversion_bar_list": [
      {
        "item_link": "https://activity.tiktokw.us/magic/eco/runtime/release/66581e19df4daf02866b5cc9?a…",
        "item_text": "Learn more"
      }
    ],
    "event_banners": {
      "ecommerce_education": {
        "eligible": {
          "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/6cjd5rh917161…",
          "link": "https://activity.tiktokw.us/magic/eco/runtime/release/664c4298f65e08d77319049b?a…",
          "text": "Promote products people want to buy. Start earning now!"
        },
        "enrolled": {
          "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/b0fmjabl17161…",
          "link": "https://activity.tiktokw.us/magic/eco/runtime/release/6645db2e6f3a610291d0b0ac?a…",
          "text": "Create shoppable videos with products people want to buy!"
        },
        "non_eligible": {
          "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/hdskk6yq17161…",
          "link": "https://activity.tiktokw.us/magic/eco/runtime/release/664c4c03f33586028244e7fb?a…",
          "text": "Explore opportunities to earn with shopping insights"
        }
      }
    },
    "home_page_banner": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/q8hl7ump17134…",
    "image_url": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/r8z2ni6s17084…",
    "image_url_dark": "https://sf16-muse-va.ibytedtos.com/obj/search-static-maliva/maliva/a1av245117084…",
    "loading_page_banner": "https://p16-search-fe-static.tiktokcdn-us.com/tos-alisg-i-baf7wf9fmw-sg/e06d4221…"
  },
  "cost_tracker": {
    "es_cost": 23,
    "model_cost": 124,
    "post_process_cost": 36,
    "recall_cost": 83,
    "recommend_reason_cost": 4,
    "rough_sort_cost": 2,
    "total_cost": 272
  },
  "cursor": 20,
  "extra": {
    "cold_start": true,
    "latency": 273,
    "logid": "20261103074352704495AFB5FFFB018670",
    "now": 1793691832985,
    "vgeo": "VGeo-US"
  },
  "has_follower_searched": false,
  "has_more": true,
  "inspiration_list": [
    {
      "business_types": [
        "basic"
      ],
      "cover_image": "",
      "debug_info": {
        "creator_category": [
          {
            "reason": "byFollowerCnt",
            "type": "new_creator"
          }
        ],
        "creator_lang": {
          "infer_languages": [
            "en"
          ],
          "use_mul_lang": false
        },
        "experiment": {
          "csi_csi_entertainment_ip": "v1",
          "csi_csi_exp_group_name_3": "involve_photomode_topic",
          "csi_csi_rec_workflow_si_related": "v2_l1_i2i_and_generic_filter",
          "csi_csi_useful_exp_gen_1026": "csi_useful_eu_ttp_exp_gen_v0"
        },
        "language": "en",
        "recall_scores": [
          0.033678531646728516
        ],
        "recall_source": [
          "FromDssmViking"
        ],
        "recall_source_position": {
          "FromDssmViking": 46,
          "FromMidLongTailDssmViking": 46
        },
        "rough_score": 0
      },
      "dislike_option_enabled": true,
      "entity_id": 0,
      "favorited_updated_at": 0,
      "inspiration_types": [
        "search"
      ],
      "is_favorited": false,
      "order_popularity_seq": [],
      "popularity": 71,
      "popularity_updated_at": 1793686119,
      "popularity_v2": 174152
    }
  ],
  "session_refresh_index": 6,
  "status_code": 0,
  "status_msg": ""
}

Response fields

FieldMeaning
inspiration_list[].query_textThe search phrase shown to creators. The text is raw and can contain typos or stray quote marks.
inspiration_list[].query_id_strThe topic ID as a string. Use this string instead of query_id, which is a large number.
inspiration_list[].popularity / inspiration_list[].popularity_v2Two popularity scores for the topic. popularity is a small number such as 71 or 93. popularity_v2 uses a larger provider scale; it is not verified monthly search volume or a count of people.
inspiration_list[].trending_seq / inspiration_list[].trending_seq_v2Provider trend arrays in their reported scales. Per-point timestamps and interval units are not established; do not assume daily points.
inspiration_list[].video_numThe number of videos linked to the topic.
inspiration_list[].query_labelsLabels on the topic. The value content_gap marks a content-gap topic.
inspiration_list[].rec_reason.rec_reason_short_show_textA short reason why TikTok recommends the topic, such as Easy to create. The rec_reason_detail_show_text field gives the longer text.
inspiration_list[].textnet.layer1 / inspiration_list[].textnet.layer2 / inspiration_list[].textnet.layer3Category path for the topic, from broad to specific. Deeper layers can be empty strings.
inspiration_list[].popularity_updated_atUnix timestamp in seconds for the last popularity update.
has_more / cursorhas_more shows whether more topics exist. cursor is the next offset, which was 20 in this response.

Notes

  • Stop after the chosen first page. A separate continuation would use returned cursor as offset when has_more is true, retaining filters and source; no new continuation was executed.
  • Set tab to one of all, content_gap, follower_searched, life_style, topics, challenges, sounds or hashtags.
  • Narrow results with category_filters (for example Gaming or Food) and language_filters (for example en or es).
  • Detail, trend and related-video reads are separately selected tasks with their own contracts and budgets; this discovery read does not execute them automatically.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Inspect one creator-search discovery page

All fields are optional. The schema defaults tab to all, limit to 20, offset to 0, language_filters to en, creator_source to general_search and force_refresh to false. Limit's example is 1, while the saved request uses 10; neither is a documented maximum. The saved all/en/limit10/offset 0 request is not a new content_gap-tab execution. category_filters and language_filters are comma-separated strings, not arrays; a language preference does not guarantee every phrase's language.

The August 20 saved capture has ten records and five content_gap labels. Its first query is new account on tiktok. Preserve exact query_id_str 7449584484497752069: the captured numeric query_id is 7449584484497752000, and all ten numeric IDs differ from their strings. Do not reconstruct an identifier from Number or the rounded capture representation, and do not attribute the capture's precision loss to an unobserved upstream encoding.

After status validation, require inspiration_list as an array of objects. rec_reason is present on only four of the ten records; labels may be empty. A content_gap label is a provider classification, not verified unmet demand, publishing success or an instruction to generate a video. The trimmed README's one displayed record and cursor20 are a separate empty-request reference, not this saved ten-record page.

Preserve popularity, popularity_v2, video_num and each trend series under their source names. A larger score is not an exact monthly search volume or a validated opportunity ranking. trending_seq has no per-point timestamps here; seven values do not establish seven days or a daily growth rate. Keep popularity_updated_at, provider extra.now, saved-example date and your observation time separate.

Stop after this page. The saved cursor is 10 and has_more is true; a separately chosen continuation uses returned cursor as next offset with the same tab, filters and source. Do not increment by a fixed limit or invent continuation_token. No new next page was tested. Choose one query detail separately; do not automatically enrich every candidate or query trend/videos endpoints.

Give your agent one search-insights task

Choose one discovery page or one selected query detail. Give your agent the setup Skill, Markdown quickstart, endpoint and desired result. Keep SANDBASE_API_KEY locally and use POST /v1/api/ with Bearer authentication. Reading a candidate does not automatically authorize pagination, force refresh, trend/video enrichment or media retrieval.

Require completed SandBase status and an object at outputs[0].data, then integer status_code 0. Reject false, string 0 and missing status rather than returning an empty successful object. Saved status_msg is empty; no guessed success word is required. Keep optional fields and unknown values instead of manufacturing zero counts or reasons.

Pricing checked November 8 lists $0.001 per selected call, with 100 daily calls shared across eligible organization APIs and reset at 00:00 UTC. Eligibility is not remaining allowance. Two deliberate requests list at $0.002 before quota effects; the code does not execute a pair automatically. Response cost_tracker and extra.latency are provider fields, not SandBase billing or a measured performance benchmark. No new business, paid, continuation or media call was made. The Creator Search Insights Python guide contains the dated October experiment; use the current request boundaries described here.

Explore more

Related APIs

All APIs
APIPriceResponse
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.01 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON
TikTok$0.001 per callJSON

Questions

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

Should I use numeric query_id or query_id_str?

Use the exact query_id_str. All ten numeric IDs in the saved capture differ from their strings; the first string ends in 2069 while the numeric capture ends in 2000. Do not reconstruct identifiers from a rounded number or treat this as proof of upstream encoding.

Are limit 1, 20 and 10 the same page-size contract?

No. The schema example is 1, default 20, and saved input 10. No provider maximum is declared. The saved all-tab page has ten records, only five with content_gap labels; it is not a newly executed content-gap-only request.

Do popularity series establish daily search volume or a publishing score?

No. These provider fields have distinct scales and no per-point time units here. Keep them raw; seven points do not establish seven days, exact monthly volume or guaranteed success. No automatic trend, video, enrichment or next-page call follows.