# TikTok Shop Scraper: Stores, Products, Prices, Sales (`alexmorain/tiktok-shop-scraper`) Actor

Scrape TikTok Shop stores, products and categories (US and UK): the whole catalog of a store past the 20 products its page shows, with the announced count next to the returned count. Product pages with variants and stock, new-product and price-change watch, webhook.

- **URL**: https://apify.com/alexmorain/tiktok-shop-scraper.md
- **Developed by:** [Alexis Morain](https://apify.com/alexmorain) (community)
- **Categories:** E-commerce, Social media, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 80.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 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.
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: stores, products, prices and sales

TikTok Shop Scraper reads TikTok Shop for you and returns clean rows: title, price, original price, discount, units sold, rating, review count, brand, image and store stats. Give it a store URL and it returns the whole catalog of that store, not the 20 products the store page shows. Give it a product URL and it returns the full product page. Give it a category URL and it returns what TikTok lists there. No login, no cookies, no API key.

It was built for people who watch what sells on TikTok Shop: dropshippers, e-commerce sellers, brand and pricing teams, agencies, market researchers and affiliate creators who need a list of products with real sales counts before a trend peaks.

### What does TikTok Shop Scraper do?

The Actor opens public TikTok Shop pages the way a shopper's browser does and reads the data embedded in them. It works on three kinds of URL:

1. A store: every product the store sells, with price, discount, units sold, rating, review count and the store's own numbers (followers, units sold, rating, number of products). The store page shows 20 products and loads the rest as you scroll. The Actor follows that list to the end, page after page, and compares the count it read with the count TikTok announces.
2. A product: the full product page, with description, all images, category path, specifications, every variant with its price and stock, shipping, rating breakdown and a few recent reviews.
3. A category: the products TikTok lists on the category page, and optionally each direct subcategory page.

Two markets are supported: the United States (us) and the United Kingdom (gb). Prices come in the market's currency, because the Actor reads each market from an IP address in that country.

What it does not do: keyword search. TikTok Shop's search results are not served to this kind of client, so the Actor starts from a store, a product or a category you already have. To find stores, use the category pages, or copy the links of stores you already follow.

### Why use TikTok Shop Scraper?

Whole stores, not the first screen. A store with 1,121 products announced by TikTok came back with 1,121 products. A store with 34,381 products gave 12,000 products in one run (19 minutes, about 0.17 USD of platform usage) before the limit I had set. Every run writes the announced count next to the returned count in the SUMMARY record, so you can check.

Price changes without paying twice. Turn on monitoring and the next run returns only the products that are new or whose price moved, with the previous price and the direction (up or down). Products that did not change are not returned and not charged. Point a scheduled run at a competitor store every morning and get a short list of what changed.

Product pages only when you want them. The plain product row is cheap. The detailed row costs more, and it is charged only for pages the Actor really read: if TikTok does not serve a product page after several tries, the row comes back as a plain product and is charged as one.

A webhook at the end of the run. Slack and Discord incoming webhooks work, and so does any URL that accepts a JSON POST.

It resumes after a restart. If the platform moves the run to another machine, products already delivered are not delivered or charged again.

### What data can you extract?

Every row has these fields. The ones marked (page) need the option "Read each product page" or a product URL.

| Field | What it is |
|---|---|
| productId, title, url, country | Identity of the product and the market read |
| price, originalPrice, discountPercent, currency | Current price, price before discount, discount, currency code |
| soldCount | Units sold since the product was listed, as TikTok shows it |
| rating, reviewCount | Average rating and number of reviews |
| brand, imageUrl | Brand shown on the store listing (null when the store does not list one), main image |
| shopId, shopName | The store |
| shopSoldCount, shopFollowers, shopRating, shopReviewCount, shopProductCount, shopOfficial | The store's own numbers |
| source, sourceUrl, scrapedAt | Where the row was read and when |
| previousPrice, priceChange | Monitoring only: the price at the previous run and new, up or down |
| detailStatus | ok, failed or unavailable, only when product pages were requested |
| images, description, categories (page) | All images, the description text, the category path |
| specifications (page) | Attributes such as Brand, Volume, Ingredients, Region of origin |
| skus (page) | Variants with skuId, stock, price, originalPrice and options |
| stock, freeShipping, shippingFee, deliveryMinDays, deliveryMaxDays (page) | Total stock and shipping terms |
| ratingBreakdown, reviewsSample (page) | Reviews per star, and a few recent reviews with text and variant |

Results come in the dataset, which you can export as JSON, CSV, Excel, XML or HTML, or read through the API.

### How to scrape TikTok Shop

1. Open the Actor and paste one or more URLs in TikTok Shop URLs, one per line. A store URL looks like https://shop.tiktok.com/us/store/shop-name/7495992422530583306. The long number at the end is the store ID. The words before it can be anything.
2. Set Max items. For a test, 40 is enough. A large store has tens of thousands of products, and a run without a limit reads them all.
3. Switch on Read each product page if you need descriptions, variants, stock and reviews.
4. Press Start. A store of a few hundred products takes about a minute.
5. Download the results from the Output tab, or read them from the API.

To find a store ID, open any TikTok Shop product page, then open the store from the product page: the store URL is in the address bar.

### Input

| Field | Type | What it does |
|---|---|---|
| startUrls | list of URLs | Stores, products and categories. Duplicates are removed. |
| country | us or gb | Market for URLs that do not carry one. A shop.tiktok.com/gb/ URL keeps its own. |
| includeDetails | true or false | Reads each product page. Higher price per product. |
| includeSubcategories | true or false | For category URLs, also reads each direct subcategory page. |
| maxItems | number | Stops after this many products in total. Empty or 0 means no limit. |
| maxItemsPerSource | number | Stops each store or category after this many products. |
| monitorMode | off, newOnly, newAndPriceChanges | Returns only what is new, or new plus price changes. |
| monitorName | text | Separate memories for the same store. |
| webhookUrl | URL | JSON summary sent at the end of the run. |

A small input that works as a first test:

```json
{
  "startUrls": ["https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"],
  "maxItems": 40
}
```

### Output example

A product row from a store:

```json
{
  "productId": "1730486220293772042",
  "title": "[Biodance Official] #1 Viral OG Hydrogel Face Mask | Pore Care & Hydrating",
  "url": "https://shop.tiktok.com/us/pdp/bio-collagen-real-deep-mask-by-biodance-hydrating-hydrogel-34g-x4ea/1730486220293772042",
  "country": "us",
  "price": 19,
  "originalPrice": 32.99,
  "discountPercent": 42,
  "currency": "USD",
  "rating": 4.8,
  "reviewCount": 3831,
  "soldCount": 51470,
  "brand": "Biodance",
  "shopId": "7495992422530583306",
  "shopName": "Biodance Store US",
  "shopSoldCount": 402331,
  "shopFollowers": 244259,
  "shopProductCount": 46,
  "source": "store",
  "scrapedAt": "2026-11-13T10:00:00Z"
}
```

A run also writes a SUMMARY record to the key-value store. For each input it gives the status, products read, products returned, the count TikTok announced for a store, products skipped by monitoring, product pages that could not be read, and the number of requests, refusals and IP rotations.

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

The Actor uses pay-per-event pricing. You pay for the start of the run and for each product returned. Prices fall with your Apify plan.

| Event | Free plan | Starter | Scale | Business |
|---|---|---|---|---|
| Actor start (per GB of memory, 256 MB by default) | 0.002 USD | 0.002 USD | 0.002 USD | 0.002 USD |
| Product (store or category row) | 1.00 USD per 1,000 | 0.87 USD | 0.73 USD | 0.50 USD |
| Product with details (product page read) | 2.50 USD per 1,000 | 2.15 USD | 1.75 USD | 1.30 USD |

A product URL is charged as a product with details; if its page cannot be read, nothing is returned and nothing is charged. A product found twice in the same run is charged once. Products skipped by monitoring are not charged. You can set a maximum charge per run in the run options: the Actor stops when it is reached.

Examples: 1,000 products from a store on a free plan cost about 1 USD. The same 1,000 with product pages cost about 2.50 USD. Watching a 300-product store every day with price monitoring costs the start fee plus the few products that changed.

### Tips and limits

Start small. Run 40 products first, look at the rows, then raise Max items.

Large stores take time. About 600 requests read 12,000 products, which took 19 minutes on the day of the test. The default run timeout is one hour; raise it for a store of 30,000 products or more, or set Max items and run again.

Product pages are the slow part. TikTok refuses some requests and the Actor retries them from a new IP address, up to seven times. In tests, 97 percent of product pages came back, about 60 percent on the first try. If a page still does not come back, the product is returned as a plain product and the SUMMARY says how many.

The United Kingdom market works for products and categories. For a UK store, the Actor returns the first 20 products and the store numbers: TikTok does not serve the rest of a UK store's list to this kind of client. The SUMMARY shows the announced count so you can see the gap.

A category page lists a small number of products, usually 10 to 17. With Also read subcategories the Actor reads each direct subcategory page too. For a deeper list, scrape the stores you find there.

Numbers such as units sold are the ones TikTok shows to shoppers. The Actor does not estimate revenue.

### Use it from code

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("alexmorain/tiktok-shop-scraper").call(run_input={
    "startUrls": ["https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"],
    "maxItems": 100,
    "monitorMode": "newAndPriceChanges",
    "monitorName": "biodance-daily",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"], item["price"], item["soldCount"], item.get("priceChange"))
```

JavaScript:

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('alexmorain/tiktok-shop-scraper').call({
  startUrls: ['https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306'],
  maxItems: 100,
  includeDetails: true,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length, items[0].title);
```

cURL:

```bash
curl -X POST "https://api.apify.com/v2/acts/alexmorain~tiktok-shop-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrls": ["https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"], "maxItems": 40}'
```

### Monitoring a store

Set monitorMode to newOnly to get only products that were not returned by an earlier run with the same input. Set it to newAndPriceChanges to also get products whose price moved: each of those rows carries previousPrice and priceChange (up or down). New products carry priceChange new. The first run returns everything. The memory is a key-value store named tiktok-shop-scraper-monitor in your account, one record per store, and it forgets products not seen for 180 days. To start a separate watch on the same store, change monitorName.

The monitor reads the whole store each time, so a product that moves in the list is never missed. Schedule the run from the Apify console (daily or hourly), and add a webhook URL to get a message when something changed.

### Frequently asked questions

Can I search TikTok Shop by keyword? No. TikTok does not serve search results to this kind of client. Start from store, product or category URLs.

Where do I find a store URL? Open a product in TikTok Shop, then the store link on the product page. The address contains /store/ and a long number. Only that number matters.

Why does a store return fewer products than TikTok announced? Check the note in the run status and the SUMMARY record. The usual cause is a limit you set (Max items or a maximum charge). If TikTok stops serving a store's list, the status is partial and says how many products were read.

Is the units sold number exact? It is the number TikTok shows on the product, which is rounded for large values on some pages. It is not revenue.

Does it need a TikTok account or cookies? No. It reads public pages.

Does it work for markets other than the US and the UK? Not yet. Other TikTok Shop markets use different pages and were not tested.

Why are some product pages returned as plain products? TikTok refuses a share of requests. The Actor tries again from new IP addresses, and if every try fails, the row comes back without the page data and is charged as a plain product. The SUMMARY counts them.

Can I use the data commercially? The Actor reads public product pages. You are responsible for how you use the data, including the terms of the platform and the laws of your country. It collects store and product information, not personal data about shoppers; recent reviews show a masked reviewer name only in the raw page, and the Actor does not return it.

Something is wrong or missing. Open an issue on the Actor page. Fixes are fast, and a sample input helps.

### Guide and use cases

Use cases for outbound and automation, the output fields, pricing and common questions are on the [TikTok Shop Scraper page](https://alexis.morain.fr/en/scrapers/tiktok-shop-scraper/) of my site. The [E-commerce family page](https://alexis.morain.fr/en/scrapers/families/ecommerce/) puts it side by side with the other scrapers of the same family.

# Actor input Schema

## `startUrls` (type: `array`):

One URL per line.<br>• Store: <code>https://shop.tiktok.com/us/store/shop-name/7495992422530583306</code> or <code>https://www.tiktok.com/shop/store/shop-name/7495992422530583306</code><br>• Product: <code>https://www.tiktok.com/shop/pdp/product-name/1732049122233848586</code> (always returns the full product page)<br>• Category: <code>https://shop.tiktok.com/us/c/home-supplies/600001</code> (the products TikTok lists on the category page)<br>The market (<code>us</code> or <code>gb</code>) is read from a <code>shop.tiktok.com/gb/...</code> URL, else from Market.

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

Market for URLs that do not carry one (<code>www.tiktok.com/shop/...</code>). A <code>shop.tiktok.com/gb/...</code> URL keeps its own. Prices come in the market's currency. On the UK market TikTok serves only the first 20 products of a store; categories and product pages are read in full.

## `includeDetails` (type: `boolean`):

Adds description, all images, categories, specifications, variants with stock, shipping, rating breakdown and recent reviews to each product (Product with details event, higher price). A product page TikTok does not serve is returned as a plain product and charged as one.

## `includeSubcategories` (type: `boolean`):

For category URLs: also read each direct subcategory page. A category page lists only the ~10 to 17 products TikTok shows on it.

## `maxItems` (type: `integer`):

Stops after this many products in total. Empty or 0 = no limit: a large store has tens of thousands of products, so set a limit or a maximum charge per run when you test.

## `maxItemsPerSource` (type: `integer`):

Stops each store or category after this many products. Empty or 0 = no limit.

## `monitorMode` (type: `string`):

<b>New products only</b> returns only products not returned by an earlier run with the same input (and monitor name). <b>New and price changes</b> also returns products whose price moved, with <code>previousPrice</code> and <code>priceChange</code> (up / down). Unchanged products are neither returned nor charged. The first run returns everything. State is kept in a store named <code>tiktok-shop-scraper-monitor</code> in your account.

## `monitorName` (type: `string`):

Optional. Runs with the same name and the same input share one memory; change it to start a separate watch on the same store.

## `webhookUrl` (type: `string`):

Optional. A JSON summary is POSTed here when the run ends with at least one product. Slack and Discord incoming webhooks work. Redirects are not followed (except 307 / 308).

## Actor input object example

```json
{
  "startUrls": [
    "https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"
  ],
  "country": "us",
  "includeDetails": false,
  "includeSubcategories": false,
  "maxItems": 40,
  "monitorMode": "off"
}
```

# Actor output Schema

## `results` (type: `string`):

All products in the default dataset.

## `summary` (type: `string`):

Status of each store, product or category URL: products read, products returned, count announced by TikTok for a store, products skipped by monitoring, product pages that could not be read, requests, refusals and IP rotations.

# 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 = {
    "startUrls": [
        "https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"
    ],
    "maxItems": 40
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexmorain/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 = {
    "startUrls": ["https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"],
    "maxItems": 40,
}

# Run the Actor and wait for it to finish
run = client.actor("alexmorain/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 '{
  "startUrls": [
    "https://shop.tiktok.com/us/store/biodance-store-us/7495992422530583306"
  ],
  "maxItems": 40
}' |
apify call alexmorain/tiktok-shop-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexmorain/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/P2ZfEedSl1GewWRhc/builds/FczexlPX5ZJLQNe6y/openapi.json
