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. Defaults to US when omitted.
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. Defaults to for-you when omitted.
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.
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=DZ&query=spotify", { headers: { "x-api-key": "YOUR_API_KEY" } } ); const data = await response.json(); console.log(data);