# TikTok Top Ads Leaderboard > TikTok Top Ads Leaderboard is a paid API for AI agents from ads.apitoll.cloud, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15). 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. ## Facts - Endpoint: GET https://ads.apitoll.cloud/v1/ads/tiktok/top - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-09-15 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/tiktok-top-ads-leaderboard-833fcedd - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8I1b3pI06wDyrCASlSEYS Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability tiktok-top-ads-leaderboard-833fcedd ``` Example prompt: 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. ## When to prefer this 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. ## Known failure modes - 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 ## How this service works 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. ## Output 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. ## Request schema (JSON Schema) ```json { "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": " … (truncated) ``` ## Response schema (JSON Schema) ```json { "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" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-top-ads-leaderboard-833fcedd/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from ads.apitoll.cloud](https://www.zero.xyz/host/ads.apitoll.cloud/llms.txt)