# TikTok Shop Scraper (US) (`rastriq/tiktok-shop-scraper`) Actor

Product pages of TikTok Shop US: price, units sold, rating, SKUs and stock, shop, shipping and the embedded reviews. US only. Reviewer data hashed.

- **URL**: https://apify.com/rastriq/tiktok-shop-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Social media
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Shop Scraper (US): product prices, units sold, ratings and reviews

**TikTok Shop Scraper** extracts product data from TikTok Shop product pages (`shop.tiktok.com/us/pdp/...`): price, units sold, rating, review distribution, SKUs and stock, images, category, shop, shipping and the reviews embedded in the page. Paste product URLs or ids and get one clean row per product plus one row per review. No login, no cookies, no account.

> **US only.** TikTok Shop Scraper supports the US storefront (`/us`). Other markets are not served on the web by TikTok (Spain redirects to "not supported region") or were ruled out (UK showed a captcha on 2 of 2 pages even through a residential proxy). URLs from other markets are skipped and reported in the run summary.

### 🛍️ What is TikTok Shop Scraper?

TikTok Shop Scraper is a scraper and monitoring building block for TikTok Shop product pages. Typical uses: price and sales-velocity tracking for a list of products, competitor and category research, and review sampling. It reads the structured data that the public product page already contains, so it is fast (about one second per product) and light on traffic.

### 📊 What data does TikTok Shop Scraper extract?

