TikTok Ads Get Ad Percentile

2.07 credits/call
ae_tiktok_ads_get_ad_percentile

Use this tool to compare an ad material’s performance with other ads in the same industry. Provide the required ad material ID in `request_body.material_id`. You may optionally choose `metric` (default: `ctr_percentile`) from `ctr_percentile`, `time_attr_conversion_rate_percentile`, `click_cnt_percentile`, `time_attr_convert_cnt_percentile`, or `show_cnt_percentile`; set `period_type` in days (default: 180); and provide `cookie` if needed. The response includes the request status and operation data, with percentile results for the selected metric and, when available, related percentile values and industry-average comparisons.

Social
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
request_bodyobjectYes请求体对象,包含必填的广告素材 ID,以及可选的分析指标、按天计的时间范围和自定义 Cookie,用于获取该素材在同行业中的指标百分位排名数据。—
request_body.cookiestringNo自定义Cookie字符串(可选)—
request_body.metricstringNo分析指标/Analysis metric (ctr_percentile, time_attr_conversion_rate_percentile, click_cnt_percentile, time_attr_convert_cnt_percentile, show_cnt_percentile)ctr_percentile
request_body.material_idstringYes广告素材ID/Ad material ID—
request_body.period_typeintegerNo时间范围(天)/Time period (days)180

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

No response example available yet.