# TikTok Username Profile Scraper (`kawsar/tiktok-username-profile-scraper`) Actor TikTok username lookup tool that retrieves public profile details, statistics, and account creation dates for free. - **URL**: https://apify.com/kawsar/tiktok-username-profile-scraper.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Social media, Developer tools, Lead generation - **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 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/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 Username Profile Scraper: Extract Comprehensive Public Profile Details and Metadata for Free TikTok Username Profile Scraper is a high-performance web scraping tool that helps you retrieve detailed public profile parameters, statistics, and metadata from TikTok usernames or profile URLs. By analyzing the embedded rehydration payloads of public pages, this tool extracts deep profile insights, including total followers, following count, total likes, video counts, verification status, biography text, profile links, and estimated account creation times. It requires zero API keys or paid credits to run. ### Use cases - **Influencer discovery**: find public usernames and extract their follower stats, bios, and external profile links to find the perfect creator partners. - **Lead enrichment**: enrich social media leads by pulling complete biography links, region codes, and user display names from usernames. - **OSINT investigations**: trace digital footprints and calculate precise account creation times from internal user ID snowflake structures. - **Profile tracking**: monitor account details, verification badges, and private or public status over time. ### Input The actor accepts the following input parameters: | Field | Type | Default | Description | |-------|------|---------|-------------| | `targets` | array | (Required) | A list of TikTok usernames (e.g. `nasa` or `@nasa`) or profile URLs to scrape. | | `maxItems` | integer | 100 | The maximum number of targets to process during a single run. | | `delaySecs` | integer | 2 | The delay in seconds between target lookups to prevent rate limiting. | | `proxyConfiguration` | object | Residential | Optional proxy settings. It is highly recommended to use Residential proxies to avoid anti-bot blocks. | #### Example input ```json { "targets": [ "nasa", "charlidamelio", "https://www.tiktok.com/@khaby.lame" ], "maxItems": 100, "delaySecs": 2, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output The actor stores results in a dataset. Each entry contains comprehensive public metadata of the TikTok account, including approximate creation time and snowflake ID estimates. #### Example output ```json { "queryInput": "nasa", "inputKind": "username", "isRegistered": true, "username": "nasa", "nickname": "NASA", "userId": "531868352220164096", "secUid": "MS4wLjABAAAA...Y7", "isVerified": true, "isPrivate": false, "profileBio": "Explore the universe and discover our home planet.", "bioUrl": "https://www.nasa.gov", "regionCode": "US", "avatarUrl": "https://p16-sign-va.tiktokcdn.com/...", "followerCount": 18500000, "followingCount": 12, "heartCount": 115000000, "videoCount": 240, "accountCreatedTime": "2014-06-25 04:30:11 UTC", "accountCreatedUnix": 1403670611, "snowflakeEstimateTime": "2014-06-25 04:30:11 UTC", "scrapedAt": "2026-06-17T12:00:00.000Z" } ``` #### Extracted fields description | Field | Type | Description | |-------|------|-------------| | `queryInput` | string | The original target input provided for the lookup (username or profile URL). | | `inputKind` | string | The classified type of the input, always set to "username". | | `isRegistered` | boolean | True if the TikTok account exists, false if it does not exist (404). | | `username` | string | The resolved TikTok unique username handle. | | `nickname` | string | The display name of the TikTok user profile. | | `userId` | string | The unique numerical internal user ID assigned by TikTok. | | `secUid` | string | TikTok security UID used for public API operations. | | `isVerified` | boolean | Whether the account has been verified by TikTok (blue badge). | | `isPrivate` | boolean | Whether the account is marked private. | | `profileBio` | string | The text signature or biography written on the user's profile. | | `bioUrl` | string | The external website link present in the profile biography. | | `regionCode` | string | The registered region or country code of the TikTok user. | | `avatarUrl` | string | URL to the user's profile picture avatar. | | `followerCount` | integer | The total number of followers this account has. | | `followingCount` | integer | The total number of accounts this user follows. | | `heartCount` | integer | The total number of video likes (hearts) received by this user. | | `videoCount` | integer | The total number of public videos published by this user. | | `accountCreatedTime` | string | The formatted date and time when the TikTok account was created (UTC). | | `accountCreatedUnix` | integer | The raw Unix timestamp (in seconds) of account creation. | | `snowflakeEstimateTime` | string | An estimated account creation date calculated from the numerical User ID snowflake structure. | | `scrapedAt` | string | The UTC timestamp when this target was processed by the Actor. | ### FAQ **Is a paid API key required to use this scraper?** No, this actor is completely free to use. It relies entirely on public profile structures, requiring no third-party subscription or registration. **Can I run this actor without proxies?** Yes, but TikTok has strict bot detection and IP rate limiting. While a few requests will work from default servers, we highly recommend using residential proxies for larger lists of targets. **What is the difference between accountCreatedTime and snowflakeEstimateTime?** The `accountCreatedTime` is the official registration date extracted directly from the profile metadata payload. The `snowflakeEstimateTime` is parsed using TikTok's internal User ID snowflake structure. Both provide extreme precision and serve as verification for each other. ### Integrations Connect TikTok Username Profile Scraper with other apps and services using [Apify integrations](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and many more. You can also use [webhooks](https://docs.apify.com/integrations/webhooks) to trigger actions whenever results are available. # Actor input Schema ## `targets` (type: `array`): Enter the list of TikTok usernames or profile URLs to scan. Enter one target per line (e.g. 'nasa' or 'https://www.tiktok.com/@nasa'). ## `maxItems` (type: `integer`): The maximum number of targets to process. Protects against excessive run times. ## `delaySecs` (type: `integer`): How long to wait between processing each target to prevent rate limits and blockages. ## `proxyConfiguration` (type: `object`): Select proxies to use for requests. It is highly recommended to use Residential proxies to avoid getting blocked by TikTok's anti-bot system. ## Actor input object example ```json { "targets": [ "nasa", "charlidamelio", "https://www.tiktok.com/@khaby.lame" ], "maxItems": 100, "delaySecs": 2, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "targets": [ "nasa", "charlidamelio", "khaby.lame" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/tiktok-username-profile-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 = { "targets": [ "nasa", "charlidamelio", "khaby.lame", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("kawsar/tiktok-username-profile-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 '{ "targets": [ "nasa", "charlidamelio", "khaby.lame" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call kawsar/tiktok-username-profile-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/tiktok-username-profile-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Username Profile Scraper", "description": "TikTok username lookup tool that retrieves public profile details, statistics, and account creation dates for free.", "version": "0.0", "x-build-id": "FeyOqbh19d5RqZbWO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~tiktok-username-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-tiktok-username-profile-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/kawsar~tiktok-username-profile-scraper/runs": { "post": { "operationId": "runs-sync-kawsar-tiktok-username-profile-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/kawsar~tiktok-username-profile-scraper/run-sync": { "post": { "operationId": "run-sync-kawsar-tiktok-username-profile-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", "required": [ "targets" ], "properties": { "targets": { "title": "Usernames or URLs to look up", "type": "array", "description": "Enter the list of TikTok usernames or profile URLs to scan. Enter one target per line (e.g. 'nasa' or 'https://www.tiktok.com/@nasa').", "items": { "type": "string" } }, "maxItems": { "title": "Maximum items to process", "minimum": 1, "type": "integer", "description": "The maximum number of targets to process. Protects against excessive run times.", "default": 100 }, "delaySecs": { "title": "Delay between lookups (seconds)", "minimum": 1, "type": "integer", "description": "How long to wait between processing each target to prevent rate limits and blockages.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to use for requests. It is highly recommended to use Residential proxies to avoid getting blocked by TikTok's anti-bot system." } } }, "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 } } } } } } } } } } ```