CaptapiCaptapi
TikTok Ad Library · Guide

How to run a TikTok Ad Library top ads

TL;DR
To run a TikTok Ad Library top ads, sign up for a free Captapi key, then send one GET request to /v1/ad-library/tiktok/top-ads with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. TikTok Creative Center Top Ads — CTR, likes, industry/objective, and video URLs (2 credits native).
Get your free API keyAPI reference

How to run a TikTok Ad Library top ads (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the TikTok Creative Center Top Ads API

    Send an authenticated GET request to /v1/ad-library/tiktok/top-ads with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

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_..."

What the response looks like

{
  "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 (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

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

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.

Ready to run a TikTok Ad Library top ads?

Start free with 100 credits — no credit card required.

Get your free API key