Skip to main content
GET
Search the TikTok Ad Library
The TikTok Ad Library is EU-only (EU Digital Services Act ad transparency). Use an EU region such as DE, FR, IE, or NL. Pass advertiser_id to scope to a single advertiser, or query for a keyword search.
Each request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

query
string
default:""

Keyword to search ads by. Ignored when advertiser_id is set.

advertiser_id
string
default:""

Advertiser business id(s) to scope the search to a specific advertiser.

region
string
default:DE

EU region code — the Ad Library is EU-only (e.g. DE, FR, IE, NL).

days
integer
default:30

Look-back window in days for ads shown.

Required range: 1 <= x <= 365
sort
string
default:last_shown_date,desc

Sort order, ',' (e.g. last_shown_date,desc).

offset
integer
default:0

Result offset for pagination.

Required range: x >= 0
search_id
string
default:""

Opaque search id from a prior page's pagination.search_id, to chain pages.

count
integer
default:20

Maximum number of items to return (1-50).

Required range: 1 <= x <= 50

Response

200 - application/json

Ad Library results

pagination
object
required

Pagination metadata for Ad Library search.

region
string
required
ads
object[]