TikTok Top Ads Ad
GET
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
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringAd id or detail URL from search.
Example:
https://ads.tiktok.com/business/creativecenter/topads/7686267188656750612/pc/en?period=30fields?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}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
ctr?numberurl?stringcost?integerad_id?stringformat?stringsource?stringduration?numberheadline?stringcountries?array<string>image_url?stringobjective?stringvideo_url?stringlike_count?integerobjectives?array<>voice_over?unknownshare_count?integerindustry_key?stringkeyword_list?unknownlanding_page?stringcomment_count?integeradvertiser_name?stringcurl -X GET 'https://api.piloterr.com/v2/tiktoktopads/ad?query=string'Example Response
{ "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"}