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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query?stringFull TikTok Top Ads search URL, or a keyword.
Example:
https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30®ion=ARkeyword?stringBrand or product keyword.
region?stringISO country code (country_code).
Example:
ARobjective?stringCampaign objective id (URL param object).
Example:
4period?stringLookback window: 7, 30, or 180.
"30"order_by?stringSort: for_you, reach/impression, ctr/like.
industry?stringIndustry key filter.
page?numberPage number.
per_page?numberPage size (max 20).
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.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 }}