# TikTok Shop Scraper - Products, Prices, Sellers, Search (`convertfleetdotonline/tiktok-shop-scraper`) Actor
Scrape TikTok Shop product listings, prices, ratings, sellers, and search results across US, UK, Singapore, Malaysia, Philippines, Thailand, Vietnam, and Indonesia. No API key required.
- **URL**: https://apify.com/convertfleetdotonline/tiktok-shop-scraper.md
- **Developed by:** [Hasnain Nisar](https://apify.com/convertfleetdotonline) (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
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## 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 Shop Scraper
Extract **product listings, prices, ratings, sellers, and search results** from TikTok Shop โ no API key, no TikTok account, no cookies. Pick one of two operations, get one clean dataset per run.
Works across **8 marketplaces**: ๐บ๐ธ US ยท ๐ฌ๐ง UK ยท ๐ธ๐ฌ Singapore ยท ๐ฒ๐พ Malaysia ยท ๐ต๐ญ Philippines ยท ๐น๐ญ Thailand ยท ๐ป๐ณ Vietnam ยท ๐ฎ๐ฉ Indonesia.
### What it does
| Operation | Input | What you get |
|---|---|---|
| **Search Products** | keyword + region | Up to ~30 products per page (max 3 pages) with prices, ratings, sold counts, and seller names โ deduplicated across pages |
| **Product Detail** | product ID + region | One deep record: full description, SKU variants, image gallery, seller profile, discount data |
### Use cases
- **Price monitoring** โ track competitor pricing and discount campaigns per region
- **Product research** โ find best-selling products in a niche before sourcing
- **Seller intelligence** โ see who sells what, their ratings and follower counts
- **Catalog enrichment** โ pull clean product data (images, variants, descriptions) by ID
### Input
#### Search Products
```json
{
"operation": "searchProducts",
"keyword": "phone case",
"region": "US",
"maxPages": 2
}
````
#### Product Detail
```json
{
"operation": "productDetail",
"productId": "1731743608991158724",
"region": "US"
}
```
`productId` also accepts a full product URL โ the ID is extracted automatically. For non-English regions, native-language keywords (e.g. Thai for TH, Vietnamese for VN) return better results.
### Output
Each product is one dataset row. Example (trimmed):
```json
{
"_operation": "searchProducts",
"_sourceKeyword": "phone case",
"_sourceRegion": "US",
"productId": "1731743608991158724",
"productTitle": "Shockproof Clear Phone Case for iPhone 15",
"productUrl": "https://www.tiktok.com/view/product/1731743608991158724?region=US",
"coverUrl": "https://p16-oec-va.ibyteimg.com/...",
"price": 6.99,
"originalPrice": 15.99,
"currency": "USD",
"currencySymbol": "$",
"discountRate": 0.56,
"rating": 4.7,
"ratingCount": 1284,
"soldCount": 12000,
"sellerName": "GadgetHaus",
"sellerId": "7495003220734937336",
"status": "success"
}
```
Product Detail rows add `productDescription`, `gallery`, `skus` (variant id / name / price / stock), `skuCount`, seller stats (`sellerRating`, `sellerSoldCount`, `sellerFollowersCount`, `sellerProductsCount`), and compliance fields (`businessName`, `businessAddress`) where TikTok publishes them.
Product IDs are always returned as **strings**, so 19-digit IDs never lose precision in spreadsheets or JSON pipelines.
### Regions, currencies, formats
| Region | Marketplace | Currency |
|---|---|---|
| `US` | United States | USD |
| `GB` | United Kingdom | GBP |
| `SG` | Singapore | SGD |
| `MY` | Malaysia | MYR |
| `PH` | Philippines | PHP |
| `TH` | Thailand | THB |
| `VN` | Vietnam | VND |
| `ID` | Indonesia | IDR |
Prices are normalized to plain numbers in the local currency (including `25.000 โซ` โ `25000` style formats). Sold counts like `12.3K` or `1,2 rb` are normalized to integers.
**Important:** TikTok decides the serving marketplace from the request IP. Runs without a proxy are served from US infrastructure, so they return **US catalog results** regardless of the `region` setting (the run log warns when this happens, and each row's `currency` always tells you the true marketplace). To get real UK/SEA results, set **Advanced โ Proxy configuration** to a proxy located in the target country โ the scraper then uses the right URLs, locale, and currency for that region automatically.
### Tips
- **Blocked rows** โ TikTok occasionally serves a security check. The run reports `status: "blocked"` instead of failing. Re-run, or set a proxy under **Advanced โ Proxy configuration** (residential proxies work best).
- **Pagination** โ the scraper stops early when a page returns no new products, so you're never charged for empty pages.
- **Region matters** โ a product ID from the US catalog usually won't resolve in TH. Use the same region the product was found in.
### FAQ
**Is this legal?** The actor only reads publicly available product pages โ the same data any visitor sees without logging in. No login, no private data, no TikTok account is used. Still, you're responsible for how you use the data; respect TikTok's terms and local regulations.
**Why fewer results than the TikTok app?** The app personalizes results and mixes in live/video commerce. This scraper reads the public web catalog, which is a stable, reproducible subset.
**Can I scrape a whole store?** Not yet โ currently keyword search and product detail. Open an issue if you need store-level listing.
# Actor input Schema
## `operation` (type: `string`):
What to scrape. Search Products discovers products by keyword. Product Detail deep-scrapes a single product by its ID.
## `keyword` (type: `string`):
Keyword to search TikTok Shop for. Required for the Search Products operation. Native-language keywords work best for non-English regions (e.g. Thai keywords for TH).
## `productId` (type: `string`):
TikTok Shop product ID (usually 18-19 digits), e.g. 1731743608991158724. A full product URL also works โ the ID is extracted automatically. Required for the Product Detail operation.
## `region` (type: `string`):
TikTok Shop marketplace to scrape.
## `maxPages` (type: `integer`):
How many search result pages to fetch (Search Products only). Roughly 30 products per page.
## `proxyConfiguration` (type: `object`):
Proxy to use for TikTok requests. Runs try a direct connection first and fall back to this proxy when TikTok blocks the request. Residential proxies work best if you have access to them.
## `debug` (type: `boolean`):
Store raw HTML of fetched pages into the run's key-value store for troubleshooting.
## Actor input object example
```json
{
"operation": "searchProducts",
"keyword": "phone case",
"region": "US",
"maxPages": 2,
"proxyConfiguration": {
"useApifyProxy": false
},
"debug": false
}
```
# 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 = {
"keyword": "phone case",
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("convertfleetdotonline/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 = {
"keyword": "phone case",
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("convertfleetdotonline/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 '{
"keyword": "phone case",
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call convertfleetdotonline/tiktok-shop-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=convertfleetdotonline/tiktok-shop-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "TikTok Shop Scraper - Products, Prices, Sellers, Search",
"description": "Scrape TikTok Shop product listings, prices, ratings, sellers, and search results across US, UK, Singapore, Malaysia, Philippines, Thailand, Vietnam, and Indonesia. No API key required.",
"version": "0.1",
"x-build-id": "NYhDq9NKngBPVt63O"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/convertfleetdotonline~tiktok-shop-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-convertfleetdotonline-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/convertfleetdotonline~tiktok-shop-scraper/runs": {
"post": {
"operationId": "runs-sync-convertfleetdotonline-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/convertfleetdotonline~tiktok-shop-scraper/run-sync": {
"post": {
"operationId": "run-sync-convertfleetdotonline-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",
"required": [
"operation",
"region"
],
"properties": {
"operation": {
"title": "Operation",
"enum": [
"searchProducts",
"productDetail"
],
"type": "string",
"description": "What to scrape. Search Products discovers products by keyword. Product Detail deep-scrapes a single product by its ID.",
"default": "searchProducts"
},
"keyword": {
"title": "Search keyword",
"type": "string",
"description": "Keyword to search TikTok Shop for. Required for the Search Products operation. Native-language keywords work best for non-English regions (e.g. Thai keywords for TH)."
},
"productId": {
"title": "Product ID",
"type": "string",
"description": "TikTok Shop product ID (usually 18-19 digits), e.g. 1731743608991158724. A full product URL also works โ the ID is extracted automatically. Required for the Product Detail operation."
},
"region": {
"title": "Region",
"enum": [
"US",
"GB",
"SG",
"MY",
"PH",
"TH",
"VN",
"ID"
],
"type": "string",
"description": "TikTok Shop marketplace to scrape.",
"default": "US"
},
"maxPages": {
"title": "Max search pages",
"minimum": 1,
"maximum": 3,
"type": "integer",
"description": "How many search result pages to fetch (Search Products only). Roughly 30 products per page.",
"default": 2
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy to use for TikTok requests. Runs try a direct connection first and fall back to this proxy when TikTok blocks the request. Residential proxies work best if you have access to them."
},
"debug": {
"title": "Debug mode",
"type": "boolean",
"description": "Store raw HTML of fetched pages into the run's key-value store for troubleshooting.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```