# TikTok Shop Scraper - Products, Sales, Sellers & Reviews (`scrapesage/tiktok-shop-scraper`) Actor Scrape TikTok Shop products, prices, units sold, SKUs, stock levels, reviews and full seller profiles - no login required. Includes rating histograms, spec tables, category paths, seller business details and related-product discovery. Export CSV/JSON. Pay per result, no start fee. - **URL**: https://apify.com/scrapesage/tiktok-shop-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** E-commerce, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 product scrapeds 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 Shop Scraper — Products, Sales, Sellers & Reviews Scrape **TikTok Shop** product data, sales volume, SKUs, stock levels, shipping costs, customer reviews, affiliate videos and full seller profiles — **no login, no cookies, no browser**. Point it at a product or shop link and get a deep, structured record back as JSON or CSV. Built for dropshippers hunting winning products, brands tracking competitors, agencies sizing niches, and anyone who needs TikTok Shop data that is actually *complete*. --- ### Why this one Most TikTok Shop scrapers hand you a title, a price and a photo. This one returns **65 fields per product** — the SKU table with per-variant stock levels, the 1–5 star rating histogram, real shipping cost and delivery windows, the specification table, the affiliate videos promoting the product with their play counts, and the seller's legally published business name and address. | | Typical TikTok Shop actor | **This actor** | |---|---|---| | Product fields | ~10 | **65** | | Per-SKU stock quantity | ✗ | ✓ | | Rating histogram (1–5★) | ✗ | ✓ | | Shipping fee + delivery days | ✗ | ✓ | | Specification table | ✗ | ✓ | | Affiliate videos + play counts | sold separately | ✓ included | | Seller business name + address | ✗ | ✓ | | Reviews with photos & verified flag | sometimes | ✓ | | Units sold + estimated revenue | sometimes | ✓ | | Related-product discovery | ✗ | ✓ | | Price per product | $0.01 – $0.025 | **$0.003** | **One mode, one record type.** Every mode returns a single consistent record shape, so your CSV has no empty columns — reviews, affiliate videos and seller details are nested inside the product record rather than scattered across mismatched rows. --- ### What you can scrape | Mode | Returns | |---|---| | **Product details** | One rich row per product — reviews, affiliate videos and seller details nested in | | **Shop catalog** | Every product of a seller (add *Full detail* for the complete record on each) | | **Product reviews** | One row per review | | **Sellers & leads** | One row per shop — performance metrics, business name and address, lead score | | **Discover** | Expands through TikTok's own related / best-selling / you-may-like rails to surface new products | Supported regions: US, GB, ID, MY, TH, VN, PH, SG, DE, FR, IT, ES, IE, JP, MX, BR. --- ### Input ```json { "mode": "product", "productUrls": ["https://shop.tiktok.com/us/pdp/1729527313880355335"], "region": "US", "maxItems": 50 } ```` | Field | What it does | |---|---| | `mode` | `product`, `shop`, `reviews`, `sellers` or `discover` | | `productUrls` | Product links or bare product IDs | | `shopUrls` | Store links or bare seller IDs | | `region` | Marketplace to read prices/availability from | | `maxItems` | Record cap (`0` = no cap; the run still ends safely before its timeout) | | `fullDetail` | In shop/discover, open each product's page so every row is a complete record | | `includeReviews` | Nest reviews inside the product record | | `includeAffiliateVideos` | Nest the videos promoting the product | | `resolveExactPrice` | Recover the exact headline price (on by default) | A bare product ID such as `1729527313880355335` works anywhere a URL does. *** ### Output #### Product detail — 65 fields ```json { "productId": "1729527313880355335", "title": "Goli Ashwagandha & Vitamin D Gummy - Mixed Berry, KSM-66, Vegan...", "price": 14.98, "originalPrice": 19, "discountPercent": 21, "savingAmount": 4.02, "currency": "USD", "rating": 4.5, "reviewCount": 94375, "soldCount": 1295301, "estimatedRevenue": 19403608.98, "ratingHistogram": { "1": 5822, "2": 1532, "3": 3743, "4": 7809, "5": 75469 }, "ratingBreakdownPercent": { "1": 6.2, "2": 1.6, "3": 4, "4": 8.3, "5": 80 }, "categoryPath": "Health > Nutrition & Wellness > Vitamins, Minerals & Wellness Supplements", "skus": [ { "skuId": "1729527298861535751", "properties": "Size: 1 Bottle", "availableQuantity": 358287, "packageWeightG": 431, "packageLength": 8, "packageWidth": 8, "packageHeight": 13 } ], "totalStock": 358287, "inStock": true, "specifications": [{ "name": "Product Form", "value": "Gummy" }], "badges": ["Free shipping"], "freeShipping": true, "shippingFee": 7.95, "buyerShippingCost": 0, "deliveryMinDays": 6, "deliveryMaxDays": 9, "logisticsProvider": "LSV-TTS-US-SendBySeller-Std", "seoKeywords": ["Goli Ashwagandha gummies", "vegan vitamin D gummies"], "affiliateVideoCount": 9, "totalAffiliateVideoPlays": 61722172, "topAffiliateVideoPlays": 18455632, "affiliateVideos": [ { "videoId": "7397839934461136158", "url": "https://www.tiktok.com/@bestrunupss/video/7397839934461136158", "playCount": 18455632, "likeCount": 1722717, "authorName": "bestrunupss", "earnsCommission": true } ], "reviews": [{ "rating": 5, "text": "...", "isVerifiedPurchase": true }], "shopName": "Goli Nutrition", "shopRating": 4.6, "shopFollowersCount": 587272, "isOfficialShop": true, "businessName": "Goli Nutrition Inc.", "businessAddress": "8430 Santa Monica Blvd, West Hollywood, California, 90069, USA" } ``` #### Seller / lead ```json { "sellerId": "7495794203056835079", "shopName": "Goli Nutrition", "shopRating": 4.6, "soldCount": 5608157, "productCount": 56, "followersCount": 587272, "videoCount": 3780, "productScorePercent": 99, "shippingScorePercent": 98, "serviceScorePercent": 97, "identityLabel": "OFFICIAL SHOP", "businessName": "Goli Nutrition Inc.", "businessAddress": "8430 Santa Monica Blvd, West Hollywood, California, 90069, USA", "leadScore": 88 } ``` Four ready-made dataset views — **Overview**, **Product detail**, **Reviews** and **Sellers & leads**. *** ### Pricing Pay only for what you get. **No start fee.** | Event | Price | |---|---| | Product scraped | **$0.003** | | Product detail scraped | $0.006 | | Review scraped | $0.001 | | Shop / seller lead scraped | $0.008 | *** ### Use cases - **Winning-product research** — rank a category by units sold and estimated revenue, with real stock levels and shipping cost before you commit. - **Competitor monitoring** — track a rival shop's catalog, price changes and sold-count growth on a schedule. - **Affiliate & influencer research** — see which creators are promoting a product, their play counts, and whether they earn commission. - **Price & margin modelling** — per-SKU pricing, package weight and dimensions, shipping fee and delivery windows. - **Review mining** — reviews with photos and verified-purchase flags to find unmet needs and quality complaints. - **Supplier & seller lead-gen** — outreach lists of TikTok Shop sellers with published business name and address and a 0–100 lead score. - **Listing SEO** — the keywords TikTok itself associates with a top-performing listing. *** ### Notes - Reads only **publicly available** TikTok Shop pages. No login, no cookies and no account are required, and nothing behind a sign-in is touched. - TikTok does not expose keyword search or category browsing to automated clients. **`discover` mode is the supported way to find new products** — it walks TikTok's own related / best-selling / you-may-like rails outward from a product or shop you already have. - Runs end successfully with a status message even if the source is temporarily unavailable, and self-terminate safely before hitting a timeout — so a scheduled run never fails silently. ### Use with AI assistants (MCP) This Actor works as a tool for AI assistants through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — ask Claude, Cursor or any MCP-capable agent to pull TikTok Shop product, review or seller data and it can call this Actor directly. ### Agent-ready: autonomous payments (x402 & Skyfire) This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards: - **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key. - **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows. Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes. # Actor input Schema ## `mode` (type: `string`): product = one rich row per product (reviews, affiliate videos and seller details nested in). shop = a seller's catalog. reviews = one row per review. sellers = seller lead records. discover = expand through TikTok's related / best-selling / you-may-like rails to find new products. ## `productUrls` (type: `array`): TikTok Shop product links, e.g. https://shop.tiktok.com/us/pdp// — a bare product ID also works. Used by product, reviews, sellers and discover modes. ## `shopUrls` (type: `array`): TikTok Shop store links, e.g. https://shop.tiktok.com/us/store// — a bare seller ID also works. Used by shop, sellers and discover modes. ## `region` (type: `string`): Marketplace to read prices and availability from. ## `maxItems` (type: `integer`): Stop after this many records. Set 0 for no cap — the run still self-terminates safely before its timeout. ## `fullDetail` (type: `boolean`): In shop and discover modes, open each product's own page so every row is a complete product record (specs, SKUs with stock, reviews, affiliate videos) instead of a catalog listing. Much richer, but one request per product so runs take longer. ## `includeReviews` (type: `boolean`): Nest the customer reviews shown on each product page (rating, text, photos, verified-purchase flag) inside the product record. Use 'reviews' mode instead if you want one row per review. ## `includeAffiliateVideos` (type: `boolean`): Nest the TikTok videos promoting each product — creator name, play and like counts, and whether the creator earns commission. Useful for affiliate and influencer research. ## `resolveExactPrice` (type: `boolean`): TikTok hides the headline price on a product page from automated clients. When enabled, the exact current and original price are recovered from the seller's own catalog listing. Leave on unless you want the fastest possible run. ## `proxyConfiguration` (type: `object`): Optional. This Actor reads TikTok Shop's server-rendered pages directly and normally needs no proxy at all; a proxy is only used as a fallback if the datacenter IP gets rate-limited. ## Actor input object example ```json { "mode": "product", "productUrls": [ "https://shop.tiktok.com/us/pdp/1729527313880355335" ], "shopUrls": [ "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079" ], "region": "US", "maxItems": 50, "fullDetail": false, "includeReviews": true, "includeAffiliateVideos": true, "resolveExactPrice": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): All scraped TikTok Shop records (products, product details, reviews, shops) as JSON items in the default dataset. # 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": "product", "productUrls": [ "https://shop.tiktok.com/us/pdp/1729527313880355335" ], "shopUrls": [ "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079" ], "region": "US", "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/tiktok-shop-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": "product", "productUrls": ["https://shop.tiktok.com/us/pdp/1729527313880355335"], "shopUrls": ["https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079"], "region": "US", "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/tiktok-shop-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": "product", "productUrls": [ "https://shop.tiktok.com/us/pdp/1729527313880355335" ], "shopUrls": [ "https://shop.tiktok.com/us/store/goli-nutrition/7495794203056835079" ], "region": "US", "maxItems": 50 }' | apify call scrapesage/tiktok-shop-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/tiktok-shop-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Shop Scraper - Products, Sales, Sellers & Reviews", "description": "Scrape TikTok Shop products, prices, units sold, SKUs, stock levels, reviews and full seller profiles - no login required. Includes rating histograms, spec tables, category paths, seller business details and related-product discovery. Export CSV/JSON. Pay per result, no start fee.", "version": "0.1", "x-build-id": "9tNtf9yidO5svD3Q9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~tiktok-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-tiktok-shop-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/scrapesage~tiktok-shop-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-tiktok-shop-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/scrapesage~tiktok-shop-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-tiktok-shop-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": "What to scrape", "enum": [ "product", "shop", "reviews", "sellers", "discover" ], "type": "string", "description": "product = one rich row per product (reviews, affiliate videos and seller details nested in). shop = a seller's catalog. reviews = one row per review. sellers = seller lead records. discover = expand through TikTok's related / best-selling / you-may-like rails to find new products.", "default": "product" }, "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "TikTok Shop product links, e.g. https://shop.tiktok.com/us/pdp// — a bare product ID also works. Used by product, reviews, sellers and discover modes.", "items": { "type": "string" } }, "shopUrls": { "title": "Shop URLs or seller IDs", "type": "array", "description": "TikTok Shop store links, e.g. https://shop.tiktok.com/us/store// — a bare seller ID also works. Used by shop, sellers and discover modes.", "items": { "type": "string" } }, "region": { "title": "TikTok Shop region", "enum": [ "US", "GB", "ID", "MY", "TH", "VN", "PH", "SG", "DE", "FR", "IT", "ES", "IE", "JP", "MX", "BR" ], "type": "string", "description": "Marketplace to read prices and availability from.", "default": "US" }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many records. Set 0 for no cap — the run still self-terminates safely before its timeout.", "default": 50 }, "fullDetail": { "title": "Full detail for every product", "type": "boolean", "description": "In shop and discover modes, open each product's own page so every row is a complete product record (specs, SKUs with stock, reviews, affiliate videos) instead of a catalog listing. Much richer, but one request per product so runs take longer.", "default": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Nest the customer reviews shown on each product page (rating, text, photos, verified-purchase flag) inside the product record. Use 'reviews' mode instead if you want one row per review.", "default": true }, "includeAffiliateVideos": { "title": "Include affiliate videos", "type": "boolean", "description": "Nest the TikTok videos promoting each product — creator name, play and like counts, and whether the creator earns commission. Useful for affiliate and influencer research.", "default": true }, "resolveExactPrice": { "title": "Resolve exact price", "type": "boolean", "description": "TikTok hides the headline price on a product page from automated clients. When enabled, the exact current and original price are recovered from the seller's own catalog listing. Leave on unless you want the fastest possible run.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. This Actor reads TikTok Shop's server-rendered pages directly and normally needs no proxy at all; a proxy is only used as a fallback if the datacenter IP gets rate-limited.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```