# TikTok Creative Center Scraper: Top Ads, Hashtags, Videos (`themineworks/tiktok-creative-center-scraper`) Actor

Scrape TikTok Creative Center top ads by country, industry and objective: landing page, likes, comments, shares, CTR, budget level, target countries and video link, plus trending hashtags and top videos. No login.

- **URL**: https://apify.com/themineworks/tiktok-creative-center-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, Marketing, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.26 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Creative Center Scraper: Top Ads, Hashtags and Videos

[![50 TikTok top ads with landing pages in 25 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/tiktok-creative-center-scraper-hero.png)](https://console.apify.com/actors/1o6zdxeHOK7qEre4S/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns TikTok Creative Center top ads by country, industry and campaign objective, one row per ad with brand, caption, landing page, likes, comments, shares, CTR, budget level, target countries and the video file, plus trending hashtags and top videos. No login, no cookies, no API key. You pay $1.80 per 1,000 rows on the Free plan and $1.26 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

From **The Mine Works**, makers of [TikTok Trends Scraper](https://apify.com/themineworks/tiktok-trends-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [TikTok Ads Library Scraper](https://apify.com/themineworks/tiktok-ads-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 355,000 runs across 350+ public actors.

Updated 17 Nov 2026: first release. Top ads from 28 countries or all at once, for 7, 30 or 180 days, read through all seven of TikTok's rankings and every industry so one run reaches most of the ads TikTok holds for your filters, with each ad's landing page included at no extra charge. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **No TikTok account needed.** Other Creative Center actors ask for your TikTok cookies or a residential proxy. This one reads the same public data any visitor sees at ads.tiktok.com, over Apify's datacenter proxy, with nothing for you to set up.
- **More than 20 ads per search.** TikTok shows visitors who are not logged in the top 20 ads of a ranking. The actor reads all seven rankings (For you, Reach, CTR, CVR, 2 and 6 second view rate, Likes) and, when you ask for more, each industry's rankings too, and merges them. For the US over 30 days TikTok holds 125 top ads; a single ranking gives 20, the sweep gave 114 in our test.
- **The landing page on every row, at the row price.** Each ad's detail record is opened by default: landing page and domain, comments, shares, the countries it ran in, every campaign objective and whether it has a voice over. In our test `landing_page` was filled on 42 of 50 ads; the other 8 were mostly video view, reach and lead form ads, which have no web page.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/1o6zdxeHOK7qEre4S/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 50 top ads shown in the US over the last 30 days, each with its landing page. It took 25 seconds in our test run on Apify:

```json
{
  "dataTypes": ["topAds"],
  "countries": ["US"],
  "period": "30",
  "maxItems": 50
}
```

Add `"hashtags"` and `"videos"` to `dataTypes` to get the trending hashtags and top videos of the same countries in the same run.

Apify's free plan includes $5 of credit every month, which covers about 2,700 rows at this actor's price.

#### Copy to your AI assistant

```text
themineworks/tiktok-creative-center-scraper on Apify. Reads TikTok Creative Center (ads.tiktok.com) with no login: top ads by country, period, industry, objective, language, format and likes tier, plus trending hashtags and top videos. Call ApifyClient("TOKEN").actor("themineworks/tiktok-creative-center-scraper").call(run_input={"dataTypes": ["topAds"], "countries": ["US"], "period": "30", "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: dataTypes (topAds, hashtags, videos), countries (two letter codes, or ALL for top ads of every country), period ("7", "30", "180"), maxItems (default 100, 1 to 10000, whole run), includeDetails (default true: landing page, comments, shares, countries, keywords), includeAnalytics (default false, extra event: retention, CTR and clicks per second, percentiles), sortBy (for_you, reach, ctr, cvr, two_second_view_rate, six_second_view_rate, likes; empty = all), industries (apparel-accessories, apps, games, beauty-personal-care and 17 more; empty = all), expandByIndustry (default true), objectives (traffic, app-installs, conversions, video-views, reach, lead-generation, product-sales, app-promotion), adLanguages (en, es, pt and so on), adFormat (all, spark, non-spark), likesTier (all, top-1-20 ... top-81-100), includeTopCreators (hashtags, default true). Every data row has record_type "ad", "hashtag" or "video". Ad rows carry ad_id, ad_url, brand_name, ad_title, industry, industry_group, objective, objectives, likes, comments, shares, ctr, budget_level, budget, is_search_ad, landing_page, landing_domain, target_countries, keywords, video_id, video_url, video_urls, video_duration_seconds, cover_url, country_code, period_days, rank, sort_by, chart, ranked_in, and with analytics retention_by_second, ctr_by_second, clicks_by_second, highlight_seconds, ctr_percentile, clicks_percentile, reach_percentile. Hashtag rows carry hashtag, posts, views, curve, trend_direction, top_creators. Video rows carry video_id, title, views, organic_views, engagement_rate, view_rate_6s, author_username, author_followers. Each run also writes one row with _type "summary", and rows with _type "info" or "error"; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~tiktok-creative-center-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **Every filter of the Top Ads page.** Country (28, or all at once), last 7, 30 or 180 days, 21 industries, 8 campaign objectives, 16 ad languages, Spark ads or other ads, and the likes tier. They are applied on TikTok's side, so a filter narrows what TikTok returns, not a sample.
- **Seven rankings, merged.** For you, Reach, CTR, CVR, 2 second view rate, 6 second view rate and Likes. An ad found in several rankings is one row; `ranked_in` lists every ranking and industry it appears in with its place there, and `rank` and `sort_by` say where it was first found.
- **Industry names, not codes.** TikTok sends `label_22101000000`; the row says `Apparel & Accessories` (`industry_group`) and the sub industry (`industry`), plus the objective as `Traffic` or `Product sales`.
- **The creative itself.** Video file link in the best quality TikTok serves (up to 1080p, all qualities in `video_urls`), cover image, length and size. Video links are signed by TikTok and stop working after a day or two, so download what you want to keep.
- **Second by second analytics, if you want them.** With `includeAnalytics` on, each ad gets viewer retention, CTR and clicks for every second of the video, the highlight seconds TikTok marks as the strongest, and where the ad ranks against its industry on CTR, clicks and reach.
- **Trending hashtags and top videos in the same run.** Hashtags for 27 countries with posts, views, the daily popularity curve and top creators; top videos for the US, Japan, Vietnam, Thailand and Indonesia with views, organic views, engagement rate and 6 second view rate.
- **Stops cleanly.** A first request that fails ends the run after at most 3 tries; four failed charts in a row end it; it stops before its time limit and keeps every row. The summary row says why.

### How to use it

#### Competitor ads in your industry

```json
{
  "dataTypes": ["topAds"],
  "countries": ["US", "GB"],
  "period": "30",
  "industries": ["beauty-personal-care"],
  "maxItems": 200
}
```

Each country is read on its own. Sort the rows by `likes` or `ctr`, read `landing_page` to see where each brand sends traffic, and `target_countries` for where else the ad ran.

#### Ads that sell: conversions and product sales

```json
{
  "dataTypes": ["topAds"],
  "countries": ["ALL"],
  "period": "180",
  "objectives": ["conversions", "product-sales"],
  "sortBy": ["ctr", "cvr"],
  "maxItems": 100
}
```

`ALL` reads the ads of every country at once (343 ads over 30 days in our test, 500 over 180 days).

#### A swipe file with retention curves

```json
{
  "dataTypes": ["topAds"],
  "countries": ["US"],
  "period": "7",
  "includeAnalytics": true,
  "maxItems": 30
}
```

`retention_by_second` shows where viewers drop off; `highlight_seconds` marks the frames TikTok rates highest, a good opening for your own cut.

#### Weekly trend check for a market

```json
{
  "dataTypes": ["hashtags", "videos"],
  "countries": ["US", "JP"],
  "period": "7",
  "maxItems": 300
}
```

About 40 to 48 hashtags per country (the overall chart and 15 industry charts merged) and up to 66 top videos per country.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `dataTypes` | array | `["topAds"]` | `topAds`, `hashtags`, `videos`. |
| `countries` | array | `["US"]` | Two letter codes. `ALL` reads top ads of every country at once. |
| `period` | string | `"30"` | `"7"`, `"30"` or `"180"` days. Hashtags go back 90 days at most and top videos 30. |
| `maxItems` | integer | `100` | Most rows for the whole run, 1 to 10,000. |
| `includeDetails` | boolean | `true` | Landing page, comments, shares, countries, keywords, objectives, voice over. Same price. |
| `includeAnalytics` | boolean | `false` | Retention, CTR and clicks per second, highlight seconds, percentiles. Extra event per ad. |
| `sortBy` | array | all seven | `for_you`, `reach`, `ctr`, `cvr`, `two_second_view_rate`, `six_second_view_rate`, `likes`. |
| `industries` | array | all | 21 top level industries, e.g. `games`, `apps`, `e-commerce`. |
| `expandByIndustry` | boolean | `true` | With no industry picked, also read each industry's rankings when the overall ones give fewer ads than asked. |
| `objectives` | array | all | `traffic`, `app-installs`, `conversions`, `video-views`, `reach`, `lead-generation`, `product-sales`, `app-promotion`. |
| `adLanguages` | array | all | `en`, `es`, `pt`, `fr`, `de`, `it`, `nl`, `ro`, `ar`, `id`, `ms`, `th`, `vi`, `ja`, `ko`, `zh-Hant`. |
| `adFormat` | string | `all` | `spark` or `non-spark`. |
| `likesTier` | string | `all` | `top-1-20` to `top-81-100`. |
| `includeTopCreators` | boolean | `true` | Hashtags: the creators TikTok lists for each hashtag. |

### What data do you get?

One row per ad, hashtag or video. `record_type` says which. Data rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

#### Ad rows

| Field | What it is |
|---|---|
| `ad_id`, `ad_url` | Creative Center id of the ad and its page |
| `brand_name`, `ad_title` | Brand the advertiser gave (often empty) and the caption |
| `industry`, `industry_group`, `industry_id` | Sub industry, top level industry and TikTok's id |
| `objective`, `objective_key`, `objectives` | Main campaign objective, its key, and every objective the ad ran with |
| `likes`, `comments`, `shares` | Engagement TikTok shows (comments and shares from the detail record) |
| `ctr` | CTR figure TikTok shows for the ad, 0 to 1 |
| `budget_level`, `budget` | 0, 1 or 2: `low`, `medium`, `high` |
| `is_search_ad`, `tiktok_label` | Search ad flag, and TikTok's label (High engagement and so on) when it has one |
| `landing_page`, `landing_domain` | Where the ad sends people |
| `target_countries`, `keywords`, `pattern_labels` | Countries the ad ran in, TikTok's keywords and creative patterns for it |
| `ad_source`, `voice_over` | e.g. `TikTok Ads Manager`; whether the ad has a voice over |
| `video_id`, `video_url`, `video_quality`, `video_urls` | The creative's video, best quality first |
| `video_duration_seconds`, `video_width`, `video_height`, `cover_url` | Length, size and cover image |
| `country_code`, `country_name`, `period_days` | The chart's country and window |
| `rank`, `sort_by`, `chart`, `ranked_in` | Place in the ranking it was first found in, and every ranking it is in |
| `retention_by_second`, `ctr_by_second`, `clicks_by_second` | With analytics: one value per second (`second`, `value`) |
| `highlight_seconds`, `ctr_percentile`, `clicks_percentile`, `reach_percentile` | With analytics: TikTok's strongest seconds, and the ad's rank in its industry from 0 to 1 |
| `details_scraped`, `details_error`, `analytics_scraped` | Whether the detail record and analytics were read |

#### Hashtag rows

`hashtag`, `hashtag_id`, `hashtag_url`, `rank`, `chart`, `ranked_in`, `posts`, `views`, `views_per_post`, `industries`, `curve` (one point a day, 0 to 100), `curve_last_value`, `curve_average`, `curve_peak_date`, `trend_direction` (`up`, `down`, `flat`), `top_creators` (username, nickname, followers, country, profile link), `country_code`, `period_days`, `data_through`.

#### Video rows

`video_id`, `video_url`, `title`, `created_at`, `cover_url`, `video_file_url`, `author_username`, `author_nickname`, `author_followers`, `views`, `views_lifetime`, `organic_views`, `engagement_rate`, `view_rate_6s` (each also as lifetime), `content_tags`, `rank`, `chart`, `ranked_in`, `country_code`, `period_days`, `data_through`.

**Summary row** (`_type: "summary"`, never charged): `ads_pool_total` (how many ads TikTok holds for your filters), `ads_found`, `ads_delivered`, `details_ok`, `details_failed`, `analytics_ok`, `hashtags_delivered`, `videos_delivered`, `charts_read`, `charts_failed`, `http_requests`, `http_kilobytes`, `stopped_by_max_cost`, `shortfall_reason` when fewer rows came back than asked, and `per_job`, one entry per country and data type. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per input that could not be used, with `error_type` (`unsupported_country`, `invalid_input`, `blocked`), `identifier` and `reason`.

#### Stable fields for automations

Present in every ad row of our test runs, names will not change: `record_type`, `ad_id`, `ad_url`, `industry`, `industry_group`, `objective`, `likes`, `ctr`, `budget`, `video_id`, `video_url`, `cover_url`, `video_duration_seconds`, `country_name`, `period_days`, `rank`, `sort_by`, `ranked_in`, and with details on `comments`, `shares`, `target_countries`, `objectives`.

Optional, present only when TikTok has a value: `brand_name` (10 of 50 test ads), `ad_title` (49 of 50), `landing_page` (42 of 50), `keywords` and `pattern_labels` (rarely filled by TikTok), `tiktok_label`.

#### Output example

One top ad from the US, 30 days (test run, 17 Nov 2026, trimmed):

```json
{
  "record_type": "ad",
  "ad_id": "7695854727373029396",
  "ad_url": "https://ads.tiktok.com/business/creativecenter/topads/7695854727373029396/pc/en",
  "ad_title": "Spinach & Spinach Spin: Boost Fiber, Save Time!",
  "industry": "Cooking & Recipes",
  "industry_group": "Food & Beverage",
  "objective": "Traffic",
  "likes": 67,
  "comments": 2,
  "shares": 2,
  "ctr": 0.06,
  "budget_level": 1,
  "budget": "medium",
  "landing_page": "https://olemex.com/product-locator/",
  "landing_domain": "olemex.com",
  "target_countries": ["US"],
  "objectives": ["Traffic"],
  "ad_source": "TikTok Ads Manager",
  "voice_over": false,
  "video_quality": "1080p",
  "video_duration_seconds": 28.673,
  "video_width": 720,
  "video_height": 1280,
  "country_code": "US",
  "period_days": 30,
  "rank": 1,
  "sort_by": "ctr",
  "chart": "CTR, All industries"
}
```

An error row for a country TikTok has no top video chart for (nothing charged):

```json
{ "_type": "error", "error_type": "unsupported_country", "identifier": "GB videos", "reason": "The Creative Center has top video charts only for US, JP, VN, TH, ID, not \"GB\"." }
```

### Pricing

Pay per event: you pay for the rows you receive, plus a flat $0.001 per run, whatever memory you choose. Ad details (landing page and the rest) cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `result` | Once per ad, hashtag or video row stored in your dataset | $1.80 per 1,000 | $1.62 per 1,000 | $1.44 per 1,000 | $1.26 per 1,000 |
| `ad-analytics` | Once per ad delivered with analytics, only when `includeAnalytics` is on | $1.35 per 1,000 | $1.35 per 1,000 | $1.17 per 1,000 | $0.90 per 1,000 |
| `run-start` | Once per run, after the first chart returned rows | $0.001 | $0.001 | $0.001 | $0.001 |

The price of one row is the price per 1,000 divided by 1,000.

Never charged:

- countries or filter values TikTok does not offer (each gets an error row);
- an ad found by two rankings or industries of the same run;
- rows past your `maxItems`;
- the summary, info and error rows;
- a run whose charts return nothing: the start fee is charged only once a chart has returned rows;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Login or cookies needed | Landing page | Hashtags and videos |
|---|---|---|---|---|---|
| **This actor** | $1.80, details included | $0.001 per run | None needed | Included | Yes |
| [Tiktok Creative Center Scraper](https://apify.com/doliz/tiktok-creative-center-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.00 | $0.001 per GB of memory | TikTok cookies required (stated) | Through its Ad Analytics target | Yes |
| [TikTok Creative Center Scraper: Top Ads & Trends](https://apify.com/datapeak/tiktok-creative-center?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.50 per ad, $1.00 per trend, plus platform usage | $0.00005 per GB of memory | No login; residential proxy needed in practice (stated) | Yes (detail mode) | Hashtags and songs (stated) |
| [Tiktok Creative Center Top Ads](https://apify.com/codebyte/tiktok-creative-center-top-ads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.50, analytics +$1.50 | $0.001 per GB of memory | not stated | With analytics on | No |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every Monday at 08:00, every day and so on).
3. Compare runs on `ad_id` to see which ads are new in your industry this week, and on `hashtag` and `trend_direction` for rising hashtags.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

TikTok Creative Center (ads.tiktok.com/business/creativecenter), the free ad inspiration site TikTok runs for advertisers: the Top Ads dashboard and each ad's public detail page, and the current trends pages for hashtags and videos. It reads what any visitor sees without logging in.

#### How many top ads can I get?

TikTok decides how many ads it holds for a country, window and filter set, and shows it in the summary as `ads_pool_total`: 125 for the US over 30 days, 53 over 7 days, 500 over 180 days and 343 for all countries over 30 days in our tests. Visitors who are not logged in see 20 per ranking, so the actor reads several rankings and industries and merges them; the US 30 day sweep reached 114 of 125.

#### Can I search top ads by keyword or brand?

No. TikTok answers keyword searches only for logged in accounts; for visitors it returns no ads, even for a brand that is on the list. Filter the rows on `brand_name`, `ad_title` or `landing_domain` instead, or narrow the run by industry and objective.

#### What about trending songs, creators and keyword insights?

TikTok retired those Creative Center pages in its 2026 redesign; their data calls now answer "deprecated", for every tool. The hashtag and video trends that remain are both in this actor.

#### What do `ctr` and `budget` mean?

They are the figures TikTok's Top Ads page shows for each ad. `ctr` is between 0 and 1. `budget` is TikTok's spend level for the ad: low, medium or high. TikTok does not publish the exact spend.

#### Why do some ads have no brand or landing page?

Many advertisers leave the brand field empty; the caption and the landing domain usually tell you who it is. Video view, reach and lead form ads often send nobody to a web page, so they have no landing page.

#### How long does a run take?

In our test runs on Apify: 25 seconds for the "Try it" input (50 ads with details), 34 seconds for 100 ads of all countries over 180 days, 50 seconds for 134 rows mixing top ads with analytics, hashtags and videos. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. The actor reads public pages over Apify Proxy, which is included. Nothing to set up.

#### Is it legal to scrape TikTok Creative Center?

The actor reads only data TikTok publishes on its Creative Center for anyone to see without logging in: ads advertisers allowed to be shown there, and aggregate trends. You are responsible for how you use the data, including TikTok's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has ready views: Top ads, Ad funnels, Hashtags, Top videos and Hashtag creators.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/tiktok-creative-center-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http tiktok-creative-center-scraper "https://mcp.apify.com/?tools=themineworks/tiktok-creative-center-scraper"`

### Integrations

- **Google Sheets**: send each run's ads to a sheet with Apify's Google Sheets integration; one row per ad fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new top ads in our industry every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

# Actor input Schema

## `dataTypes` (type: `array`):

Top ads: the auction ads TikTok shows in its Creative Center, 28 countries or all at once. Trending hashtags: 27 countries. Top videos: US, Japan, Vietnam, Thailand and Indonesia. Pick one or more.

## `countries` (type: `array`):

Each country is read on its own. ALL reads top ads of every country at once (top ads only). A country that has no chart for a data type gets an error row and costs nothing.

## `period` (type: `string`):

Last 7, 30 or 180 days. Hashtag charts go back 90 days at most and top video charts 30 days, so 180 reads those for 90 and 30 days.

## `maxItems` (type: `integer`):

Most rows for the whole run, across countries and data types. Top ads per country are capped by what TikTok holds for your filters (125 for the US over 30 days in our test).

## `includeDetails` (type: `boolean`):

Opens each ad's detail record: landing page and its domain, comments, shares, the countries the ad ran in, TikTok's keywords for it, every campaign objective, creative patterns and voice over. Same price either way.

## `includeAnalytics` (type: `boolean`):

Adds, per ad: viewer retention, CTR and clicks for each second of the video, the highlight seconds TikTok marks, and where the ad ranks against its industry on CTR, clicks and reach. Charged as a separate ad-analytics event per ad.

## `sortBy` (type: `array`):

Leave empty to read all seven and merge them. TikTok shows visitors who are not logged in the top 20 ads of each ranking, so more rankings means more different ads.

## `industries` (type: `array`):

Leave empty for all industries. Pick some to read only ads of those industries (each industry is read on its own, up to 20 ads per ranking).

## `expandByIndustry` (type: `boolean`):

With no industry picked, when the overall rankings give fewer different ads than you asked for, the actor also reads each industry's rankings (114 of the 125 US ads over 30 days in our test, against 41 from the overall rankings). Turn off for the overall rankings only.

## `objectives` (type: `array`):

Leave empty for all. Only ads run for these objectives.

## `adLanguages` (type: `array`):

Leave empty for all. Only ads in these languages.

## `adFormat` (type: `string`):

Spark ads (boosted organic posts) or other ads, or both.

## `likesTier` (type: `string`):

Only ads whose likes rank in this band of the top ads, or all.

## `includeTopCreators` (type: `boolean`):

For trending hashtags: adds the creators TikTok lists for each hashtag (username, nickname, followers, country, profile link). Same price either way.

## Actor input object example

```json
{
  "dataTypes": [
    "topAds"
  ],
  "countries": [
    "US"
  ],
  "period": "30",
  "maxItems": 50,
  "includeDetails": true,
  "includeAnalytics": false,
  "sortBy": [],
  "industries": [],
  "expandByIndustry": true,
  "objectives": [],
  "adLanguages": [],
  "adFormat": "all",
  "likesTier": "all",
  "includeTopCreators": true
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "dataTypes": [
        "topAds"
    ],
    "countries": [
        "US"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/tiktok-creative-center-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "dataTypes": ["topAds"],
    "countries": ["US"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/tiktok-creative-center-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "dataTypes": [
    "topAds"
  ],
  "countries": [
    "US"
  ],
  "maxItems": 50
}' |
apify call themineworks/tiktok-creative-center-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/tiktok-creative-center-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1o6zdxeHOK7qEre4S/builds/2OPOXDV0E5wkXWZ0S/openapi.json
