TikTok Get Creator Search Insights Trend

2.07 credits/call
ae_tiktok_get_creator_search_insights_trend

### Purpose Retrieve creator search trend insights for an existing query, including search popularity by region and trends over time. ### Inputs - `query_id_str` (required): Query ID obtained from creator search insights. - `from_tab_path` (optional): Source tab path; defaults to `TRENDING,TOPICS`. - `query_analysis_required` (optional): Whether query analysis is required; defaults to `true`. ### Returns Search trend data for the specified query. The response data can include regional popularity and trends over time.

SocialResearch
2.07 credits/call

Pricing

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

Each call has a fixed charge of 2.07 credits. 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
query_id_strstringYes搜索词条ID,从 fetch_creator_search_insights 接口获取/Query ID from fetch_creator_search_insights—
from_tab_pathstringNo来源标签路径/From tab pathTRENDING,TOPICS
query_analysis_requiredbooleanNo是否需要查询分析/Whether query analysis is requiredtrue

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

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_trend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "query_id_str": "xxx"
  }
}'

No response example available yet.