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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query_id_str | string | Yes | 搜索词条ID,从 fetch_creator_search_insights 接口获取/Query ID from fetch_creator_search_insights | — |
from_tab_path | string | No | 来源标签路径/From tab path | TRENDING,TOPICS |
query_analysis_required | boolean | No | 是否需要查询分析/Whether query analysis is required | true |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --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.

