Get TikTok Top Ad percentile
Returns the benchmark percentile of material_id for one metric. period sets the comparison window in days (7, 30, or 180; default 180).
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
material_id*string
Top Ads material ID from the Top Ads List or Spotlight response.
Match
^\d+$Length
length <= 40metric?string
Video-time metric: CTR, CVR, clicks, conversions, or viewer retention.
Default
"retain_ctr"Value in
- "retain_ctr"
- "retain_cvr"
- "click_cnt"
- "convert_cnt"
- "play_retain_cnt"
period?integer
Comparison window in days: 7, 30, or 180.
Default
180lang?string
Creative Center display language. Defaults to English.
Default
"en"Value in
- "en"
- "ja"
- "zh"
- "vi"
- "th"
- "pt"
- "id"
curl -X GET "https://example.com/v1/tiktok-ads/top-ads/percentile?material_id=7631262985109602311" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "property1": null, "property2": null }}