Search TikTok Ads Library ads
Returns public Ads Library ads for region, start_time, end_time, and query. search_type and advertiser_id narrow the match; sort orders results. Pages hold up to 12 ads: send search_id with offset to page.
Authorization
ApiKeyAuth In: header
Query Parameters
Two-letter region code returned by /regions. Must be a country the Ads Library covers — the EEA, Switzerland, the UK, or Turkey. A country served only by Creative Center's Top Ads, such as the US or Brazil, is rejected; use the Top Ads endpoints for those.
^[A-Za-z]{2}$Inclusive start of the requested date range as a Unix timestamp in seconds.
1 <= lengthEnd of the requested date range as a Unix timestamp in seconds. Must be greater than or equal to start_time.
1 <= lengthSearch text, selected advertiser name, selected keyword, or exact phrase, according to search_type.
1 <= length <= 200How query is matched: free_text for typed text, advertiser for a selected advertiser (needs advertiser_id), keyword for a selected keyword, exact_phrase for the whole phrase.
"free_text"Value in
- "free_text"
- "advertiser"
- "keyword"
- "exact_phrase"
Advertiser id from the /suggestions response. Required when search_type is advertiser.
length <= 100Sort by last-shown date, publication date, or impressions in ascending or descending order.
"last_shown_desc"Value in
- "last_shown_desc"
- "last_shown_asc"
- "published_desc"
- "published_asc"
- "impressions_asc"
- "impressions_desc"
Where the page starts. Page one is 0; for later pages send search_id from the previous response alongside it.
0 <= value0Cursor from the previous search response. Send it to get the next page, and use the newest one each time.
length <= 500Ads per page, 1 to 12. TikTok caps public search pages at 12.
1 <= value <= 1212curl -X GET "https://example.com/v1/tiktok-ads/search?region=GB&start_time=1784246400&end_time=1784879999&query=Nike" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "property1": null, "property2": null }}