TikTok Ad Library Search API

Search TikTok Commercial Content Library — relevance-filtered, uniform null schema (2 credits native, 5 via fallback).

Search TikTok's Commercial Content Library (library.tiktok.com / EU DSA) by keyword. Local keyword matching is case-insensitive whole-word match=any|all (hair ≠ wheelchair). Envelope uses candidatesScanned / truncated (true when literalMatches > totalReturned); each hit has matchedFrom as a string array of matched fields. platform is tiktok (library=dsa). media[] are objects with url/type/expiresAt when signed. Ads share a uniform key set — withheld fields are null, not missing. firstShown/lastShown are omitted (DSA list XHR stamps scrape/serve times, not run dates) — use /tiktok/ad-details for calendar-day ISO dates. advertiser is always {id,name,url,logo,location}; advertiser.logo is null in practice because the library publishes no advertiser logo (the key stays for the shared ad-library schema). 2 credits when the native path returns results; 5 credits when the fallback path serves them; empty results are 0 credits. Native-only by default (the fallback path is disabled). A miss is a retryable 503 at 0 credits. When the fallback is enabled and the native fetch is slow, it starts beside it (15s for one-page fetches, later for larger limits) and the first useful answer wins. country default GB (US often empty). Coverage is ads shown in the last 30 days (the library's default window): an ad that stopped running more than 30 days ago drops out of results, so a keyword that matched last month can return empty today — use /v1/ad-library/tiktok/ad-details with the ad id for older ads. For brand performance use /v1/ad-library/tiktok/top-ads.

Docs: https://captapi.com/apis/tiktok-ad-library-search