POST /v1/data/tiktok/ads/run
Pricing: $0.002 per ad ($2.00 per 1,000).
Ways to call it
- Search Query: set
query(optional:country,maxResults) - Advertiser: set
advertiser(optional:country,maxResults) - URLs: set
urls(optional:country,maxResults)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Country whose TikTok Ad Library to search. TikTok publishes its ad library only for the EU/EEA, Switzerland and the United Kingdom. Germany (DE) by default. Example: France (FR).32 allowed values, for example
AT (Austria), BE (Belgium), BG (Bulgaria), HR (Croatia), CY (Cyprus), CZ (Czech Republic), DK (Denmark), EE (Estonia), FI (Finland), FR (France). Fetch the full list with GET /v1/data/tiktok/ads?expand=options.Example
Response fields
Each row indata is one ad, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For Meta ads usefacebook/ads; for Google ads use google-ads/ads; for LinkedIn ads use linkedin/ads-library.