| | Field | Description |
|---|---|---|
| 🆔 | `product_id` | Durable TikTok Shop product id |
| 🏷️ | `title`, `brand`, `category`, `category_path` | Name, brand (from the product's "Brand" specification, null when absent) and category hierarchy |
| 💵 | `price`, `currency`, `ext_price_min`, `ext_price_max` | Price of the default SKU and the price range (decimal numbers; `ext_price_max` equals `ext_price_min` when there is a single SKU) |
| 📈 | `ext_sold_count` | Units sold since listing |
| ⭐ | `rating`, `review_count`, `ext_rating_distribution` | Average rating, total reviews, reviews per star |
| 📦 | `ext_skus`, `in_stock` | Variants, price and stock per SKU |
| 🖼️ | `images` | Product image URLs |
| 🏪 | `seller_name`, `ext_seller_id`, `ext_shop_url`, `ext_seller_followers`, `ext_shop_label` | Public shop data (name, id, link and aggregates) |
| 🚚 | `ext_free_shipping`, `ext_shipping_fee`, `ext_delivery_min_days` | Shipping |
| 💬 | review rows | `review_id`, `rating`, `text`, `published_at`, `sku`, `author_hash`, `author_name` |

Every row carries `source_url`, `scraped_at` (UTC) and `_quality_*` flags. Flags mark problems instead of hiding rows: `_quality_delisted`, `_quality_antibot_suspected`, `_quality_missing_price`, and more.

**Not available** on the product page: original (struck-through) price and discount (the TikTok US product page JSON does not expose a list price, so `price_original` and `discount_pct` are always `null`), listing date, and more than 5 reviews per product. The page embeds 5 reviews; TikTok Shop Scraper returns those. Shop listings and search results are planned for v0.2.

### 🚀 How to use TikTok Shop Scraper

1. Open TikTok Shop Scraper in Apify Console.
2. Paste US product URLs (a slug in the path is fine) or numeric product ids.
3. Choose how many reviews per product you want (0 to 5) and whether to hide reviewer names.
4. Click **Start**. The default input scrapes one product in a few seconds.
5. Open the **Products** and **Reviews** views, or download the dataset as JSON, CSV or Excel. The run summary (`SUMMARY` record) lists status, counts, proxy usage and any item that could not be resolved.

### ⚙️ Input parameters

| Parameter | Description |
|---|---|
| `productUrls` | TikTok Shop US product URLs. Non-US URLs are skipped. |
| `productIds` | Numeric product ids, combined with the URLs. Duplicates removed. |
| `maxReviewsPerProduct` | 0 to 5 embedded reviews per product. Empty = 5. |
| `hideAuthorNames` | Replace reviewer names with `null` (the hash stays). |
| `maxResidentialMB` | Cap on residential proxy traffic per run, 0-50 MB (higher values are clamped to 50 with a warning). Empty = 20 MB. 0 = never. |
| `proxyConfiguration` | Optional own proxy (US exit IP). Used for every request; no residential fallback is added. |

### 📄 Output example

```json
{
  "record_type": "product",
  "product_id": "1732602336680710454",
  "market": "us",
  "title": "BASED Body Lotion | Dusk Scent | Advanced Hydration...",
  "price": 32.5,
  "currency": "USD",
  "rating": 4.8,
  "review_count": 201,
  "category": "Body Lotions & Creams",
  "seller_name": "BASED",
  "in_stock": true,
  "ext_sold_count": 2706,
  "ext_proxy_tier": "datacenter",
  "_quality_delisted": false,
  "source_url": "https://shop.tiktok.com/us/pdp/1732602336680710454",
  "scraped_at": "2026-11-09T13:20:11Z"
}
```

### 🌐 Proxy and cost: how TikTok Shop Scraper reaches the page

TikTok Shop Scraper starts every product on a **US datacenter proxy** with no account, no login session and no cookies kept between requests. If TikTok answers with a soft block (error `23004014`, "crawler traffic detected", or a security check page), the IP is rotated and the product is retried **once on the datacenter proxy**. Only if the block persists is it retried **once on a US residential proxy**, only for that product. Those two signals are the only triggers: a generic 403 or an empty page is marked in the run summary and the run continues. Residential traffic is capped by `maxResidentialMB` (hard maximum 50 MB, checked before each request), stops by itself when 60% or more of at least 5 residential attempts end delisted or failed, is never used for the whole run, and captchas are never solved. A product page is about 36-44 KB over the network (compressed), so residential costs roughly $0.27-0.35 per 1,000 products. Residential bytes are reported in the run summary (`ext_proxy_bytes_residential`). If you provide your own proxy, TikTok Shop Scraper uses it for everything and adds no residential fallback.

### 💰 How much does it cost to use TikTok Shop Scraper?

TikTok Shop Scraper uses pay-per-event pricing: a charge per product row and a smaller charge per review row (see the Monetization tab for the current prices). Products that TikTok no longer serves (delisted, or blocked after the fallback) are returned flagged and are **not charged**, even though they may have used residential traffic. Limits per run: up to 5,000 products, 1 request per second, 2 hours maximum; if the time runs out the run closes as `partial` with everything collected so far. Run 10 products first to estimate your costs.

### 🔒 Privacy & GDPR

- Reviewer ids are never output. Each review has `author_hash`, a keyed HMAC-SHA256 pseudonym that is stable across runs and cannot be reversed without the operator's secret.
- `author_name` is the display name TikTok already masks (for example `W**r`). Switch on **Hide reviewer names** to output `null` instead.
- Avatars, profile links and review photos are never output. Emails and phone numbers found in review text are replaced with placeholders.
- Seller data is limited to public information (shop name, id, link, rating, followers, product count). Specification fields that look like legal entity, manufacturer, importer, address or contact are dropped, and emails and phone numbers in descriptions and specifications are redacted.
- You are responsible for having a lawful basis to process the data you collect.

### ❓ FAQ

**Is it legal to scrape TikTok Shop?** TikTok Shop Scraper reads publicly visible product pages without logging in. Terms of use and local law still apply to how you use the data; check them for your case and respect robots.txt and rate limits.

**Why do I get fewer reviews than the product has?** The page embeds only 5. More reviews need a signed request that TikTok Shop Scraper does not make.

**Why is a product flagged `_quality_delisted`?** TikTok returned no product data. It can be a retired product or a block; the flag `_quality_antibot_suspected` tells you the server text mentioned anti-crawler. `ext_proxy_tier` shows which proxy served the row; `_quality_soft_block_unresolved` and `_quality_residential_cap_reached` tell you when the residential retry was not possible (cap reached, residential disabled or your own proxy).

**Can I scrape other countries?** No. The US storefront only.

**Related Rastriq actors:** Google Play Reviews Scraper and App Store Reviews Scraper use the same reviewer-privacy approach (`author_hash`, `hideAuthorNames`).

# Changelog

This Actor's version history is a separate document: https://apify.com/rastriq/tiktok-shop-scraper/changelog.md

# Actor input Schema

## `productUrls` (type: `array`):

TikTok Shop US product page URLs, e.g. <code>https://shop.tiktok.com/us/pdp/1732602336680710454</code> (a slug in the path is fine). One per line. Non-US URLs are skipped.

## `productIds` (type: `array`):

Numeric product ids (the number at the end of the product URL). One per line. Combined with the URLs above; duplicates are removed.

## `maxReviewsPerProduct` (type: `integer`):

Embedded reviews to output per product, 0-5 (the product page embeds at most 5). 0 = products only. If empty, 5.

## `hideAuthorNames` (type: `boolean`):

Replace reviewer names with null (author_hash is kept) to minimise personal data under GDPR.

## `maxResidentialMB` (type: `integer`):

Cap on residential proxy traffic per run, 0-50 MB (hard maximum 50; higher values are clamped with a warning). Residential is used only for a single product after a soft block (error 23004014 or security check) that persists on a second datacenter attempt, never for the whole run. It also stops by itself if most residential attempts end delisted or failed. 0 = never use residential. If empty, 20 MB (about 450 products). Ignored if you set your own proxy.

## `proxyConfiguration` (type: `object`):

Optional. If you set your own proxy it is used for every request and no residential fallback is added. Use a US exit IP. Leave empty to use the built-in US datacenter proxy.

## Actor input object example

```json
{
  "productUrls": [
    "https://shop.tiktok.com/us/pdp/1732602336680710454"
  ]
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `reviews` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "productUrls": [
        "https://shop.tiktok.com/us/pdp/1732602336680710454"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "productUrls": ["https://shop.tiktok.com/us/pdp/1732602336680710454"] }

# Run the Actor and wait for it to finish
run = client.actor("rastriq/tiktok-shop-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "productUrls": [
    "https://shop.tiktok.com/us/pdp/1732602336680710454"
  ]
}' |
apify call rastriq/tiktok-shop-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/tiktok-shop-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/RPMTaObagKYw53y4Y/builds/6gIE01qxflmyvbyo1/openapi.json
