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 detailsReturns 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 crGET - Get TikTok Ads Library reportReturns 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 crGET - Get TikTok ads search suggestionsReturns 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 crGET - List TikTok ads library regionsReturns 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 crGET - Search TikTok Ads Library adsReturns 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 crGET
Top Ads Analytics
4 endpoints- Get TikTok Top Ad analyticsReturns 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 crGET - Get TikTok Top Ad percentileReturns 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 crGET - List related TikTok Top AdsReturns 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 crGET - List TikTok Top Ad keyframesReturns 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 crGET
Top Ads Dashboard
3 endpoints- Get TikTok Top Ads suggestionsReturns 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 crGET - List TikTok Top AdsReturns 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 crGET - List TikTok Top Ads filtersReturns 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 crGET
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.