TikTok Get Creator Search Insights

2.07 credits/call
ae_tiktok_get_creator_search_insights

Retrieves creator search insights that can help explore search trends and content opportunities. Choose an insight tab and optionally filter by language or category; use offset and limit to page through results. The response contains the matching insight data plus response metadata, including the request parameters and generation time.

SocialResearch
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tabstringNo标签页类型/Tab type (all/content_gap/follower_searched/life_style/topics/challenges/sounds/hashtags)all
limitintegerNo每页数量/Number per page20
offsetintegerNo分页偏移量/Pagination offset0
force_refreshbooleanNo是否强制刷新/Force refreshfalse
creator_sourcestringNo创作者来源/Creator sourcegeneral_search
category_filtersstringNo分类过滤器,多个用逗号分隔/Category filters (Gaming/Fashion/Tourism/Science/Food/Sports)""
language_filtersstringNo语言过滤器,多个用逗号分隔/Language filters (id/de/en/es/fr/pt/vi/tr/ar/th/ja/ko)en

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_get_creator_search_insights' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "creator_source": "general_search",
    "language_filters": "th",
    "limit": 20,
    "offset": 0,
    "tab": "topics"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "extra": {
      "logid": "202611110312245498C52E8D6F2930398F",
      "now": 1794366744597,
      "vgeo": "VGeo-US"
    },
    "status_code": 512001,
    "status_msg": "build workflow error"
  },
  "docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_creator_search_insights_api_v1_tiktok_app_v3_fetch_creator_search_insights_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "category_filters": "",
    "creator_source": "general_search",
    "force_refresh": "false",
    "language_filters": "th",
    "limit": "20",
    "offset": "0"
  }
}

This example shows part of the response. Copied content is valid JSON.