# TikTok Shop Scraper: Sellers, Products, Sales (`bonpleincapital/tiktok-shop-seller-scraper`) Actor

Scrape public TikTok Shop stores, products and keyword pages: seller ID, units sold, price, rating. No login, pay per result.

License: personal use only; resale and redistribution prohibited.
Created with the help of artificial intelligence.

- **URL**: https://apify.com/bonpleincapital/tiktok-shop-seller-scraper.md
- **Developed by:** [Bon Plein Capital](https://apify.com/bonpleincapital) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.80 / 1,000 result scrapeds

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: Products, Sellers & Sales Counts

**TikTok Shop scraper** that reads public TikTok Shop pages and returns clean, structured records: product titles,
prices, units sold, ratings and seller details. Paste a seller store URL, a product URL or a keyword, and download the
results as JSON, CSV or Excel, or call the Actor from the Apify API. It needs no login and no TikTok account, so it only
sees what any visitor of shop.tiktok.com sees.

### What can this Actor do?

- Scrape a **TikTok Shop seller store**: shop name, seller ID, the public **units sold** counter and the number of
  product links visible on the store page.
- Scrape a **TikTok Shop product page**: title, price, currency, rating, review count, image and description, when the
  page shows them to anonymous visitors.
- Search by **keyword**: the Actor opens the public keyword page of a market (US, UK, Indonesia, Malaysia, Philippines,
  Singapore, Thailand, Vietnam) and collects the products linked from it.
- Track sales counters and prices over time: each record has a `scrapedAt` timestamp, so you can schedule runs and
  compare them.
- Fields that TikTok does not show publicly are returned as `null`, never invented.

### Who is it for?

- **Dropshippers and product researchers**: check the public units-sold counter of a store or product before you pick a niche.
- **Brands and agencies**: track competitor stores and price changes with scheduled runs (`scrapedAt` on every record).
- **Analysts**: export clean JSON/CSV to feed a spreadsheet, BI tool or n8n/Make/Zapier flow.

Honest limits: this is a lightweight HTTP scraper. Seller stores always return the shop name, seller ID and sold counter
when TikTok shows them; product details (price, rating) depend on what TikTok serves to anonymous visitors, otherwise `null`.

### How to use it

1. Click **Try for free** and open the **Input** tab.
2. Add one or more TikTok Shop URLs, or keywords (or keep the prefilled store URL to see an example).
3. Set the maximum number of results, then click **Start**.
4. Download the results from the **Output** tab, or call the Actor from the API, Make, Zapier or n8n.

TikTok changes its pages often and may show less data to some visitors. If a page is not publicly readable, the Actor
retries politely, then skips it: you are not charged for it. It does not log in, does not open private accounts and
does not try to bypass captchas.

### Pagination and dynamic content

TikTok Shop pages are partly built by JavaScript, so a plain page download can miss data. This version is more resilient:

- **Pagination**: for each store or keyword page, the Actor reads up to `maxPages` pages. It follows `rel="next"` links
  and embedded cursors, and otherwise tries `?page=2`, `?page=3`... as long as each page brings new product links.
  It stops as soon as a page brings nothing new.
- **Embedded data first**: prices, sold counters, ratings and IDs are read from the JSON that the page ships for its own
  rendering (JSON-LD and hydration data), with the visible text only as a fallback. Product IDs that appear only in
  that JSON are turned into product links too.
- **Browser-like requests**: full browser headers, a Referer on followed links, exponential backoff with jitter on
  network errors and server errors, `Retry-After` honoured on HTTP 429.
- **Apify Proxy fallback**: on HTTP 403/429 the same public page is retried through two fresh proxy sessions.
  Captcha or verification pages are skipped, never bypassed.
- **No duplicates**: the same product is never read (or charged) twice, even if it is linked from several pages.
- **Consistent output**: every record has the same fields; what TikTok does not show is `null`.

This is a lightweight HTTP Actor, not a headless browser: a page that shows no data without running scripts or logging
in is skipped rather than guessed.

### Input

```json
{
  "startUrls": [
    { "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170" }
  ],
  "keywords": ["neck massager"],
  "country": "us",
  "followLinks": true,
  "maxPages": 3,
  "maxItems": 10
}
```

- `startUrls`: seller store, product (`/pdp/`) or keyword (`/k/`) pages of TikTok Shop.
- `keywords`: optional list; each keyword is turned into the public keyword page of the chosen `country`.
- `followLinks`: on store and keyword pages, also open the linked product pages.
- `maxPages`: pages to read per store or keyword page (pagination), 1 to 20.
- `maxItems`: hard limit on the number of results (and on your bill).

### Output

Each result is one dataset item. Example:

```json
{
  "type": "seller",
  "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170",
  "productId": null,
  "title": "KiKi Jewelrry",
  "price": null,
  "currency": null,
  "soldCount": 3853,
  "rating": null,
  "reviewCount": null,
  "sellerName": "KiKi Jewelrry",
  "sellerId": "8652028833300779170",
  "imageUrl": null,
  "description": "Shop KiKi Jewelrry on TikTok Shop! 3853 sold, Join the trend!",
  "productLinksFound": 0,
  "foundOn": null,
  "country": "US",
  "scrapedAt": "2026-10-15T10:26:35+00:00"
}
```

### How much does it cost?

This Actor uses **pay per event** pricing: you pay a small amount for each result record, and nothing for pages that
could not be read. So 1,000 results cost the price of 1,000 `result` events shown in the **Pricing** tab. Apify's free
plan gives you monthly credits to try the Actor before you pay. Use `maxItems` to cap spending.

### FAQ

#### Is it legal to scrape TikTok Shop?

The Actor only reads public pages, like a browser would, and collects no private data. You are responsible for using
the results lawfully and respecting TikTok's terms. Seller names are business names, but if your data contains personal
data of individuals, the GDPR applies to you: have a lawful basis and keep only what you need.

#### Why are some fields empty?

TikTok shows different information to anonymous visitors depending on the market and the page. Missing fields are
returned as `null`.

#### Can I get reviews, followers or private analytics?

No. Only what is visible on public pages without logging in is collected.

#### What if something does not work?

Open an issue in the **Issues** tab with your input and the run link. Issues are answered as fast as possible.

#### Can I use it through the API?

Yes. Every run can be started and read through the Apify API and its Python and JavaScript clients.

***

Created with the help of artificial intelligence.

# Changelog

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

# Actor input Schema

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

Public TikTok Shop URLs: seller stores (shop.tiktok.com/us/store/...), product pages (.../pdp/...) or keyword pages (.../k/...).

## `keywords` (type: `array`):

Optional. Each keyword opens the public TikTok Shop keyword page and collects the products linked from it.

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

TikTok Shop market used for keywords (two-letter code, e.g. us, gb, id).

## `followLinks` (type: `boolean`):

On seller and keyword pages, also open the product pages that are linked there.

## `maxPages` (type: `integer`):

How many listing pages to read for each seller store or keyword page (pagination). Only used when 'Follow product links' is on.

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

Stop after this many results. Keep it low to test the Actor cheaply.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170"
    }
  ],
  "keywords": [
    "neck massager"
  ],
  "country": "us",
  "followLinks": true,
  "maxPages": 1,
  "maxItems": 1
}
```

# Actor output Schema

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

One dataset item per result, shown in the Overview view.

# 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": [
        {
            "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170"
        }
    ],
    "maxPages": 1,
    "maxItems": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("bonpleincapital/tiktok-shop-seller-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": [{ "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170" }],
    "maxPages": 1,
    "maxItems": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("bonpleincapital/tiktok-shop-seller-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": [
    {
      "url": "https://shop.tiktok.com/us/store/kiki-jewelrry/8652028833300779170"
    }
  ],
  "maxPages": 1,
  "maxItems": 1
}' |
apify call bonpleincapital/tiktok-shop-seller-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bonpleincapital/tiktok-shop-seller-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/gdidNhnhG9sNUO17y/builds/8mwnpnImqf6A5S8R1/openapi.json