TikTok Top Ads Scraper

TikTok Creative Center Top Ads is a public ad inspiration library. This actor collects structured Top Ads data, video metadata, engagement fields, landing pages, and keyframe performance metrics from TikTok Creative Center.

Introduction

The TikTok Top Ads scraper starts from Creative Center Top Ads URLs, ad detail URLs, or a keyword input. It follows Top Ads result pages, opens each ad record, and extracts structured data for research and analytics workflows.

Use Cases

• Creative research: Analyze ad titles, brands, landing pages, hooks, video metadata, and visible ad patterns.
• Competitor monitoring: Track Top Ads across selected countries, industries, objectives, and time periods.
• Performance analysis: Collect available retention, click, conversion, and play-retention keyframe metrics.
• Data pipelines: Feed dashboards, spreadsheets, BI tools, and internal ad intelligence workflows.

Input

Provide the following fields:

• startUrls (array, optional): TikTok Creative Center Top Ads list URLs or Top Ads detail URLs.
• keyword (string, optional): Keyword used to search Top Ads results.
• country (array, optional): One or more country filters.
• industry (array, optional): One or more industry filters.
• objective (array, optional): One or more campaign objective filters.
• adLanguage (array, optional): One or more ad language filters.
• adFormat (string, optional): Ad format filter. Select Spark Ads or Non-Spark Ads.
• orderBy (string, optional): Result order. Supports For You, CTR, Reach, 2 Views Rate, 6 Views Rate, CVR, and Likes.
• period (string, optional): Top Ads time range. Supported values are Last 7 days, Last 30 days, and Last 180 days.
• maxItems (integer, optional): Maximum number of ad items to extract per source.
• proxyConfiguration (object, optional): Apify proxy settings.

Notes:

• Provide at least one of startUrls or keyword.
• A keyword can be used with startUrls, or by itself when no start URL is provided.
• Country, industry, objective, ad language, ad format, order, and period filters are applied to list requests.
• Crawling stops per source when maxItems is reached or when no more Top Ads results are available.
• Proxies are recommended for stable larger runs.

Input Examples

1) Start URLs

{
  "startUrls": [
    {
      "url": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?period=30&region=ID"
    }
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

2) Keyword with filters

{
  "keyword": "kaos",
  "country": ["ID"],
  "industry": ["22"],
  "objective": ["3"],
  "adLanguage": ["id", "en"],
  "adFormat": "1",
  "orderBy": "impression",
  "period": "180",
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output

Each dataset item contains fields like:

{
  "id": "7638635028650033160",
  "title": "18 bayi terlantar menangis lapar. Mari bantu penuhi stok susu & popok mereka.",
  "brandName": "",
  "countryCodes": ["ID"],
  "landingPage": "https://example.com/campaign",
  "source": "TikTok Ads Manager",
  "sourceKey": 1,
  "industryKey": "label_23105000000",
  "objectiveKey": "campaign_objective_conversion",
  "objectives": [
    {
      "label": "campaign_objective_conversion",
      "value": 3
    }
  ],
  "ctr": 0.5,
  "cost": 1,
  "likes": 360,
  "comments": 7,
  "shares": 4,
  "favorite": false,
  "keywords": [],
  "patternLabels": [],
  "highlightText": "",
  "hasSummary": false,
  "voiceOver": false,
  "videoId": "v10033g50000d81e9hvog65iv8kn62pg",
  "videoDuration": 41.2,
  "videoCover": "https://example.com/video-cover",
  "videoUrls": {
    "720p": "https://example.com/video-720p"
  },
  "videoWidth": 720,
  "videoHeight": 1280,
  "retainCvr": {
    "duration": 42,
    "highlights": [13, 15, 38],
    "analysis": [
      {
        "second": 0,
        "value": 0
      }
    ]
  },
  "retainCtr": {
    "duration": 42,
    "highlights": [13, 20, 38],
    "analysis": []
  },
  "clickCount": {
    "duration": 42,
    "highlights": [1, 3, 13],
    "analysis": []
  },
  "conversionCount": {
    "duration": 42,
    "highlights": [2, 13, 15],
    "analysis": []
  },
  "playRetainCount": {
    "duration": 42,
    "highlights": [],
    "analysis": []
  }
}

The scraper paginates through Top Ads list results and enriches each ad with available detail and keyframe metric data.

Why use the TikTok Top Ads Scraper?

• Focused: Built for TikTok Creative Center Top Ads list and detail flows.
• Filtered searches: Supports keyword, country, industry, objective, ad language, ad format, order, and period inputs.
• Structured output: Produces ready-to-use JSON records for ad research and automation.
• Metric enrichment: Includes available retention, click, conversion, and play-retention keyframe data.
• Apify-native: Works with Apify datasets, request queues, and proxy configuration.

FAQ

• How many ads can it extract?
  Controlled by maxItems per source list.

• Can I scrape one ad detail page?
  Yes. Add a Top Ads detail URL to startUrls.

• Can I search without a start URL?
  Yes. Provide keyword and optional filters.

• Do I need proxies?
  Proxies are recommended for stability, especially for larger runs.

• What if some metric fields are empty?
  The actor keeps the ad record and returns available data when a keyframe metric is not available.

• What if TikTok Creative Center changes?
  The actor may require updates to keep extraction stable.

Need to scrape ads from other platforms?

Check out our other scrapers:

• TikTok Ads.
• Google Ads.
• Bing Ads.
• Reddit Ads.

---

Need help or want a custom solution?

Lexis Solutions is a certified Apify Partner. We can help with custom data extraction projects.

Contact us over Email or LinkedIn.

Support Our Work

If you're happy with our work and scrapers, you're welcome to leave us a company review here and leave a review for the scrapers you're subscribed to.

Image Credit

Image credit: TikTok Creative Center