# πŸ›οΈ TikTok Shop Data Scraper (`api-empire/tiktok-shop-data-scraper`) Actor πŸ›οΈ TikTok Shop Data Scraper (tiktok-shop-data-scraper) extracts product, pricing, and seller details from TikTok Shop fast. πŸ“ˆ Great for market research, competitor tracking, and lead generation. ⚑ Automate insightsβ€”no manual scraping! - **URL**: https://apify.com/api-empire/tiktok-shop-data-scraper.md - **Developed by:** [API Empire](https://apify.com/api-empire) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Shop Data Scraper Extract **TikTok Shop** product data at scale β€” prices, discounts, ratings, reviews, seller info, sold counts, and the **top affiliate creators** promoting each product. Search by keyword, browse a category, pull an entire seller's store, or target individual product pages. The essential **TikTok Shop scraper** for e-commerce sellers, dropshippers, affiliate marketers, and market researchers. --- ### ✨ Why Choose This Actor? - πŸ”€ **4 input modes in one** β€” keyword search, category, seller store, and direct product URLs (auto-detected). - πŸ‘₯ **Creator intelligence** β€” see which affiliate creators drive each product and their video/play/like stats. - πŸ’Ύ **Live results** β€” every product is saved the instant it's collected, so a long run is never lost. - 🌐 **Self-healing proxy ladder** β€” starts direct, then escalates to Datacenter β†’ sticky US Residential automatically. - πŸ“Š **Clean, organized output** β€” three ready-made views: Products, Top Creators, and Reviews. - 🧱 **Stable & resilient** β€” retries with backoff, soft-fail (anti-bot) detection, and graceful partial results. --- ### πŸš€ Key Features | Feature | Description | |--------|-------------| | πŸ” Keyword search | Search the whole TikTok Shop catalog by one or more keywords | | πŸ—‚οΈ Category scraping | Paste a `/c/` category link to browse that category | | πŸͺ Seller store scraping | Paste a `/store/` link to pull a seller's full catalog | | πŸ›’ Product URLs | Paste `/pdp/` links to grab specific products | | πŸ“ Reviews | Optionally fetch product reviews (reviewer, rating, SKU, country, images) | | πŸ‘₯ Top creators | Aggregated affiliate creator stats per product | | πŸ“Š Sort by sold count | Surface best-sellers first (or least-sold first) | --- ### πŸ“₯ Input | Field | Type | Description | |-------|------|-------------| | `searchKeywords` | array | Keywords to search (e.g. `["shoes"]`) | | `urls` | array | TikTok Shop product / category / seller URLs | | `maxProducts` | integer | Max products per source (20–1000) | | `includeReviews` | boolean | Fetch reviews (default `false`) | | `maxReviews` | integer | Max reviews per product (1–100) | | `sortBySoldCount` | string | `none` / `highest_first` / `lowest_first` | | `proxyConfiguration` | object | Proxy settings β€” see below | | `maxRetries` | integer | Retry attempts per request (1–10) | | `requestDelay` | integer | Delay between requests in ms (0–2000) | | `maxConcurrency` | integer | Concurrent requests (1–20) | | `timeout` | integer | Per-request timeout in seconds (10–300) | #### Example input ```json { "searchKeywords": ["shoes"], "urls": [], "maxProducts": 20, "includeReviews": true, "maxReviews": 10, "sortBySoldCount": "highest_first", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` *** ### πŸ“€ Output Each product is one dataset record: ```json { "product_id": "1732119583850205647", "title": "Women's Low-Top Sports Shoes ...", "url": "https://shop.tiktok.com/us/pdp/1732119583850205647", "price": 36.27, "price_formatted": "36.27", "currency": "USD", "original_price": 43.69, "discount": "17%", "rating": 4.7, "review_count": 207, "seller_id": "8652615273335460303", "seller_name": "Juyu Footwear", "image_url": "https://...webp", "sold_count": 2743, "is_sold_out": true, "creator_count": 16, "has_creator_data": true, "total_creator_videos": 20, "top_creators": [ { "nickname": "Vincent", "video_count": 2, "total_plays": 336691, "total_likes": 1275, "is_affiliate": true } ], "reviews_fetched": 3, "reviews_accessible": true, "reviews": [ { "review_id": "...", "rating": 5, "text": "...", "reviewer_name": "A**a S**t", "review_time": 1780350129, "is_verified_purchase": true, "sku_specification": "Black, EU41", "country": "US", "images": ["https://..."] } ], "scraped_at": "2026-06-17T16:44:25.875921", "source": "product_page" } ``` The dataset offers three views in the Console: **πŸ›’ Products**, **πŸ‘₯ Top Creators**, and **πŸ“ Reviews**. *** ### 🌐 Proxy & Region Notes TikTok Shop only returns real data to **US exit IPs**. This actor handles that automatically: 1. 🌐 **Direct** connection is tried first. 2. πŸ›‘οΈ If blocked, it escalates to a **Datacenter (US)** proxy. 3. 🏠 If still blocked, it escalates to a **Residential (US)** proxy with a sticky session and retries β€” and stays there for the rest of the run. For the most reliable results, select **Residential** proxies (US) in the proxy configuration. *** ### πŸš€ How to Use (Apify Console) 1. Log in at β†’ **Actors**. 2. Open **TikTok Shop Data Scraper**. 3. Add a keyword (e.g. `shoes`) and/or TikTok Shop URLs. 4. (Optional) Enable **Residential** proxy for best reliability. 5. Click **Start** and watch the live logs. 6. Open the **Output** tab and export to JSON / CSV / XLSX. ### πŸ€– Use via API ```bash curl -X POST "https://api.apify.com/v2/acts//run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchKeywords":["shoes"],"maxProducts":20,"includeReviews":true}' ``` *** ### πŸ’‘ Best Use Cases - πŸ›’ Product & price research for dropshipping - πŸ“ˆ Tracking best-selling products and trends - πŸ‘₯ Finding affiliate creators to partner with - ⭐ Monitoring reviews and ratings - πŸͺ Auditing a competitor's seller store *** ### πŸ’³ Pricing This actor uses the **pay-per-event** model. You are charged once per product successfully collected β€” billed via the `row_result` event on each pushed item (plus standard platform usage). The exact event price is shown on the Actor's Store page. *** ### ❓ FAQ **Why are some products missing reviews?** TikTok Shop only exposes reviews for some products via the public web surface. The actor returns the reliably-accessible reviews and flags `reviews_accessible`. **Why is `is_sold_out` always true?** The desktop web storefront is view-only (purchases happen in-app), so products report as not purchasable from the web β€” this mirrors the source data. **I got few/no results.** Enable **Residential (US)** proxies β€” TikTok Shop is region-locked to the US. *** ### πŸ›Ÿ Support & Feedback Found an issue or want a new field? Open an issue on the Actor's **Issues** tab. We read every report. *** > βš–οΈ Only public data is collected. You are responsible for compliance with applicable laws (GDPR/CCPA), TikTok's Terms of Service, and local regulations. # Actor input Schema ## `searchKeywords` (type: `array`): Keywords to search TikTok Shop for (e.g. 'shoes', 'phone case', 'skincare'). Each keyword runs its own search. ## `urls` (type: `array`): Paste TikTok Shop URLs to scrape β€” the type is auto-detected: πŸ›’ Product (/pdp/), πŸ—‚οΈ Category (/c/), or πŸͺ Seller/Store (/store/). Examples: https://shop.tiktok.com/us/pdp/123, https://shop.tiktok.com/us/c/electronics/456, https://shop.tiktok.com/us/store/seller/789 ## `maxProducts` (type: `integer`): Maximum number of products to fetch per search keyword / category / seller (20–1000). ## `includeReviews` (type: `boolean`): Fetch product reviews too. Note: not every product exposes accessible reviews. ## `maxReviews` (type: `integer`): Maximum number of reviews to fetch per product (1–100). ## `sortBySoldCount` (type: `string`): Order products by units sold. 'πŸ”₯ Highest first' surfaces best-sellers; '🌱 Lowest first' surfaces fewer-sold items. ## `proxyConfiguration` (type: `object`): By default the scraper connects directly (no proxy) and automatically escalates to a πŸ›‘οΈ Datacenter proxy and then a 🏠 Residential (US) proxy if TikTok Shop blocks the request. For the most reliable results, select Residential proxies in the US. ## `maxRetries` (type: `integer`): Maximum retry attempts per request before giving up (1–10). ## `requestDelay` (type: `integer`): Delay between requests in milliseconds. Lower = faster, but may trigger rate limits (0–2000). ## `maxConcurrency` (type: `integer`): Maximum concurrent requests. Higher = faster but uses more resources (1–20). ## `timeout` (type: `integer`): Per-request timeout in seconds. Increase if using slow proxies (10–300). ## Actor input object example ```json { "searchKeywords": [ "shoes" ], "maxProducts": 10, "includeReviews": false, "maxReviews": 10, "sortBySoldCount": "none", "proxyConfiguration": { "useApifyProxy": false }, "maxRetries": 5, "requestDelay": 0, "maxConcurrency": 20, "timeout": 60 } ``` # 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 = { "searchKeywords": [ "shoes" ] }; // Run the Actor and wait for it to finish const run = await client.actor("api-empire/tiktok-shop-data-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 = { "searchKeywords": ["shoes"] } # Run the Actor and wait for it to finish run = client.actor("api-empire/tiktok-shop-data-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 '{ "searchKeywords": [ "shoes" ] }' | apify call api-empire/tiktok-shop-data-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=api-empire/tiktok-shop-data-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "πŸ›οΈ TikTok Shop Data Scraper", "description": "πŸ›οΈ TikTok Shop Data Scraper (tiktok-shop-data-scraper) extracts product, pricing, and seller details from TikTok Shop fast. πŸ“ˆ Great for market research, competitor tracking, and lead generation. ⚑ Automate insightsβ€”no manual scraping!", "version": "0.1", "x-build-id": "KeYqpgC9D0fENifyg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~tiktok-shop-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-tiktok-shop-data-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/api-empire~tiktok-shop-data-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-tiktok-shop-data-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/api-empire~tiktok-shop-data-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-tiktok-shop-data-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": { "searchKeywords": { "title": "πŸ” Search Keywords", "type": "array", "description": "Keywords to search TikTok Shop for (e.g. 'shoes', 'phone case', 'skincare'). Each keyword runs its own search.", "items": { "type": "string" } }, "urls": { "title": "πŸ”— TikTok Shop URLs", "type": "array", "description": "Paste TikTok Shop URLs to scrape β€” the type is auto-detected: πŸ›’ Product (/pdp/), πŸ—‚οΈ Category (/c/), or πŸͺ Seller/Store (/store/). Examples: https://shop.tiktok.com/us/pdp/123, https://shop.tiktok.com/us/c/electronics/456, https://shop.tiktok.com/us/store/seller/789", "items": { "type": "string", "pattern": "^https://shop\\.tiktok\\.com/.*" } }, "maxProducts": { "title": "πŸ“¦ Maximum Products", "minimum": 10, "maximum": 100000, "type": "integer", "description": "Maximum number of products to fetch per search keyword / category / seller (20–1000).", "default": 10 }, "includeReviews": { "title": "πŸ“ Include Reviews", "type": "boolean", "description": "Fetch product reviews too. Note: not every product exposes accessible reviews.", "default": false }, "maxReviews": { "title": "πŸ’¬ Maximum Reviews", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of reviews to fetch per product (1–100).", "default": 10 }, "sortBySoldCount": { "title": "πŸ“Š Sort by Sold Count", "enum": [ "none", "highest_first", "lowest_first" ], "type": "string", "description": "Order products by units sold. 'πŸ”₯ Highest first' surfaces best-sellers; '🌱 Lowest first' surfaces fewer-sold items.", "default": "none" }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "By default the scraper connects directly (no proxy) and automatically escalates to a πŸ›‘οΈ Datacenter proxy and then a 🏠 Residential (US) proxy if TikTok Shop blocks the request. For the most reliable results, select Residential proxies in the US.", "default": { "useApifyProxy": false } }, "maxRetries": { "title": "πŸ” Max Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retry attempts per request before giving up (1–10).", "default": 5 }, "requestDelay": { "title": "⏱️ Request Delay (ms)", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Delay between requests in milliseconds. Lower = faster, but may trigger rate limits (0–2000).", "default": 0 }, "maxConcurrency": { "title": "⚑ Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum concurrent requests. Higher = faster but uses more resources (1–20).", "default": 20 }, "timeout": { "title": "βŒ› Request Timeout (s)", "minimum": 10, "maximum": 300, "type": "integer", "description": "Per-request timeout in seconds. Increase if using slow proxies (10–300).", "default": 60 } } }, "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 } } } } } } } } } } ```