TikTok
TikTok Ad Library Top Ads
Get the top-performing ads on TikTok, optionally filtered by industry and country - each ad's click-through rate, likes, a performance highlight and video cover, with pagination. Costs 1 credit per call.
POST/api/v1/tiktok/ads/top
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonindustrystringRestrict results to a single industry, by its industry key.
Example: label_22108000000
countrystringTwo-letter country the ad ran in.
Example: US
pagenumberdefault:1Page number (1-100).
limitnumberdefault:20Results per page (1-50).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok.ads_top(country="US")
print(results)Response
},
"response_time": 503,
"credits_used": 1,
"credits_remaining": 4572
}