# TikTok Creative Center Scraper (`automation-lab/tiktok-creative-center-scraper`) Actor Extract public TikTok Creative Center hashtag trends with ranks, categories, posts and views for marketing research. - **URL**: https://apify.com/automation-lab/tiktok-creative-center-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/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 Extract public TikTok Creative Center hashtag trends for marketing research, creative planning, and campaign inspiration. TikTok Creative Center is one of the fastest ways to see what is currently gaining attention on TikTok. This actor opens the public Creative Center trends page, reads the visible hashtag ranking table, and saves clean rows to an Apify dataset. It is designed for marketers who need a lightweight, repeatable source of public trend signals without manually copying values from the browser. > Current MVP scope: public hashtag trend rows that TikTok shows without login. The actor does not use private ads-account data, login cookies, bearer tokens, or authenticated APIs. ### What does TikTok Creative Center Scraper do? - ✅ Opens TikTok Creative Center in a real browser - ✅ Reads the public hashtag trends ranking - ✅ Extracts rank, hashtag, category, country, posts, views, source URL, and timestamp - ✅ Converts compact metrics such as `123.4K` or `33.8M` into numeric fields - ✅ Saves results to the default Apify dataset - ✅ Runs with a small prefilled input for cheap first tests - ✅ Avoids account-only Creative Center features ### Who is it for? This actor is useful for teams that watch TikTok trends as part of a recurring marketing workflow. - 🎯 **Performance marketers** can capture fresh Creative Center trend ideas before preparing ad hooks. - 🧠 **Creative strategists** can collect public hashtag signals for brainstorming sessions. - 📈 **Social media managers** can monitor category-level TikTok trend movement in a structured dataset. - 🛍️ **Ecommerce teams** can spot cultural moments that may influence product videos and creator briefs. - 🏢 **Agencies** can export repeatable trend snapshots for client research decks. - 🧪 **Growth teams** can combine trend rows with content calendars or campaign experiments. ### Why use this actor? Manual trend research is slow and hard to reproduce. A screenshot of Creative Center is useful once, but a dataset is easier to filter, join, archive, and compare over time. Use this actor when you want: - A structured TikTok trend snapshot - Repeatable trend collection inside Apify - Clean numeric post and view counts - Dataset export to CSV, JSON, Excel, Google Sheets, or an API client - A simple public-data collector instead of a login-based ad account workflow ### Current public-data limitation TikTok currently shows only a small public sample on the hashtag trends page before prompting users to log in for more details. This actor intentionally respects that boundary. That means: - The default run collects the public rows visible without login. - `maxItems` can be higher than the number of public rows, but TikTok may still expose only a few rows. - The actor does not bypass login prompts. - The actor does not scrape private ad-account dashboards. - The actor does not ask for your TikTok credentials. ### Data you can extract | Field | Description | | --- | --- | | `mode` | Collection mode, currently `trends` | | `rank` | Trend rank from the Creative Center table | | `name` | Hashtag name, including `#` | | `trendType` | Entity type, currently `hashtag` | | `category` | Public category shown by TikTok | | `country` | Market label used for the page | | `postsText` | Original compact posts value | | `posts` | Numeric posts value | | `viewsText` | Original compact views value | | `views` | Numeric views value | | `analyticsUrl` | Public Creative Center detail URL pattern | | `sourceUrl` | Source page scraped | | `scrapedAt` | ISO timestamp for the run | ### How much does it cost to scrape TikTok Creative Center trends? This actor uses pay-per-event pricing. There is a small `$0.005` start event and a per-result event for each saved trend row. Formula-derived per-row prices by Apify plan tier: | Tier | Price per trend row | | --- | ---: | | FREE | `$0.0031043` | | BRONZE | `$0.0026994` | | SILVER | `$0.0021055` | | GOLD | `$0.0016196` | | PLATINUM | `$0.0010798` | | DIAMOND | `$0.00075583` | Typical small runs are designed to be inexpensive because TikTok exposes only a limited public sample before login. ### Input options | Input | Type | Default | Description | | --- | --- | --- | --- | | `mode` | string | `trends` | Public Creative Center dataset to collect | | `countries` | string array | `United States of America` | Creative Center market labels to try | | `maxItems` | integer | `3` | Maximum rows to save | | `proxyConfiguration` | object | no proxy | Optional Apify proxy settings | ### Example input ```json { "mode": "trends", "countries": ["United States of America"], "maxItems": 3, "proxyConfiguration": { "useApifyProxy": false } } ```` ### Example output ```json { "mode": "trends", "rank": 1, "name": "#marvelrivalscyclops", "trendType": "hashtag", "category": "Games", "country": "United States of America", "postsText": "123.4K", "posts": 123400, "viewsText": "33.8M", "views": 33800000, "analyticsUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/marvelrivalscyclops", "sourceUrl": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag", "scrapedAt": "2026-06-17T02:20:44.584Z" } ``` ### How to run the actor 1. Open the actor page on Apify. 2. Keep the default `trends` mode. 3. Select one or more Creative Center market labels. 4. Keep `maxItems` small for the first run. 5. Run the actor. 6. Open the dataset tab. 7. Export the rows to CSV, JSON, Excel, or your preferred integration. ### Tips for best results - Start with the default country to verify the current public page layout. - Keep `maxItems` low because TikTok limits public rows before login. - Schedule small recurring runs if you want a trend archive over time. - Use numeric `posts` and `views` fields for sorting and dashboards. - If a run returns no rows, retry later or enable a datacenter proxy; TikTok pages can change or rate-limit browser traffic. ### Integrations You can connect the output dataset to common Apify workflows: - 📊 Send rows to Google Sheets for a weekly trend tracker. - 🧾 Export CSV for client reporting. - 🔁 Trigger a webhook after each run to update a marketing dashboard. - 🧠 Feed trend rows into an LLM workflow for creative hook ideation. - 📦 Store daily snapshots in your own database through the Apify API. ### API usage with Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/tiktok-creative-center-scraper').call({ mode: 'trends', countries: ['United States of America'], maxItems: 3, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage with Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/tiktok-creative-center-scraper').call(run_input={ 'mode': 'trends', 'countries': ['United States of America'], 'maxItems': 3, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage with cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~tiktok-creative-center-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "mode": "trends", "countries": ["United States of America"], "maxItems": 3 }' ``` ### MCP usage Use the Apify MCP server with this actor in Claude Desktop, Claude Code, or another MCP-compatible client. MCP URL: ```text https://mcp.apify.com/?tools=automation-lab/tiktok-creative-center-scraper ``` Claude Code setup: ```bash claude mcp add apify-tiktok-creative-center https://mcp.apify.com/?tools=automation-lab/tiktok-creative-center-scraper ``` Claude Desktop JSON config example: ```json { "mcpServers": { "apify-tiktok-creative-center": { "url": "https://mcp.apify.com/?tools=automation-lab/tiktok-creative-center-scraper" } } } ``` Example prompts: - "Run TikTok Creative Center Scraper for the United States and summarize the visible hashtag trends." - "Export the latest Creative Center trend rows and rank them by views." - "Compare today's TikTok Creative Center trend snapshot with yesterday's dataset." ### Scheduling ideas A recurring run can create a lightweight history of public Creative Center snapshots. Useful schedules: - Daily morning trend scan - Monday campaign-planning snapshot - Weekly client reporting export - Pre-launch creative inspiration check ### Troubleshooting #### Why did I get only a few rows? TikTok currently exposes only a small public sample before the page asks users to log in. This actor scrapes only public rows and will not bypass that prompt. #### Why did the actor return zero rows? The Creative Center page may have changed, loaded slowly, or blocked the browser session. Try a smaller input, retry later, or enable an Apify datacenter proxy. #### Can I scrape private TikTok ad account data? No. This actor is intentionally limited to public Creative Center data visible without authentication. ### FAQ #### Does this actor require a TikTok login? No. It only reads public Creative Center rows visible without authentication. #### Does this actor collect top ads? Not in the MVP. Top Ads workflows often expose richer ad metadata behind different public pages or login prompts, so the first version focuses on public hashtag trends. #### Why are some countries saved as United States of America? If TikTok does not expose a requested country label in the selector, the actor logs a warning and saves the currently selected public market instead of failing the whole run. ### Legality This actor extracts public web data shown by TikTok Creative Center without requiring credentials. You are responsible for using the output in a lawful way and for respecting TikTok's terms, privacy rules, and applicable regulations. Do not use this actor to collect personal data, bypass access controls, or automate private account areas. ### Related scrapers Other automation-lab actors that may fit nearby workflows: - [TikTok Search Scraper](https://apify.com/automation-lab/tiktok-search-scraper) - [TikTok Hashtag Scraper](https://apify.com/automation-lab/tiktok-hashtag-scraper) - [Instagram Profile Scraper](https://apify.com/automation-lab/instagram-profile-scraper) - [Google Ads Transparency Scraper](https://apify.com/automation-lab/google-ads-transparency-scraper) ### Changelog #### 0.1 - Initial public hashtag trends extractor. - Browser rendering for the TikTok Creative Center public page. - Numeric conversion for posts and views. ### Development notes This actor is built with TypeScript, Apify SDK, and Playwright. It uses a browser because the Creative Center page is rendered by client-side JavaScript. Images, media, and fonts are blocked during extraction to reduce bandwidth. ### Support If the output looks wrong, share the run ID and the country input you used. Creative Center changes can affect selectors and public row availability, so reproducible run details help diagnose issues quickly. # Actor input Schema ## `mode` (type: `string`): Public Creative Center dataset to scrape. The MVP supports hashtag trends visible without login. ## `countries` (type: `array`): Creative Center market labels to try. Use the exact label shown by TikTok, for example United States of America. TikTok currently exposes a small public sample per market before login. ## `maxItems` (type: `integer`): Maximum number of public trend rows to save across all selected markets. ## `proxyConfiguration` (type: `object`): Optional proxy settings. Start without proxy; enable Apify datacenter proxy if TikTok rate-limits your environment. ## Actor input object example ```json { "mode": "trends", "countries": [ "United States of America" ], "maxItems": 3, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "trends", "countries": [ "United States of America" ], "maxItems": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "trends", "countries": ["United States of America"], "maxItems": 3, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/tiktok-creative-center-scraper").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 '{ "mode": "trends", "countries": [ "United States of America" ], "maxItems": 3 }' | apify call automation-lab/tiktok-creative-center-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/tiktok-creative-center-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Creative Center Scraper", "description": "Extract public TikTok Creative Center hashtag trends with ranks, categories, posts and views for marketing research.", "version": "0.1", "x-build-id": "bcykaLwP5khaRvAyu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~tiktok-creative-center-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-tiktok-creative-center-scraper", "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/automation-lab~tiktok-creative-center-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-tiktok-creative-center-scraper", "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/automation-lab~tiktok-creative-center-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-tiktok-creative-center-scraper", "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": "Mode", "enum": [ "trends" ], "type": "string", "description": "Public Creative Center dataset to scrape. The MVP supports hashtag trends visible without login.", "default": "trends" }, "countries": { "title": "Countries / markets", "type": "array", "description": "Creative Center market labels to try. Use the exact label shown by TikTok, for example United States of America. TikTok currently exposes a small public sample per market before login.", "default": [ "United States of America" ], "items": { "type": "string" } }, "maxItems": { "title": "Maximum trend rows", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of public trend rows to save across all selected markets.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Start without proxy; enable Apify datacenter proxy if TikTok rate-limits your environment.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```