# TikTok Profile Scraper - Followers & Creator Data (`xtech/tiktok-profile-scraper-pro`) Actor 𝗘𝘅𝘁𝗿𝗮𝗰𝘁 𝗧𝗶𝗸𝗧𝗼𝗸 𝗽𝗿𝗼𝗳𝗶𝗹𝗲𝘀 from usernames or profile URLs. Export bios, verification, avatars, followers, following, total likes, and video counts. Create TikTok creator data for influencer research, campaign planning, audience analysis, lead lists, and database enrichment. - **URL**: https://apify.com/xtech/tiktok-profile-scraper-pro.md - **Developed by:** [Xtech](https://apify.com/xtech) (community) - **Categories:** Social media, Lead generation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.90 / 1,000 profile results 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Profile Scraper converts public TikTok handles or profile URLs into structured creator data. Export bios, verification, avatars, follower totals, following totals, likes, and video counts for influencer research, campaign planning, and database enrichment. Independent tool. Not affiliated with, endorsed by, or sponsored by TikTok. ### Scrape TikTok profiles in bulk Add up to 200 handles or profile URLs in one run. Handles work with or without the `@` symbol, and you can mix handles with full TikTok URLs. Duplicate inputs are removed. The optional concurrency setting controls how many profiles are collected at once. #### Starter presets ```json {"profiles":["@tiktok"],"maxConcurrency":1} {"profiles":["@tiktok","@instagram","@youtube"],"maxConcurrency":2} ```` Use a one-profile run first when validating a new handle list. Failed, unavailable, and duplicate inputs remain distinguishable from successful profile rows. ```json { "profiles": [ "@tiktok", "https://www.tiktok.com/@charlidamelio" ], "maxConcurrency": 3 } ``` ### TikTok profile data you can export Each successful row contains the username, display name, bio, verification status, avatar URL, canonical profile URL, follower count, following count, total likes, video count, and collection time. Results can be downloaded as JSON, CSV, or Excel or sent into your existing research and reporting workflows. ### Popular use cases - Enrich an existing list of TikTok creator handles. - Build influencer and partnership shortlists. - Compare creator audience sizes and publishing activity. - Refresh creator profiles for campaign planning. - Create structured creator datasets for analysis or reporting. ### Pricing Pricing is based on successful profile rows saved to the dataset when result-based pricing applies. Invalid, unavailable, or duplicate profiles do not create paid profile results. Check the Pricing tab for the current rate and use a maximum run spend to keep larger collections predictable. ### Limitations This Actor looks up profiles you already provide. It does not search TikTok by keyword, discover creators automatically, collect follower lists, or export individual videos and comments. Results depend on information TikTok exposes publicly at collection time. Private, removed, region-restricted, or unavailable profiles may return limited data or no successful row, and individual fields can be empty. ### Frequently asked questions #### Can I use usernames instead of full profile URLs? Yes. Use `creator`, `@creator`, or a full `tiktok.com/@creator` URL. #### How many TikTok profiles can I process? You can add up to 200 unique profiles per run. #### Does this Actor return a creator's videos? No. It returns profile-level statistics, including the published video count, but not individual video records. #### Can I refresh creator statistics automatically? Yes. Save the input as a task and schedule recurring runs to collect fresh profile rows over time. # Actor input Schema ## `profiles` (type: `array`): Add up to 200 unique TikTok handles such as @tiktok, or full profile URLs. Start with one handle to validate the output. ## `maxConcurrency` (type: `integer`): How many profiles to request at the same time. Use 1–3 for the most reliable runs on larger batches. ## Actor input object example ```json { "profiles": [ "@tiktok", "https://www.tiktok.com/@tiktok" ], "maxConcurrency": 3 } ``` # Actor output Schema ## `profiles` (type: `string`): No description ## `sourceResults` (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 = { "profiles": [ "@tiktok", "https://www.tiktok.com/@tiktok" ] }; // Run the Actor and wait for it to finish const run = await client.actor("xtech/tiktok-profile-scraper-pro").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 = { "profiles": [ "@tiktok", "https://www.tiktok.com/@tiktok", ] } # Run the Actor and wait for it to finish run = client.actor("xtech/tiktok-profile-scraper-pro").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 '{ "profiles": [ "@tiktok", "https://www.tiktok.com/@tiktok" ] }' | apify call xtech/tiktok-profile-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtech/tiktok-profile-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper - Followers & Creator Data", "description": "𝗘𝘅𝘁𝗿𝗮𝗰𝘁 𝗧𝗶𝗸𝗧𝗼𝗸 𝗽𝗿𝗼𝗳𝗶𝗹𝗲𝘀 from usernames or profile URLs. Export bios, verification, avatars, followers, following, total likes, and video counts. Create TikTok creator data for influencer research, campaign planning, audience analysis, lead lists, and database enrichment.", "version": "0.1", "x-build-id": "kOTfmc1ChIG6qE830" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtech~tiktok-profile-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtech-tiktok-profile-scraper-pro", "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/xtech~tiktok-profile-scraper-pro/runs": { "post": { "operationId": "runs-sync-xtech-tiktok-profile-scraper-pro", "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/xtech~tiktok-profile-scraper-pro/run-sync": { "post": { "operationId": "run-sync-xtech-tiktok-profile-scraper-pro", "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", "required": [ "profiles" ], "properties": { "profiles": { "title": "TikTok handles or profile URLs", "minItems": 1, "maxItems": 200, "uniqueItems": true, "type": "array", "description": "Add up to 200 unique TikTok handles such as @tiktok, or full profile URLs. Start with one handle to validate the output.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Maximum concurrent profiles", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many profiles to request at the same time. Use 1–3 for the most reliable runs on larger batches.", "default": 3 } } }, "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 } } } } } } } } } } ```