Search TikTok Ad Library ads
Search TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name.
Headers
Get your API keyAPI key (`sfk_...`)
Country code for Top Ads results. Defaults to US when omitted.
one of: DZ, AR, AU, AT, AZ, BH, BD, BY, BE, BO, BR, BG, KH, CA, CL, CO, CR, HR, CY, CZ, DK, DO, EC, EG, EE, FI, FR, DE, GR, GT, JO, HU, ID, IQ, IE, IL, IT, JP, KZ, KE, KW, LV, LB, MY, MX, MA, NL, NZ, NG, NO, OM, PK, PA, PY, PE, PH, PL, PT, PR, QA, LT, RO, SA, RS, SG, SK, SI, ZA, KR, ES, LK, SE, CH, TW, TH, TR, AE, GB, US, UY, VN
Time window in days for Top Ads.
one of: 7, 30, 180
Optional keyword to search ad titles and content.
max 4096 chars
Search the public TikTok Ads Library by advertiser name. When set, results come from the public Ads Library instead of Top Ads.
min 1 chars · max 4096 chars
Sort metric for Top Ads. Defaults to for-you when omitted.
one of: for-you, impression, play-2s-rate, play-6s-rate, cvr, ctr, like
Industry filter for Top Ads.
one of: apparel-accessories, appliances, apps, baby-kids-maternity, beauty-personal-care, business-services, ecommerce-non-app, education, financial-services, food-beverage, games, health, home-improvement, household-products, life-services, news-entertainment, pets, sports-outdoor, tech-electronics, travel, vehicle-transportation
Campaign objective filter for Top Ads.
one of: app-installs, conversions, lead-generation, product-sales, reach, traffic, video-views
Video duration filter for Top Ads.
one of: under-10s, 10-20s, 20-30s, 30-40s, 40-50s, over-50s
Likes percentile filter for Top Ads.
one of: top-1-20, top-21-40, top-41-60, top-61-80, top-81-100
Ad format filter for Top Ads.
one of: spark-ads, non-spark-ads
Ad language filter for Top Ads.
one of: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko
Opaque pagination cursor from a previous response.
min 1 chars
Endpoint-specific response payload.
Keyword query that was evaluated for this response.
Advertiser name filter that was evaluated, when searching the public Ads Library.
Ads returned for the requested search. This array may be empty when no ads match the filters.
Stable identifier for the ad.
min 1 chars
Ad title or caption when available.
Brand or advertiser name when available.
Relative cost signal when available.
Click-through rate when available.
Like count when available.
≥ 0
Industry key reported for the ad when available.
Campaign objective key when available.
Video creative when available.
Video id when available.
Video duration in seconds when available.
Cover image URL when available.
Video width in pixels when available.
≥ 0
Video height in pixels when available.
≥ 0
Playback URLs by resolution when available.
360p video URL when available.
480p video URL when available.
540p video URL when available.
720p video URL when available.
1080p video URL when available.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of ads can be requested.
Estimated total number of matching ads when available.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/tiktok/ad-library/ads/search?region=DZ&query=spotify" \
-H "x-api-key: YOUR_API_KEY"Responses
TikTok Ad Library search results.