Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
Search Query.
string
Advertiser.
string[]
One or more urls. One request reads them all.
string
default:"DE"
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.
integer
default:"100"
How many ads to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one ad, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For Meta ads use facebook/ads; for Google ads use google-ads/ads; for LinkedIn ads use linkedin/ads-library.