TikTok Ad Library

GET /v1/ad-library/tiktok/top-ads

TikTok Creative Center Top Ads API

TikTok Creative Center Top Ads — CTR, likes, industry/objective, and video URLs (2 credits native).

2 credits per request

Try in Playground Get your API key — free Read the docs

TL;DR

TikTok Creative Center Top Ads — CTR, likes, industry/objective, and video URLs (2 credits native). The TikTok Creative Center Top Ads API (TikTok Ad Library) is a single authenticated GET request to /v1/ad-library/tiktok/top-ads that responds with clean JSON and costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the TikTok Creative Center Top Ads API?

Pull high-performing auction ads from TikTok Creative Center Top Ads as clean JSON: id, title, brandName, likes, ctr/ctrTier, costTier, favorite, isSparkAd, industry/industryKey, objective, countries, and video{url,urlHd,cover,durationSeconds,width,height}. Filter with country (default US), period (7/30/180), orderBy (for_you|likes|ctr|impressions|cost), and optional q/industry/objective/adFormat. Flat 2 credits on the Decodo-native path; Apify fallback is ~1 credit per returned ad (minimum 2). This is Creative Center — not the EU Commercial Content Library (use /tiktok/search for DSA transparency).

What you get

Ranked, structured result list
Title, URL, author, and thumbnail per result when available
Engagement metrics where the platform exposes them
Configurable result limit

Try it

Open in Playground

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

Parameters

qoptionalstringOptional keyword filter (brand, product, or creative theme).countryoptionalstringTwo-letter ISO country code. Default US.periodoptionalnumberLookback window in days: 7, 30, or 180. Default 30.orderByoptionalstringSort: for_you, likes, ctr, impressions, or cost. Default for_you.industryoptionalstringOptional industry key or label from Creative Center.objectiveoptionalstringOptional campaign objective (e.g. Traffic, Conversion, Reach).adFormatoptionalstringOptional format filter: spark or non_spark.limitoptionalintegerMax items to return (default 20, max 100). Billed per result.cacheoptionalbooleanSet true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

API keyoptionalPaste your key to get a ready-to-run snippet. It stays in your browser.Sign in to run live

curl "https://api.captapi.com/v1/ad-library/tiktok/top-ads?q=skincare" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "query": null,
    "country": "US",
    "period": 30,
    "orderBy": "ctr",
    "totalReturned": 2,
    "ads": [
      {
        "platform": "tiktok_creative_center",
        "id": "7662489073849090066",
        "url": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30&region=US&order_by=ctr",
        "title": "Nuuly loves a woman in a suit ! #ad #nuulypartner #nuuly #frthoidolovenuuly",
        "brandName": "nuuly",
        "likes": 620,
        "ctr": 0.17,
        "ctrTier": "below_50%",
        "costTier": 1,
        "favorite": false,
        "isSparkAd": false,
        "industry": "All Industries",
        "industryKey": "label_23105000000",
        "objective": "Reach",
        "objectiveKey": null,
        "adFormat": "All Formats",
        "countries": [
          "US"
        ],
        "periodDays": 30,
        "video": {
          "id": "v10033g50000example",
          "url": "https://v16m-default.tiktokcdn.com/example.mp4",
          "urlHd": "https://v16m-default.tiktokcdn.com/example-hd.mp4",
          "cover": "https://p16-common-sign.tiktokcdn.com/example~tplv-noop.image",
          "durationSeconds": 15,
          "width": 720,
          "height": 1280
        },
        "media": [
          "https://p16-common-sign.tiktokcdn.com/example~tplv-noop.image",
          "https://v16m-default.tiktokcdn.com/example-hd.mp4",
          "https://v16m-default.tiktokcdn.com/example.mp4"
        ],
        "tags": []
      },
      {
        "platform": "tiktok_creative_center",
        "id": "7662938725836324871",
        "url": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30&region=US&order_by=ctr",
        "title": "How I fix my hair EASILY on the go #hair #hairhack",
        "brandName": null,
        "likes": 5,
        "ctr": 0.62,
        "ctrTier": "top_25%",
        "costTier": 0,
        "favorite": false,
        "isSparkAd": false,
        "industry": "All Industries",
        "industryKey": "label_23105000000",
        "objective": "Product Sales",
        "objectiveKey": null,
        "adFormat": "All Formats",
        "countries": [
          "US"
        ],
        "periodDays": 30,
        "video": {
          "id": "v10033g50000example",
          "url": "https://v16m-default.tiktokcdn.com/example.mp4",
          "urlHd": "https://v16m-default.tiktokcdn.com/example-hd.mp4",
          "cover": "https://p16-common-sign.tiktokcdn.com/example~tplv-noop.image",
          "durationSeconds": 15,
          "width": 720,
          "height": 1280
        },
        "media": [
          "https://p16-common-sign.tiktokcdn.com/example~tplv-noop.image",
          "https://v16m-default.tiktokcdn.com/example-hd.mp4",
          "https://v16m-default.tiktokcdn.com/example.mp4"
        ],
        "tags": []
      }
    ]
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Top-level fields

