# TikTok Scraper — Videos, Profiles & Hashtags | from $3/1K (`bovi/tiktok-scraper`) Actor Scrape TikTok profiles, videos, hashtag feeds, keyword search, comments, and TikTok Shop products without login. Residential proxy built-in — TikTok blocks datacenter IPs, most competitors fail silently. Probe-first stop-gate: zero charges if your run can't reach TikTok. - **URL**: https://apify.com/bovi/tiktok-scraper.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Social media, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.91 / 1,000 profile items 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/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 Scraper — Profiles, Videos, Hashtags, Search & Comments Scrape TikTok at scale without a login. Six modes cover the full TikTok data surface: user profiles, video feeds, hashtag trending, keyword search, video comments, and TikTok Shop products. Residential proxy is built in — TikTok blocks datacenter IPs at the edge, so competitors that skip this fail in production. Pay per result. --- ### Why this actor beats the incumbents | What breaks most TikTok actors | How this actor handles it | |---|---| | Datacenter IP blocks | Forces Apify RESIDENTIAL proxy; CORE probe validates on startup | | Signer rot (X-Bogus re-obfuscated every 2–4 weeks) | Graceful degradation: CORE modes keep working when signer breaks; actor logs exact advice | | Cold-start failures silently producing empty datasets | Probe-first stop-gate: actor aborts with actionable error before wasting your compute | | DOM class-name scraping that breaks on every redesign | Rehydration JSON extraction (structural, not CSS-based) for CORE modes | | No geo-validation | Cloud run on residential IP validates real-world reachability (TikTok geo-blocks certain countries) | --- ### 6 modes #### CORE modes — no request signing, most stable | Mode | Input field | What you get | |---|---|---| | `profile` | `usernames` | Follower/following/like/video counts, bio, verified flag, avatar | | `product` | `productIds` | TikTok Shop PDP: title, price range, rating, sold count, images | | `user_videos` | `usernames` | First page of a user's videos from rehydration JSON; full pagination if signer is healthy | CORE modes parse TikTok's **server-side rehydration JSON** embedded in the page HTML. No X-Bogus signature required. These modes remain functional even when the signer breaks. #### SIGNED modes — require X-Bogus signature | Mode | Input field | What you get | |---|---|---| | `hashtag` | `hashtags` | Videos trending under a hashtag, ranked by TikTok's feed | | `search` | `keywords` | Keyword search results with ranking position | | `comments` | `videoIds` | Comments on a specific video, including reply thread info | SIGNED modes call TikTok's internal API endpoints and require a valid X-Bogus HMAC signature. TikTok re-obfuscates the signing algorithm every **2–4 weeks**. > **Signer maintenance note:** When TikTok rotates the algorithm, SIGNED modes will return a `signed_probe_failed` error. CORE modes continue working. See `src/signer.py` for the refresh procedure. The actor's probe-first gate tells you exactly which modes are affected before any records are charged. --- ### Output fields #### Profile record (`mode=profile`) | Field | Description | |---|---| | `user_id` | TikTok internal user ID | | `sec_uid` | Encrypted user identifier (used for API pagination) | | `username` | Handle (e.g. `charlidamelio`) | | `nickname` | Display name | | `verified` | Blue-check verified account | | `follower_count` | Follower count | | `following_count` | Following count | | `heart_count` | Total likes received across all videos | | `video_count` | Public video count | | `bio` | Profile bio text | | `region` | Account region code | | `profile_url` | `https://www.tiktok.com/@{username}` | | `avatar_url` | Avatar image URL | #### Video record (`mode=user_videos`) | Field | Description | |---|---| | `video_id` | TikTok video ID | | `author_username` | Uploader handle | | `description` | Video caption (may include hashtags inline) | | `hashtags` | Extracted hashtag list | | `duration` | Duration in seconds | | `play_count` | View count | | `like_count` | Like count | | `comment_count` | Comment count | | `share_count` | Share count | | `collect_count` | Save/bookmark count | | `created_at` | ISO-8601 UTC post time | | `video_url` | `https://www.tiktok.com/@{author}/video/{id}` | | `thumbnail_url` | Cover image URL | | `music_title` | Background music title | | `music_author` | Background music artist | | `is_ad` | True if TikTok marked it as an ad | #### Comment record (`mode=comments`) | Field | Description | |---|---| | `comment_id` | Comment ID | | `video_id` | Parent video ID | | `author_username` | Commenter handle | | `text` | Comment text | | `like_count` | Comment likes | | `reply_count` | Replies to this comment | | `is_reply` | True if this is a reply to another comment | | `parent_comment_id` | ID of parent comment (replies only) | | `created_at` | ISO-8601 UTC post time | #### TikTok Shop product record (`mode=product`) | Field | Description | |---|---| | `product_id` | TikTok Shop product ID | | `shop_id` | Seller shop ID | | `title` | Product title | | `description` | Product description | | `category` | Product category | | `brand` | Brand name | | `price_min` | Lowest SKU price (USD float) | | `price_max` | Highest SKU price (USD float) | | `currency` | Price currency code (default: USD) | | `discount_pct` | Discount percentage, if active | | `rating` | Seller rating (0–5) | | `review_count` | Number of reviews | | `sold_count` | Units sold count | | `image_urls` | List of product image URLs | | `product_url` | `https://www.tiktok.com/shop/pdp/{id}` | #### Search / hashtag result record (`mode=search` or `mode=hashtag`) Same video fields as above, plus: | Field | Description | |---|---| | `query` | The search keyword or hashtag that produced this result | | `rank` | 1-based position in the result set | --- ### All records include | Field | Description | |---|---| | `parse_confidence` | 0.0–1.0 parse quality score. 1.0 = all required fields found | | `warnings` | List of warning codes (empty = clean record) | | `scraped_at` | ISO-8601 UTC timestamp of the scrape run | --- ### How to use #### Scrape a user profile ```json { "mode": "profile", "usernames": ["charlidamelio", "khaby.lame"], "maxResults": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` #### Scrape a user's recent videos ```json { "mode": "user_videos", "usernames": ["mrbeast"], "maxResults": 50 } ``` #### Search TikTok by keyword ```json { "mode": "search", "keywords": ["viral recipe", "skincare routine"], "maxResults": 100 } ``` #### Scrape a hashtag feed ```json { "mode": "hashtag", "hashtags": ["fyp", "foodtok"], "maxResults": 200 } ``` #### Scrape video comments ```json { "mode": "comments", "videoIds": ["7123456789012345678"], "maxResults": 500 } ``` #### Scrape a TikTok Shop product ```json { "mode": "product", "productIds": ["1729386234567890"], "maxResults": 10 } ``` *** ### Pricing **Pay-per-result** (PPE) — you pay only for records successfully pushed to the dataset. Failed lookups, probe requests, and skipped items are never charged. PPE event: `tiktok-result` *** ### Reliability and proxy TikTok performs aggressive geo-filtering and bot detection. Key facts: - **Datacenter IPs are blocked instantly.** The actor defaults to `RESIDENTIAL` proxy and runs a connectivity probe before scraping anything. - **Cloud geo-blocks are real.** Some Apify cloud regions are blocked by TikTok. The startup CORE probe validates that your run's residential IP can actually reach TikTok — if it can't, the actor exits with a clear error and zero charges. - **Signer rot.** TikTok re-obfuscates the X-Bogus signing algorithm every 2–4 weeks. When this happens, SIGNED modes (`hashtag`, `search`, `comments`) return a `signed_probe_failed` error. CORE modes (`profile`, `product`, `user_videos` first page) continue working with no intervention. Monitor actor logs for `SIGNED probe: FAIL` to know when a signer update is needed. *** *Not affiliated with TikTok or ByteDance. Data is retrieved from publicly accessible TikTok endpoints.* ### Integrations Built for social-media analysts and content-intelligence teams pulling TikTok profiles, video feeds, hashtags, and comments at scale — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). # Actor input Schema ## `mode` (type: `string`): Scraping mode. product=TikTok Shop PDP (no signing). profile=user profile info (no signing). user\_videos=a user's video feed (first page no signing; full pagination requires signer). hashtag=videos under a hashtag (requires signer). search=keyword search results (requires signer). comments=video comments (requires signer). ## `usernames` (type: `array`): TikTok usernames to scrape. Used by modes: profile, user\_videos. Include or omit the leading '@' — both are accepted (e.g. 'charlidamelio' or '@charlidamelio'). ## `productIds` (type: `array`): TikTok Shop product IDs or full product URLs. Used by mode: product. Accepts bare IDs (e.g. '1729386234567890') or full URLs (e.g. 'https://www.tiktok.com/shop/pdp/1729386234567890'). ## `videoIds` (type: `array`): TikTok video IDs to fetch comments for. Used by mode: comments. Accepts bare numeric IDs (e.g. '7123456789012345678'). ## `keywords` (type: `array`): Keywords or phrases to search on TikTok. Used by mode: search. Each keyword runs as a separate search and returns up to maxResults videos. ## `hashtags` (type: `array`): Hashtags to scrape videos from. Used by mode: hashtag. Include or omit the leading '#' — both are accepted (e.g. 'fyp' or '#fyp'). ## `maxResults` (type: `integer`): Maximum total records to push to the dataset across all inputs. 0 = no limit. Applies per run, not per username/keyword/hashtag. Default: 50. ## `proxyConfiguration` (type: `object`): Apify proxy settings. RESIDENTIAL proxy is mandatory — TikTok instantly blocks datacenter IPs. Default uses Apify RESIDENTIAL group. Do not disable unless testing locally with your own residential proxy. ## Actor input object example ```json { "mode": "user_videos", "usernames": [ "charlidamelio", "khaby.lame" ], "productIds": [], "videoIds": [], "keywords": [], "hashtags": [], "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing Tiktok Scraper records (username, nickname, verified, follower\_count, following\_count, heart\_count, video\_count, bio, region, profile\_url, parse\_confidence, scraped\_at, author\_username, description, duration, play\_count, like\_count, comment\_count). # 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": "user_videos", "usernames": [ "charlidamelio", "khaby.lame" ], "productIds": [], "videoIds": [], "keywords": [], "hashtags": [], "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/tiktok-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": "user_videos", "usernames": [ "charlidamelio", "khaby.lame", ], "productIds": [], "videoIds": [], "keywords": [], "hashtags": [], "maxResults": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("bovi/tiktok-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": "user_videos", "usernames": [ "charlidamelio", "khaby.lame" ], "productIds": [], "videoIds": [], "keywords": [], "hashtags": [], "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call bovi/tiktok-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/tiktok-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Scraper — Videos, Profiles & Hashtags | from $3/1K", "description": "Scrape TikTok profiles, videos, hashtag feeds, keyword search, comments, and TikTok Shop products without login. Residential proxy built-in — TikTok blocks datacenter IPs, most competitors fail silently. Probe-first stop-gate: zero charges if your run can't reach TikTok.", "version": "0.1", "x-build-id": "uTtvitWgWSwvD47Ow" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~tiktok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-tiktok-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/bovi~tiktok-scraper/runs": { "post": { "operationId": "runs-sync-bovi-tiktok-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/bovi~tiktok-scraper/run-sync": { "post": { "operationId": "run-sync-bovi-tiktok-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "product", "profile", "user_videos", "hashtag", "search", "comments" ], "type": "string", "description": "Scraping mode. product=TikTok Shop PDP (no signing). profile=user profile info (no signing). user_videos=a user's video feed (first page no signing; full pagination requires signer). hashtag=videos under a hashtag (requires signer). search=keyword search results (requires signer). comments=video comments (requires signer)." }, "usernames": { "title": "Usernames", "type": "array", "description": "TikTok usernames to scrape. Used by modes: profile, user_videos. Include or omit the leading '@' — both are accepted (e.g. 'charlidamelio' or '@charlidamelio').", "items": { "type": "string" } }, "productIds": { "title": "Product IDs or URLs", "type": "array", "description": "TikTok Shop product IDs or full product URLs. Used by mode: product. Accepts bare IDs (e.g. '1729386234567890') or full URLs (e.g. 'https://www.tiktok.com/shop/pdp/1729386234567890').", "items": { "type": "string" } }, "videoIds": { "title": "Video IDs", "type": "array", "description": "TikTok video IDs to fetch comments for. Used by mode: comments. Accepts bare numeric IDs (e.g. '7123456789012345678').", "items": { "type": "string" } }, "keywords": { "title": "Search keywords", "type": "array", "description": "Keywords or phrases to search on TikTok. Used by mode: search. Each keyword runs as a separate search and returns up to maxResults videos.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to scrape videos from. Used by mode: hashtag. Include or omit the leading '#' — both are accepted (e.g. 'fyp' or '#fyp').", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum total records to push to the dataset across all inputs. 0 = no limit. Applies per run, not per username/keyword/hashtag. Default: 50." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. RESIDENTIAL proxy is mandatory — TikTok instantly blocks datacenter IPs. Default uses Apify RESIDENTIAL group. Do not disable unless testing locally with your own residential proxy." } } }, "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 } } } } } } } } } } ```