Start building

TikTok Creator Search Insights

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.0015USD / 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 · 42.3 KB · 1,250 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",
            "llm_query_multi_lang",
            "demand_points",
            "video_agg_score_post",
            "generic_dmp",
            "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": {
              "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,
            78,
            85,
            85,
            87
          ],
          "trending_seq_v2": [
            9802,
            108332,
            295888,
            449234,
            1106431,
            1632089,
            4741221
          ],
          "use_csi_api_for_related_videos": false,
          "user_avatars": [],
          "video_num": 78782
        },
        {
          "business_types": [
            "basic",
            "local service old",
            "experience",
            "hot_event_v2",
            "content_gap",
            "template",
            "llm_query_multi_lang",
            "video_agg_score_post",
            "informative_exp",
            "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": {
              "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,
              0,
              0
            ],
            "recall_source": [
              "FromMidLongTailDssmViking",
              "FromDssmVikingL1",
              "FromDssmViking",
              "FromLangHotQuery",
              "FromRegionHotQueryMulLang"
            ],
            "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,
            88,
            88,
            87,
            87
          ],
          "trending_seq_v2": [
            16569726,
            8924921,
            9322701,
            7903627,
            6814654,
            6193441,
            5771167
          ],
          "use_csi_api_for_related_videos": false,
          "user_avatars": [],
          "video_num": 30685912
        },

Examples

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

API 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

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

NameTypeRequiredDescription
tabstringNoTab type (all/content_gap/follower_searched/life_style/topics/challenges/sounds/hashtags)
limitintegerNoNumber per page, default 20
offsetintegerNoPagination offset, default 0
force_refreshbooleanNoForce refresh, default False
creator_sourcestringNoCreator source, default "general_search"
category_filtersstringNoCategory filters, separated by comma, options: Gaming, Fashion, Tourism, Science, Food, Sports
language_filtersstringNoLanguage 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.

{
  "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).

Pricing

Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
TikTok Creator Search InsightsThis API
TikTok		$0.0015 per callJSON
TikTok LIVE Status
TikTok		$0.0015 per callJSON
TikTok Room Online Status Batch
TikTok		$0.01 per callJSON
TikTok Content Translation
TikTok		$0.0015 per callJSON
TikTok Creator Search Insights Detail
TikTok		$0.0015 per callJSON
TikTok Creator Search Insights Trend
TikTok		$0.0015 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.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.