# TikTok Shop Product Details Scraper (`scrapers_lat/tiktok-shop-product-scraper`) Actor
Scrape TikTok Shop product detail data by product ID for France and other markets. Get title, price, discount, images, seller, rating, reviews, sold count, stock and variants. Export JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/tiktok-shop-product-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 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
[](https://console.apify.com/actors/aLe4zUqlyxtqHegz1/input)
## TikTok Shop Product Details Scraper
> Extract full product detail data from TikTok Shop by product ID, with France (EUR) as the default market and support for the UK, US, Germany, Spain, Italy and more.
25+ fields per product
13 markets FR default
JSON / CSV / Excel output formats
Updated 2026-07-03
### What you get
Give it one or more TikTok Shop product IDs and a marketplace region, and each record returns the full product detail page: pricing, discount, seller, rating, reviews, stock and every variant. Prices and currency come from the marketplace you select (France returns EUR).
- **imageUrl**: main product image
- **title**: product name
- **region**: marketplace the price and stock were read from (for example FR)
- **url**: canonical product page URL
- **productId**: TikTok Shop product ID
- **currency**: currency code of the price (EUR, GBP, USD, ...)
- **currencySymbol**: currency symbol shown on the page
- **price**: current selling price
- **originalPrice**: price before discount
- **discount**: discount label, for example 40%
- **soldCount**: total units sold
- **rating**: average product review score
- **reviewCount**: number of product reviews
- **shopName**: seller or shop name
- **shopId**: seller ID
- **shopUrl**: link to the seller store on TikTok Shop
- **shopRating**: overall shop rating
- **shopSoldCount**: total units the shop has sold
- **shopFollowers**: shop follower count
- **inStock**: whether the product is buyable
- **availableQuantity**: units available across all variants
- **category**: full category path as text
- **categoryPath**: category path as an array
- **description**: product description text
- **specifications**: product attributes as name and value pairs
- **options**: variant option axes (for example Color, Size) with their values
- **variants**: every SKU with its own price, specification and stock
- **mainVideo**: product video URL when the listing has one
- **images**: full image gallery
- **observedAt**: when the scraper read this product
### Who is it for
| Use case | Who benefits |
|---|---|
| Track TikTok Shop France prices and discounts | Ecommerce sellers and dropshippers |
| Monitor competitor products and stock | Brands and category managers |
| Enrich product catalogs with seller and rating data | Marketplaces and aggregators |
| Build product research and winning-product tools | Analysts and agencies |
| Watch a seller store across markets | Affiliate and creator teams |
### Frequently Asked Questions
**Which TikTok Shop markets are supported?**
France is the default and the priority market, and the region input also covers the United Kingdom, United States, Germany, Spain, Italy, Ireland, Indonesia, Thailand, Vietnam, Malaysia, the Philippines and Singapore. Prices and currency are read from the marketplace you pick.
**Where do I find the product ID?**
It is the long numeric ID in a TikTok Shop product URL, such as the number in tiktok.com/view/product/1729480569078716908 or in a shop.tiktok.com product link. You can paste either the raw ID or the full product URL, the ID is detected automatically.
**Why do I need a residential proxy?**
TikTok Shop is geo aware and blocks datacenter traffic, so the actor routes each request through a residential IP in the marketplace country. The default proxy is Apify residential in France. Keep the proxy country aligned with the region you scrape.
**Does the price match what shoppers see in that country?**
Yes. Each product belongs to a specific marketplace, and the actor returns the price, currency and stock for the region you select, so a France run returns EUR pricing and French availability.
**What happens if a product is unavailable or blocked?**
Products that are delisted or not sold in the chosen market return a record with an error note instead of fake data. Transient network blocks are retried automatically across fresh residential exits.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Medicube Skincare Products (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/medicube-skincare-products-us): Scrape Medicube skincare products from TikTok Shop US: price, discount, rating, reviews, seller, stock and variants for beauty market research.
- [Collagen Skincare Sets (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/collagen-skincare-sets-us): Scrape collagen skincare and beauty sets from TikTok Shop US with price, discount, rating, reviews, seller and variant data for beauty research.
- [Magnesium Supplements (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/magnesium-supplements-us): Scrape magnesium supplement listings from TikTok Shop US: price, discount, sold count, rating, reviews, seller and stock for wellness research.
- [ACV Gut Health Gummies (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/acv-gut-health-gummies-us): Scrape apple cider vinegar and gut health gummy supplements from TikTok Shop US with price, sold count, rating, reviews and seller details.
- [Collagen Peptides Powder (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/collagen-peptides-powder-us): Scrape collagen peptides powder supplements from TikTok Shop US: price, discount, sold count, rating, reviews, seller and stock for wellness research.
- [Graphic Tees Apparel (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/graphic-tees-apparel-us): Scrape graphic t-shirt and apparel listings from TikTok Shop US with price, discount, sold count, rating, reviews, seller and variant data.
- [Cooling Fans Home (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/cooling-fans-home-us): Scrape cooling and pedestal fan listings from TikTok Shop US: price, discount, sold count, rating, reviews, seller and stock for home goods research.
- [Bedding and Comforters (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/bedding-comforters-home-us): Scrape bedding and comforter listings from TikTok Shop US with price, discount, sold count, rating, reviews, seller and variant data for home research.
- [Cordless Pressure Washers (TikTok Shop US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/cordless-pressure-washers-us): Scrape cordless pressure washer and cleaning gadget listings from TikTok Shop US: price, discount, sold count, rating, reviews and seller details.
- [TikTok Shop Bestsellers (US)](https://apify.com/scrapers_lat/tiktok-shop-product-scraper/examples/tiktok-shop-bestsellers-us): Scrape top selling TikTok Shop US products across beauty, supplements and home: price, discount, sold count, rating, reviews, seller and stock.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [TikTok Creative Center Top Ads Scraper](https://apify.com/scrapers_lat/tiktok-creative-center-scraper): top performing TikTok ads, hashtags and trends
- [eBay Product Listings & Price Scraper](https://apify.com/scrapers_lat/ebay-scraper): eBay product listings, prices and sellers
- [MercadoLibre Product & Price Scraper](https://apify.com/scrapers_lat/mercadolibre-scraper): product prices and sellers across Latin America
- [Americanas Brazil Product Price & Seller Scraper](https://apify.com/scrapers_lat/americanas-scraper): Brazil marketplace products, prices and sellers
- [Falabella Product Price & Stock Scraper](https://apify.com/scrapers_lat/falabella-scraper): Falabella products, prices and stock in CL, PE and CO
- [Quince Product Prices & Reviews Scraper](https://apify.com/scrapers_lat/quince-scraper): Quince product prices, variants and reviews
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with TikTok Shop. It only accesses data that is publicly available on the platform. Use it in accordance with TikTok Shop's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of products to collect. Optional.
## `productIds` (type: `array`):
One or more TikTok Shop product IDs. This is the long numeric ID in a product page URL such as tiktok.com/view/product/1729480569078716908 or shop.tiktok.com/.../pdp/.../1729480569078716908. You can paste the full product URL too, the ID is extracted automatically.
## `region` (type: `string`):
TikTok Shop marketplace to read prices and availability from. France (FR) is the default. Prices and currency come from the product's home marketplace.
## `proxyConfiguration` (type: `object`):
TikTok Shop is geo-aware and rate limits datacenter traffic. A residential proxy in the marketplace country is required. Leave the default to use Apify residential proxies in France.
## Actor input object example
```json
{
"maxItems": 10,
"productIds": [
"1729480569078716908"
],
"region": "FR",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}
````
# Actor output Schema
## `results` (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 = {
"maxItems": 10,
"productIds": [
"1729480569078716908"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/tiktok-shop-product-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 = {
"maxItems": 10,
"productIds": ["1729480569078716908"],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/tiktok-shop-product-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 '{
"maxItems": 10,
"productIds": [
"1729480569078716908"
]
}' |
apify call scrapers_lat/tiktok-shop-product-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/tiktok-shop-product-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "TikTok Shop Product Details Scraper",
"description": "Scrape TikTok Shop product detail data by product ID for France and other markets. Get title, price, discount, images, seller, rating, reviews, sold count, stock and variants. Export JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "7T2EDhzKDqMG3rGaz"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~tiktok-shop-product-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-tiktok-shop-product-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/scrapers_lat~tiktok-shop-product-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-tiktok-shop-product-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/scrapers_lat~tiktok-shop-product-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-tiktok-shop-product-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": [
"productIds"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of products to collect. Optional."
},
"productIds": {
"title": "Product IDs",
"type": "array",
"description": "One or more TikTok Shop product IDs. This is the long numeric ID in a product page URL such as tiktok.com/view/product/1729480569078716908 or shop.tiktok.com/.../pdp/.../1729480569078716908. You can paste the full product URL too, the ID is extracted automatically.",
"items": {
"type": "string"
}
},
"region": {
"title": "Marketplace region",
"enum": [
"FR",
"GB",
"US",
"DE",
"ES",
"IT",
"IE",
"ID",
"TH",
"VN",
"MY",
"PH",
"SG"
],
"type": "string",
"description": "TikTok Shop marketplace to read prices and availability from. France (FR) is the default. Prices and currency come from the product's home marketplace.",
"default": "FR"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "TikTok Shop is geo-aware and rate limits datacenter traffic. A residential proxy in the marketplace country is required. Leave the default to use Apify residential proxies in France.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
],
"apifyProxyCountry": "FR"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```