# 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,… Page: https://docs.toolzerhub.com/reference/tiktok-ads-library ## Public Library Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,… - [Get TikTok Ads Library ad details](https://docs.toolzerhub.com/reference/tiktok-ads-library/public-library/tik-tok-ads-detail.md): `GET /v1/tiktok-ads/ads/detail`. Returns 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. - [Get TikTok Ads Library report](https://docs.toolzerhub.com/reference/tiktok-ads-library/public-library/tik-tok-ads-reports.md): `GET /v1/tiktok-ads/reports`. Returns 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. - [Get TikTok ads search suggestions](https://docs.toolzerhub.com/reference/tiktok-ads-library/public-library/tik-tok-ads-suggestions.md): `GET /v1/tiktok-ads/suggestions`. Returns 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. - [List TikTok ads library regions](https://docs.toolzerhub.com/reference/tiktok-ads-library/public-library/tik-tok-ads-regions.md): `GET /v1/tiktok-ads/regions`. Returns 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. - [Search TikTok Ads Library ads](https://docs.toolzerhub.com/reference/tiktok-ads-library/public-library/tik-tok-ads-search.md): `GET /v1/tiktok-ads/search`. Returns 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. ## Top Ads Analytics Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,… - [Get TikTok Top Ad analytics](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-analytics/tik-tok-top-ads-detail.md): `GET /v1/tiktok-ads/top-ads/detail`. Returns 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. - [Get TikTok Top Ad percentile](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-analytics/tik-tok-top-ads-percentile.md): `GET /v1/tiktok-ads/top-ads/percentile`. Returns the benchmark percentile of material_id for one metric. period sets the comparison window in days (7, 30, or 180; default 180). - [List related TikTok Top Ads](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-analytics/tik-tok-top-ads-recommendations.md): `GET /v1/tiktok-ads/top-ads/recommendations`. Returns Top Ads related to material_id. Requires the ad's full numeric industry_id and comma-separated country_codes; lang sets the display language. - [List TikTok Top Ad keyframes](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-analytics/tik-tok-top-ads-keyframes.md): `GET /v1/tiktok-ads/top-ads/keyframes`. Returns per-second analysis and highlighted moments for the video of material_id. metric selects CTR, CVR, clicks, conversions, or viewer retention. ## Top Ads Dashboard Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,… - [Get TikTok Top Ads suggestions](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-dashboard/tik-tok-top-ads-suggestions.md): `GET /v1/tiktok-ads/top-ads/suggestions`. Returns 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. - [List TikTok Top Ads](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-dashboard/tik-tok-top-ads-list.md): `GET /v1/tiktok-ads/top-ads/list`. Returns 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. - [List TikTok Top Ads filters](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-dashboard/tik-tok-top-ads-filters.md): `GET /v1/tiktok-ads/top-ads/filters`. Returns 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. ## Top Ads Spotlight Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,… - [List TikTok Top Ads Spotlight](https://docs.toolzerhub.com/reference/tiktok-ads-library/top-ads-spotlight/tik-tok-top-ads-spotlight.md): `GET /v1/tiktok-ads/top-ads/spotlight`. Returns Creative Center Spotlight creative records. Page with page and limit (max 20); lang sets the display language. No other input is required. ## URL Helper Search and inspect public TikTok advertising data — public ad search and reports plus Top Ads rankings, filters, analytics, recommendations, performance timelines, benchmarks,… - [Resolve TikTok ads library URL](https://docs.toolzerhub.com/reference/tiktok-ads-library/url-helper/tik-tok-ads-resolve-url.md): `GET /v1/tiktok-ads/resolve-url`. Takes a public TikTok page url and returns the same data as the matching endpoint. Supports Ads Library search, report, and ad-detail URLs, and Creative Center Top Ads dashboard, detail, and Spotlight URLs.