Search TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name.
Endpoint
/v1/tiktok/ad-library/ads/search
Query
Country code for Top Ads results. Default: `US`.
Time window in days for Top Ads.
Optional keyword to search ad titles and content.
Search the public TikTok Ads Library by advertiser name. When set, results come from the public Ads Library instead of Top Ads.
Sort metric for Top Ads. `cvr`: conversion rate. `ctr`: click-through rate. `play-2s-rate`/`play-6s-rate`: rate viewers played past the 2s/6s mark. Default: `for-you`.
Industry filter for Top Ads.
Campaign objective filter for Top Ads.
Video duration filter for Top Ads.
Likes percentile filter for Top Ads.
Ad format filter for Top Ads. `spark-ads`: ads boosted from an organic creator/brand TikTok post. `non-spark-ads`: ads uploaded directly as ad creative, not boosted from an existing post.
Ad language filter for Top Ads.
Opaque pagination cursor from a previous response.
const response = await fetch( "https://api.socialfetch.dev/v1/tiktok/ad-library/ads/search?region=US&query=spotify", { headers: { "x-api-key": "YOUR_API_KEY" } } ); const data = await response.json(); console.log(data);