TikTok Get Creator Search Insights Detail

2.07 credits/call
ae_tiktok_get_creator_search_insights_detail

Retrieve detailed creator search insights for a specific query. Inputs: - `query_id_str` (required): Query ID obtained from creator search insights. - `time_range` (optional): `past_7_days`, `past_30_days` (default), `past_60_days`, `past_6_months`, or `custom`. - `start_date` and `end_date` (optional): Unix timestamps in seconds, used for a custom range. Provide both; the custom range cannot exceed six months. - `dimension_list` (optional): Comma-separated dimensions: `gender`, `age`, and/or `country`. Returns detailed search insight data, including search trends and audience demographics.

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
end_dateintegerNo结束时间戳(秒),仅当 time_range=custom 时生效/End timestamp (seconds), only for custom range—
start_dateintegerNo开始时间戳(秒),仅当 time_range=custom 时生效/Start timestamp (seconds), only for custom range—
time_rangestringNo时间范围/Time range (past_7_days/past_30_days/past_60_days/past_6_months/custom)past_30_days
query_id_strstringYes搜索词条ID,从 fetch_creator_search_insights 接口获取/Query ID from fetch_creator_search_insights—
dimension_liststringNo维度列表,多个用逗号分隔/Dimension list (gender/age/country)gender,age,country

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

No response example available yet.