Get TikTok Top Ad analytics
Returns analytics and creative metadata for material_id where available: engagement, CTR, budget, country, industry, and objective. Take the ID from Top Ads List or Spotlight.
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 <= 40lang?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/detail?material_id=7631262985109602311" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "property1": null, "property2": null }}