TikTok Ads Library API
Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,…
14 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Public Library
5 endpoints- Get TikTok Ads Library ad details (v1)GETReturns one public Ads Library ad with its media, advertiser, run dates, impressions, and targeting where available. Requires ad_id from a search result; lang sets the label language.
/v1/tiktok-ads/ads/detail1 cr - Get TikTok Ads Library report (v1)GETReturns regional distribution and daily publication counts of ads between start_time and end_time. region, advertiser_id, and query narrow the scope; lang sets the label language.
/v1/tiktok-ads/reports1 cr - Get TikTok ads search suggestions (v1)GETReturns advertiser and keyword suggestions matching query from the Ads Library. suggest_type picks ads (advertisers and keywords) or reports (advertisers only). Use the advertiser ID in Search or Reports.
/v1/tiktok-ads/suggestions1 cr - List TikTok ads library regions (v1)GETReturns the countries covered by TikTok ad data. surface selects the EU Ads Library, the worldwide Top Ads catalog, or both merged; lang sets the label language. No other input is required.
/v1/tiktok-ads/regions1 cr - Search TikTok Ads Library ads (v1)GETReturns 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.
/v1/tiktok-ads/search1 cr
Top Ads Analytics
4 endpoints- Get TikTok Top Ad analytics (v1)GETReturns analytics and creative metadata for material_id where available: engagement, CTR, budget, country, industry, and objective. Take the ID from Top Ads List or Spotlight.
/v1/tiktok-ads/top-ads/detail1 cr - Get TikTok Top Ad percentile (v1)GETReturns the benchmark percentile of material_id for one metric. period sets the comparison window in days (7, 30, or 180; default 180).
/v1/tiktok-ads/top-ads/percentile1 cr - List related TikTok Top Ads (v1)GETReturns Top Ads related to material_id. Requires the ad's full numeric industry_id and comma-separated country_codes; lang sets the display language.
/v1/tiktok-ads/top-ads/recommendations1 cr - List TikTok Top Ad keyframes (v1)GETReturns per-second analysis and highlighted moments for the video of material_id. metric selects CTR, CVR, clicks, conversions, or viewer retention.
/v1/tiktok-ads/top-ads/keyframes1 cr
Top Ads Dashboard
3 endpoints- Get TikTok Top Ads suggestions (v1)GETReturns brand and product keyword suggestions for query from Creative Center Top Ads. count (default 5, max 50) sets how many; country_codes and lang narrow and localize them.
/v1/tiktok-ads/top-ads/suggestions1 cr - List TikTok Top Ads (v1)GETReturns ranked Creative Center Top Ads for country_codes. Filter by period, industry_ids, objective_ids, ad_format, and keyword; sort ranks them. Page with page and limit (max 20), and send search_id for keyword searches.
/v1/tiktok-ads/top-ads/list1 cr - List TikTok Top Ads filters (v1)GETReturns the countries, industries, objectives, languages, creative patterns, and periods you can use as Top Ads filters. IDs returned here feed Top Ads List. lang sets the display language.
/v1/tiktok-ads/top-ads/filters1 cr
Top Ads Spotlight
1 endpointURL Helper
1 endpointWhat you can build
- Find examples of advertising in a market or category.
- Compare creative approaches across advertisers.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/tiktok-ads/search?region=<region>&start_time=<start_time>&end_time=<end_time>&query=<query>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.