TikTok Top Ads Ad
Get one TikTok Creative Center Top Ad by URL or id: creative, landing page, CTR, and engagement (1 credit).
Credit cost: 1 credit per call
Autorização
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
query*string
Ad id or detail URL from search.
Example:
https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/tiktoktopads/ad?query=string"{ "ctr": 0.22, "url": "https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30", "cost": 1, "ad_id": "7686267188656750612", "format": "video", "source": "TikTok Ads Manager", "duration": 32.9, "headline": "25% Off Our Popular Juice Groove Router Jig. Limited Time Sale!", "countries": [ "US" ], "image_url": "https://p16.tiktokcdn.com/detail-cover.jpg", "objective": "campaign_objective_conversion", "video_url": "https://v16.tiktokcdn.com/detail.mp4", "like_count": 39, "objectives": [ { "label": "campaign_objective_conversion", "value": 3 } ], "voice_over": null, "share_count": 1, "industry_key": "label_21103000000", "keyword_list": null, "landing_page": "https://craftedelements.com/products/juice-groove-router-jig", "comment_count": 0, "advertiser_name": "crafted elements"}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}