# TikTok Shop Product Scraper (`apimy/tiktok-shop-product-scraper`) Actor

Scrape TikTok Shop product pages by link, ID or product name: price, variants with stock, units sold, rating breakdown, description, images, shipping, shop stats. Typical run: a 1-product lookup in about 10 seconds. Example input: {"products": \["air fryer"]}. Product details, not shop analytics.

- **URL**: https://apify.com/apimy/tiktok-shop-product-scraper.md
- **Developed by:** [Nikita Iakovlev](https://apify.com/apimy) (community)
- **Categories:** E-commerce, Social media
- **Features:** Limited permissions
- **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$7.00 / 1,000 products

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/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

### What does TikTok Shop Product Scraper do?

**TikTok Shop Product Scraper** opens TikTok Shop product pages and returns one full row per product: **price and price range, every variant with its stock, units sold, estimated revenue, rating breakdown, description, specifications, all images, shipping, category path, latest reviews and shop stats**. Give it a product link, a product ID or just a product name. No login, no cookies.

- **Typical run:** a 1-product lookup in about 10 seconds (8–10 s in three runs on 19 November 2026).
- **Example input:** `{"products": ["air fryer"]}`
- Need a list of products for a keyword? Use [TikTok Shop Search Scraper](https://apify.com/apimy/tiktok-shop-search-scraper).

### What data can you get from a TikTok Shop product page?

| Field | Example | Notes |
|---|---|---|
| `title`, `productId`, `url` | | |
| `price`, `minPrice`, `maxPrice`, `currency` | `76.67`, `76.67`, `89.99`, `USD` | Cheapest variant now and the range |
| `originalPrice`, `discountPercent` | `116.99`, `34` | Empty when not discounted |
| `variants` | `[{"skuId": "…", "options": {"Color": "Black"}, "price": 59.72, "stock": 9998, "available": true}]` | One entry per variant |
| `variantCount`, `totalStock` | `4`, `29998` | |
| `soldCount`, `estimatedRevenue` | `15356`, `1177345` | Units sold since listing; `price × soldCount` |
| `sold7d`, `sold30d`, `revenue7d`, `revenue30d`, `salesHistory` | | From our daily sales history; empty for products we have not tracked yet |
| `rating`, `reviewCount`, `ratingBreakdown` | `4.6`, `2693`, `{"5": 2100, …}` | |
| `topReviews` | | Latest reviews shown on the page: stars, text, date, variant |
| `description`, `specifications`, `images` | | |
| `shipping` | `{"fee": 0, "freeShipping": true, "minDays": 3, "maxDays": 6}` | |
| `categories`, `categoryId` | `["Home Supplies", "Kitchen", …]` | |
| `shopName`, `sellerId`, `shop` | | Shop units sold, followers and rating |
| `sourceInput`, `foundVia` | `air fryer`, `search` | What you gave and how the product was found |

### How to scrape TikTok Shop products

1. Put one product per line into **Products**:
   - a product link — `https://shop.tiktok.com/us/pdp/…/1732278859685073295`, `https://www.tiktok.com/shop/pdp/…` or `…/view/product/…`;
   - a product ID — `1732278859685073295`;
   - a product name — `stanley cup`. The top match of a TikTok Shop US search is opened.
2. Press **Start**. Download the table as JSON, CSV or Excel, or read it through the API.

```json
{
  "products": [
    "https://shop.tiktok.com/us/pdp/1732278859685073295",
    "1732860257413665644",
    "stanley cup"
  ]
}
```

Links carry their own country (US, UK, Thailand, Malaysia, Singapore, Philippines, Vietnam). For bare IDs set **Country**. Lookup by name works on the US shop.

### How much does it cost to scrape TikTok Shop products?

**$0.007 per product** on every Apify plan — $7 per 1,000 products. No start fee, no subscription. You pay only for delivered products: a wrong link, a product TikTok does not have and a page that did not open are free notes.

### Apify Free plan

TikTok Shop opens product pages reliably only through a paid unblocking route, which this Actor uses on paid Apify plans. On the Free plan the Actor can use Apify's own addresses only: a run returns one complete product, and a page TikTok refuses comes back as a free note saying so. Any paid plan returns every product in full.

### Notes that keep the table honest

- A name TikTok does not recognise is answered by TikTok with random products. The Actor does not deliver or charge them.
- A store, category or search link is not a product: you get a free note that names the right Actor.
- An empty input is a free note with a working example, not a paid demo run.
- If the run timeout is too short, the products read so far are delivered and a note says how many are left.
- The same product given twice (link and ID) is read and charged once.

### Use it from the API or an AI agent

```bash
curl -X POST "https://api.apify.com/v2/acts/apimy~tiktok-shop-product-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"products": ["https://shop.tiktok.com/us/pdp/1732278859685073295"]}'
```

The Actor works through the Apify MCP server: an agent passes a product link or name in `products` and reads the product row back.

### Is it legal to scrape TikTok Shop?

The Actor reads public product pages that any visitor sees without logging in. It collects no private user data. Check the rules that apply to your own use of the data.

### You might also like

| Actor | What it adds |
|---|---|
| [TikTok Shop Search Scraper](https://apify.com/apimy/tiktok-shop-search-scraper) | Product lists by keyword with price, sales and rating |
| [TikTok Shop Top Products](https://apify.com/lergassy/tiktok-shop-top-products-scraper) | Best-selling products with sales and revenue analytics |
| [TikTok Shop Product API](https://apify.com/blueskyscraper/tiktok-shop-product-api) | Sales and revenue analytics for a product: 7, 28 and 90 days |
| [TikTok Shop Scraper](https://apify.com/lergassy/tiktok-shop-scraper) | Stores, categories, best sellers, creators and full reviews |
| [TikTok Shop Reviews Scraper](https://apify.com/lergassy/tiktok-shop-reviews-scraper) | Every buyer review of a product |

### Support

A product that opens on the TikTok Shop site and comes back as a note here? Open an issue on the Issues tab with the link — we answer within a day.

# Changelog

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

# Actor input Schema

## `products` (type: `array`):

One product per line. A TikTok Shop product link (<code>shop.tiktok.com/us/pdp/…</code>, <code>www.tiktok.com/shop/pdp/…</code> or <code>…/view/product/…</code>), a product ID (<code>1729436251038…</code>), or a product name — for a name the top match of a TikTok Shop US search is opened. Links carry their own country: US, UK, Thailand, Malaysia, Singapore, Philippines and Vietnam.

## `country` (type: `string`):

TikTok Shop market of product IDs given without a link. Links carry their own country, product names are looked up on the US shop.

## `concurrency` (type: `integer`):

How many product pages to open at the same time.

## Actor input object example

```json
{
  "products": [
    "air fryer"
  ],
  "country": "US",
  "concurrency": 5
}
```

# Actor output Schema

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

One row per product: price range, discount, units sold, rating, stock, variants and shop.

## `allRows` (type: `string`):

Every row of the run: products plus free notice rows (type field tells them apart).

## `runStats` (type: `string`):

JSON counters for the run: rows delivered, filtered out, duplicates, errors and request statistics.

# 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 = {
    "products": [
        "air fryer"
    ]
};

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

# Prepare the Actor input
run_input = { "products": ["air fryer"] }

# Run the Actor and wait for it to finish
run = client.actor("apimy/tiktok-shop-product-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 '{
  "products": [
    "air fryer"
  ]
}' |
apify call apimy/tiktok-shop-product-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,apimy/tiktok-shop-product-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/satg7Q1nMAUwI16Pa/builds/wYcHHd9Tat8KW9Gvo/openapi.json