queryThe search query you sent.
countryCountry for the request context. On popular-creators top-level: ISO feed market you queried (e.g. US) — not each creator's home country (see region).
periodPeriod. Example: 30.
orderByOrder by. Example: "ctr".
totalReturnedNumber of items returned in this response.

Each item in ads contains:

platformPlatform identifier (e.g. youtube, instagram).
idStable platform ID for the item.
urlCanonical URL of the item.
titleTitle of the item.
brandNameAdvertiser / brand name when Creative Center exposes one.
likesLike count (number). Prefer likeCount on YouTube community endpoints.
ctrClick-through rate signal from Creative Center (typically 0–1).
ctrTierCTR performance band (e.g. top_10%, top_25%, below_50%).
costTierRelative spend signal from Creative Center (0–5 style tier).
favoriteFavorite. Example: false.
isSparkAdWhether the creative is a Spark Ad (boosted organic-style post).
industryIndustry. Example: "All Industries".
industryKeyCreative Center industry key / label id.
objectiveObjective. Example: "Reach".
objectiveKeyCreative Center campaign objective key.
adFormatFormat of the ad creative.
countriesCountries (array).
periodDaysLookback window in days used for the Top Ads ranking.
videoObject with id, url, urlHd, cover, durationSeconds, width.
mediaMedia attached to the item.
tagsTags attached to the item.

Parameters

Name	Type	Required	Description
q	string	No	Optional keyword filter (brand, product, or creative theme).
country	string	No	Two-letter ISO country code. Default US.
period	number	No	Lookback window in days: 7, 30, or 180. Default 30.
orderBy	string	No	Sort: for_you, likes, ctr, impressions, or cost. Default for_you.
industry	string	No	Optional industry key or label from Creative Center.
objective	string	No	Optional campaign objective (e.g. Traffic, Conversion, Reach).
adFormat	string	No	Optional format filter: spark or non_spark.
limit	integer	No	Max items to return (default 20, max 100). Billed per result.
cache	boolean	No	Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

Using an AI agent? This endpoint is the MCP tool tiktok_ad_library_top_ads via @captapi/mcp. Set it up →

How it works

1. Sign up — get 100 free credits, no card required.
2. Create a key from your dashboard.
3. Send one request to /v1/ad-library/tiktok/top-ads and parse the JSON response.

Use cases

Trend Discovery

Find trending content by keyword or hashtag.

Content Sourcing

Build feeds and playlists programmatically.

Monitoring

Track topics, brands, and competitors.

Research

Sample large sets of content for analysis.

Frequently asked questions

What does the TikTok Creative Center Top Ads API do?+

The TikTok Creative Center Top Ads API lets you search and return matching results from a public TikTok Ad Library query using one GET request to /v1/ad-library/tiktok/top-ads. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the TikTok Creative Center Top Ads API cost?+

Each successful call costs 2 credits. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Failed or empty results are never charged.

Do I need a TikTok Ad Library API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

How is this different from TikTok Ad Library Search?+

Top Ads is Creative Center performance inspiration (CTR tiers, likes, industry/objective, Spark Ads, video renditions). Ad Library Search is the EU Commercial Content Library (first/last shown, reach bands). Different TikTok products — pick Top Ads for creative intel, Search for DSA transparency.

How many credits does Top Ads cost?+

Flat 2 credits on the Decodo-native Creative Center path. If that path is unavailable, the Apify fallback bills about 1 credit per returned ad (minimum 2).

Is the TikTok Creative Center Top Ads API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h cache (0 credits on hit); default is always fresh. Hits include cached + cachedAt. Selected profile endpoints also accept cacheMaxAge=1d|3d|7d|14d|30d. Use it for analytics, monitoring, and content automation.

More TikTok Ad Library APIs

TikTok Ad Library Search API TikTok Ad Details API

Ready to use the TikTok Creative Center Top Ads API?

Get started free