{"uid":"cap_8I1b3pI06wDyrCASlSEYS","slug":"tiktok-top-ads-leaderboard-833fcedd","name":"TikTok Top Ads Leaderboard","description":"TikTok ad library — TikTok Creative Center’s global Top Ads leaderboard: the best-performing TikTok ads in any of 81 countries (incl. US and full MENA), ranked by TikTok’s CTR / likes / 2-second-view boards. Returns each ad’s video + cover image, advertiser brand (when disclosed), engagement (likes/comments/shares), landing page, a relative performance + cost index, and campaign objective. Creative trend research, winning-ad discovery, and TikTok ad spy for AI agents.","url":"https://ads.apitoll.cloud/v1/ads/tiktok/top","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"limit":{"type":"integer","maximum":40,"minimum":1,"description":"Max ads to return (1-40)."},"detail":{"type":"boolean","description":"Enrich each ad with landing page URL + share/comment counts. Default true."},"period":{"enum":["7","30","180"],"type":"string","description":"Look-back window in days."},"country":{"type":"string","description":"Two-letter ISO country for the Top Ads leaderboard (US, GB, SA, AE, EG, DE, BR…; 81 supported incl. full MENA). Default US."},"order_by":{"enum":["ctr","like","play_2s_rate","for_you","impression"],"type":"string","description":"Which TikTok leaderboard to pull (results are returned best-first by this metric)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ads":{"type":"array","items":{"type":"object","properties":{"adId":{"type":"string"},"likes":{"type":"number"},"title":{"type":"string"},"shares":{"type":"number"},"country":{"type":"string"},"orderBy":{"type":"string"},"comments":{"type":"number"},"ctrIndex":{"type":"number"},"videoUrl":{"type":"string"},"brandName":{"type":"string"},"costIndex":{"type":"number"},"objective":{"type":"string"},"scrapedAt":{"type":"string"},"coverImage":{"type":"string"},"periodDays":{"type":"number"},"landingPage":{"type":"string"},"industryCode":{"type":"string"},"coverExpiresAt":{"type":"string"}}}},"asOf":{"type":"string"},"count":{"type":"number"},"period":{"type":"string"},"source":{"type":"object","properties":{"via":{"type":"string"},"name":{"type":"string"}}},"country":{"type":"string"},"orderBy":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ads":[{"adId":"7644097429029437458","likes":200,"title":"Art you carry with you from the very first moment of the day. Shop now at casetify.com","shares":1,"country":"US","orderBy":"ctr","comments":2,"ctrIndex":0.04,"videoUrl":"https://v16m-default.tiktokcdn.com/abc/video.mp4","brandName":"CASETiFY","costIndex":1,"objective":"Conversion","scrapedAt":"2026-06-25T11:27:57Z","coverImage":"https://p16-sign.tiktokcdn.com/abc/cover.jpg?x-expires=1782406180","periodDays":30,"landingPage":"https://www.casetify.com/?utm_source=tiktok","industryCode":"label_21104000000","coverExpiresAt":"2026-06-25T16:49:40Z"}],"asOf":"2026-06-25T11:27:57Z","count":20,"period":"30d","source":{"via":"Apify","name":"TikTok Creative Center (Top Ads)"},"country":"US","orderBy":"ctr"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qA86bndWkUIAKp4I7KutU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches TikTok Creative Center's top-performing ads for a given country, ranked by CTR, likes, 2-second view rate, or impressions, with video URLs, engagement stats, and landing pages.","exampleAgentPrompt":"Pull the top 20 TikTok ads in the US from the past 30 days ranked by CTR, and include their landing pages and engagement stats.","exampleUseCases":null,"resultDescription":"Returns an array of up to 40 top TikTok ads for the specified country and leaderboard, each containing the ad ID, video URL, cover image URL, brand name, campaign objective, industry code, engagement counts (likes, comments, shares), CTR index, cost index, landing page URL, look-back period, and a timestamp of when data was scraped. Also includes metadata about the country, ordering metric, total count, and data source.","failureModes":["Missing required 'country' query parameter returns a 400 validation error","Unsupported country code returns empty results or an error","Invalid order_by enum value returns a 400 error","Period value not in ['7','30','180'] returns a 400 error","Limit out of range (less than 1 or more than 40) returns a 400 error","Payment not included or insufficient returns 402 Payment Required","TikTok Creative Center data temporarily unavailable returns 503 or empty ads array","Cover image URLs expire after the time indicated in coverExpiresAt"],"whenToPreferThis":"Use this endpoint when you need to discover top-performing TikTok ads by country and performance metric, conduct creative trend research, perform competitive ad intelligence on TikTok, or find winning ad formats for a specific market. Prefer this over Facebook ad library endpoints when the focus is TikTok-specific creative performance data rather than competitor ad monitoring on Meta platforms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:38:18.292Z","isFirstParty":false}