# TikTok Creative Center Scraper — Top Ads & Trends (`datapeak/tiktok-creative-center`) Actor
Scrape the TikTok Creative Center for Top Ads and trends. Extract ad creatives, brands, industries, CTR/likes signals, video URLs and regions as JSON/CSV. Built for media buyers, UA teams and creative research. Filter by country and industry. Pay per result or run via API.
- **URL**: https://apify.com/datapeak/tiktok-creative-center.md
- **Developed by:** [Gal Gilboa](https://apify.com/datapeak) (community)
- **Categories:** E-commerce, Social media, Lead generation
- **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 ad scrapeds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## TikTok Creative Center Scraper — Top Ads, Trending Hashtags & Songs
Extract structured data from **TikTok Creative Center** (ads.tiktok.com/business/creativecenter): the **top-performing TikTok ads** by country, industry, campaign objective and keyword — brand name, ad title, downloadable video URL, cover image, likes, comments, shares, CTR score, spend tier and landing page — plus **trending hashtags and songs** by region. No login, no TikTok API key, public data only.
Built for **media buyers, performance-creative teams, dropshippers and agencies**: see which TikTok ads actually win in your vertical, pull the creatives into a swipe file, and track the hashtags/sounds trending in your market — on a schedule, in bulk.
### Why this Actor?
- **API-level reliability** — talks directly to Creative Center's own JSON API instead of driving a headless browser against a JavaScript shell. The required signed headers are minted in-process (JSDOM) — no browser, no brittle UI automation.
- **Landing pages & full engagement included** — most Creative Center scrapers stop at the list data. This Actor's detail mode adds the fields the list hides: **landing page URL**, comments, shares, target countries and creative keywords.
- **Three surfaces in one Actor** — Top Ads (competitor creatives), trending hashtags, trending songs. One tool for the whole creative-research workflow.
- **Winning-ad signals** — TikTok's own CTR score, spend tier, likes and "favorite" flag per ad, sortable by CTR / likes / For-You ranking.
- **Fast & cheap** — plain HTTP + one lightweight header-mint per session. No browser image, no per-page rendering cost.
### What data does it return?
#### Top Ads mode (one item per ad)
- Brand name + ad title (hook text)
- Ad ID + permanent Creative Center URL
- Video URL (highest resolution available) + cover image + video ID, duration, dimensions
- Likes, comments, shares (comments/shares via detail mode)
- CTR score (TikTok-normalized 0–1), spend tier (0–5), favorite flag
- Campaign objective + industry key, search-ad flag
- **Landing page URL**, target countries, creative keywords, pattern labels, voice-over flag (detail mode)
#### Trends modes (one item per hashtag / song)
- Rank, rank change vs. previous period, promoted flag
- Hashtags: name, post count, video views, industry, trend curve, tiktok.com URL
- Songs: title, artist, duration, cover, TikTok music URL, trend curve
### Sample output (Top Ads)
```json
{
"type": "ad",
"adId": "7613813410505555976",
"brandName": "Pacific Mill Lofts",
"adTitle": "Love the space you're in with loft-style apartments in the heart of the city",
"likes": 2360,
"comments": 184,
"shares": 96,
"ctr": 0.61,
"costTier": 2,
"favorite": false,
"objective": "Conversion",
"objectiveKey": "campaign_objective_conversion",
"industryKey": "label_25100000000",
"videoUrl": "https://v16m-default.tiktokcdn.com/....mp4",
"coverUrl": "https://p16-sign-va.tiktokcdn.com/....image",
"videoDurationSeconds": 15.034,
"landingPage": "https://pacificmilllofts.example.com/tours?utm_source=tiktok",
"countryCodes": ["US", "CA"],
"keywords": ["apartments", "loft living"],
"detailsUrl": "https://ads.tiktok.com/business/creativecenter/topads/7613813410505555976/pc/en",
"region": "US",
"periodDays": 30,
"scrapedAt": "2026-07-12T12:00:00.000Z"
}
````
Fields TikTok doesn't expose for a given item come back as `null` / `[]` — the Actor never fails a run over a missing field.
### How to use it
| Input | What it does |
|---|---|
| `mode` | `topAds` (default), `hashtags`, or `songs` |
| `region` | Two-letter country code (`US`, `GB`, `DE`, …); empty = worldwide |
| `period` | Trailing window: 7 / 30 / 180 days (trends max out at 120 — mapped automatically) |
| `keyword` | Free-text top-ads search, e.g. `skincare` |
| `industry` | TikTok industry ID — apply the filter in the Creative Center UI and copy the `industry=` value from the URL |
| `objective` | TikTok objective ID — same copy-from-URL trick with `objective=` |
| `orderBy` | `for_you` (default), `ctr`, or `like` |
| `fetchAdDetails` | Per-ad detail call for landing page, comments, shares, countries, keywords (default on) |
| `maxItems` | Cap on dataset items per run (default 100) |
| `proxyConfiguration` | Apify RESIDENTIAL proxy — required in practice, TikTok blocks datacenter IPs |
**Tip:** without login, TikTok surfaces roughly 20–100 top ads per filter combination. For large swipe files, vary `country × industry × period` across scheduled runs — deduplication by ad ID is automatic within a run.
### Use cases
- **Creative swipe files** — pull the top ads in your vertical weekly; study hooks, formats and CTAs of proven winners before your next shoot.
- **Winning-product research** — `objective=Conversions` + your industry + `orderBy: ctr` = the creatives that are actually selling right now.
- **Landing-page intelligence** — detail mode exposes where each winning ad sends traffic; map competitor funnels at scale.
- **Trend-jacking** — schedule the hashtag/song modes daily and catch rising sounds while they're still early.
- **Agency reporting & pitches** — attach the actual top ads (with engagement data) for a prospect's industry to your deck via the API.
### Pricing (pay per event)
| Event | Price | Meaning |
|---|---|---|
| `ad-scraped` | $0.0015 | One Top-Ads record in the dataset |
| `trend-scraped` | $0.001 | One trending hashtag or song record |
Example: 200 top ads with full details = **$0.30**. A daily 50-hashtag trend pull for a month = **$1.50**. The Actor respects your maximum cost per run and stops cleanly when the limit is reached.
### Fair use & limitations
- Only public Creative Center data is accessed — the same ad-inspiration information TikTok shows any logged-out visitor at ads.tiktok.com/business/creativecenter. No login, no personal data.
- `ctr` is TikTok's **normalized 0–1 score**, not a raw click-through rate; `costTier` is a relative spend tier (0–5). TikTok does not publish raw numbers.
- Video CDN URLs are signed and **expire in ~24–48 hours** — download promptly; `coverUrl` lives longer, and `detailsUrl` is permanent.
- TikTok surfaces a limited ad pool per filter combination without login (typically 20–100); this is a platform-side cap, not an Actor limit.
- This Actor covers the global Creative Center. The EU **Ad Library** (DSA transparency archive with targeting/reach data) is a different surface — on the roadmap as a separate mode.
### Integrations
Standard Apify platform features apply: export to JSON/CSV/Excel, API access, webhooks, and scheduled runs for continuous creative monitoring.
### Development
```bash
npm install
npm test # parses the saved API fixtures, 37 assertions
apify run # local run (uses ./storage)
```
# Actor input Schema
## `mode` (type: `string`):
Top Ads — top-performing TikTok ads (video URLs, brand, likes, CTR score, landing pages). Trending hashtags / Trending songs — the Creative Center trend rankings.
## `region` (type: `string`):
Two-letter country code, e.g. US, GB, DE, IL. Leave empty for worldwide.
## `period` (type: `string`):
Trailing time window in days. Note: for trends (hashtags/songs) TikTok's longest window is 120 days — selecting 180 automatically uses 120.
## `maxItems` (type: `integer`):
Maximum number of dataset items (ads or trend entries) for this run. Note: without login TikTok typically surfaces 20–100 top ads per filter combination — vary filters across runs for bigger datasets.
## `keyword` (type: `string`):
Free-text keyword to search top ads for, e.g. skincare. Leave empty for no keyword filter.
## `industry` (type: `string`):
TikTok industry ID(s), comma-separated (e.g. 25100000000 for Beauty & Personal Care). Copy the industry= param from the Creative Center URL after applying the filter in the UI. For hashtags mode this is passed as industry\_id. Leave empty for all industries.
## `objective` (type: `string`):
TikTok objective ID (e.g. 3 for Conversions). Copy the objective= param from the Creative Center URL after applying the filter in the UI. Leave empty for all objectives.
## `orderBy` (type: `string`):
Ranking order for Top Ads. ctr surfaces proven click-drivers; like surfaces engagement winners.
## `adLanguage` (type: `string`):
Two-letter language code to filter ad creative language, e.g. en, es, de. Leave empty for all languages.
## `fetchAdDetails` (type: `boolean`):
If enabled (recommended), the Actor calls the per-ad detail endpoint to add fields the list hides: comments, shares, landing page URL, target countries, objectives and keywords. If disabled, only the lighter list data is returned (faster, same price per ad).
## `proxyConfiguration` (type: `object`):
Proxy to use for the requests. Apify RESIDENTIAL proxy is required in practice — TikTok blocks datacenter IPs aggressively.
## Actor input object example
```json
{
"mode": "topAds",
"region": "US",
"period": "30",
"maxItems": 100,
"orderBy": "for_you",
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("datapeak/tiktok-creative-center").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
} }
# Run the Actor and wait for it to finish
run = client.actor("datapeak/tiktok-creative-center").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call datapeak/tiktok-creative-center --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=datapeak/tiktok-creative-center",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "TikTok Creative Center Scraper — Top Ads & Trends",
"description": "Scrape the TikTok Creative Center for Top Ads and trends. Extract ad creatives, brands, industries, CTR/likes signals, video URLs and regions as JSON/CSV. Built for media buyers, UA teams and creative research. Filter by country and industry. Pay per result or run via API.",
"version": "0.1",
"x-build-id": "UYNwAcJICfkwRdKUo"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/datapeak~tiktok-creative-center/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-datapeak-tiktok-creative-center",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/datapeak~tiktok-creative-center/runs": {
"post": {
"operationId": "runs-sync-datapeak-tiktok-creative-center",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/datapeak~tiktok-creative-center/run-sync": {
"post": {
"operationId": "run-sync-datapeak-tiktok-creative-center",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"title": "What to scrape",
"enum": [
"topAds",
"hashtags",
"songs"
],
"type": "string",
"description": "Top Ads — top-performing TikTok ads (video URLs, brand, likes, CTR score, landing pages). Trending hashtags / Trending songs — the Creative Center trend rankings.",
"default": "topAds"
},
"region": {
"title": "Region",
"type": "string",
"description": "Two-letter country code, e.g. US, GB, DE, IL. Leave empty for worldwide.",
"default": "US"
},
"period": {
"title": "Period",
"enum": [
"7",
"30",
"180"
],
"type": "string",
"description": "Trailing time window in days. Note: for trends (hashtags/songs) TikTok's longest window is 120 days — selecting 180 automatically uses 120.",
"default": "30"
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum number of dataset items (ads or trend entries) for this run. Note: without login TikTok typically surfaces 20–100 top ads per filter combination — vary filters across runs for bigger datasets.",
"default": 100
},
"keyword": {
"title": "Keyword (Top Ads only)",
"type": "string",
"description": "Free-text keyword to search top ads for, e.g. skincare. Leave empty for no keyword filter."
},
"industry": {
"title": "Industry ID",
"type": "string",
"description": "TikTok industry ID(s), comma-separated (e.g. 25100000000 for Beauty & Personal Care). Copy the industry= param from the Creative Center URL after applying the filter in the UI. For hashtags mode this is passed as industry_id. Leave empty for all industries."
},
"objective": {
"title": "Campaign objective ID",
"type": "string",
"description": "TikTok objective ID (e.g. 3 for Conversions). Copy the objective= param from the Creative Center URL after applying the filter in the UI. Leave empty for all objectives."
},
"orderBy": {
"title": "Sort by",
"enum": [
"for_you",
"ctr",
"like"
],
"type": "string",
"description": "Ranking order for Top Ads. ctr surfaces proven click-drivers; like surfaces engagement winners.",
"default": "for_you"
},
"adLanguage": {
"title": "Ad language",
"type": "string",
"description": "Two-letter language code to filter ad creative language, e.g. en, es, de. Leave empty for all languages."
},
"fetchAdDetails": {
"title": "Fetch ad details",
"type": "boolean",
"description": "If enabled (recommended), the Actor calls the per-ad detail endpoint to add fields the list hides: comments, shares, landing page URL, target countries, objectives and keywords. If disabled, only the lighter list data is returned (faster, same price per ad).",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy to use for the requests. Apify RESIDENTIAL proxy is required in practice — TikTok blocks datacenter IPs aggressively."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```