TikTok Top Ads Search
Search TikTok Creative Center Top Ads by region, objective, period, and keyword. Returns ad cards and pagination (1 credit).
Credit cost: 1 credit per call
Authentification
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Paramètres de requête
query?string
Full TikTok Top Ads search URL, or a keyword.
Example:
https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30®ion=ARkeyword?string
Brand or product keyword.
region?string
ISO country code (country_code).
Example:
ARobjective?string
Campaign objective id (URL param object).
Example:
4period?string
Lookback window: 7, 30, or 180.
Default
"30"order_by?string
Sort: for_you, reach/impression, ctr/like.
industry?string
Industry key filter.
page?number
Page number.
per_page?number
Page size (max 20).
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/tiktoktopads/search"{ "results": [ { "ctr": 0.97, "url": "https://ads.tiktok.com/business/creativecenter/topads/7683821191329005569/pc/en?period=30", "cost": 0, "ad_id": "7683821191329005569", "format": "video", "headline": "DESCUBRE", "image_url": "https://p16.tiktokcdn.com/cover.jpg", "objective": "campaign_objective_lead_generation", "video_url": "https://v16.tiktokcdn.com/video.mp4", "like_count": 4120, "industry_key": "label_10104000000", "advertiser_name": "Example Brand" } ], "pagination": { "next": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30®ion=AR&page=2", "page": 1, "cursor": "2", "per_page": 20, "total_pages": 3, "total_results": 47 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}