# Tiktok Shop Stores scraper (`web_wanderer/tiktok-stores`) Actor

Extract seller and store data from TikTok Shop. Ratings, followers, badges, and every product with prices, discounts, and variants.

- **URL**: https://apify.com/web\_wanderer/tiktok-stores.md
- **Developed by:** [Billy](https://apify.com/web_wanderer) (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

from $0.50 / 1,000 product/store 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Store Scraper

Scrape TikTok Shop stores and their product catalogs. Get store details, ratings, follower counts, and every product with prices, all in clean structured JSON.

#### Why use this actor?

- Get complete store profiles: name, logo, rating, followers, sold count, and more.
- Pull the full product catalog of any store, with prices, discounts, and variant details.
- Just paste store URLs or seller IDs. No browsing, no login.
- Clean, flattened output that is easy to load into a database or spreadsheet.
- Automatic pagination collects every product until the catalog is exhausted.

### Features

- Scrapes store info and, optionally, all products of each store.
- Returns store metadata: name, URL, logo, seller badge, rating, best and worst rating, follower, video, sold, review, and on-sale product counts, and the store description.
- Returns product data: title, price, original price, discount percent, price range across variants, rating, review count, sold count, and product URL.
- Handles multi-variant products with per-variant prices and the full price range.
- Accepts store URLs or bare seller IDs.
- Works across supported TikTok Shop regions.

### Example input

```json
{
  "shops": [
    "https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033"
  ],
  "include_products": true,
  "max_products_per_store": 0,
  "region": "US"
}
```

### Output example

Each run produces two kinds of records, marked by `record_type`.

A store record (when `include_products` is false):

```json
{
  "record_type": "store",
  "seller_id": "7494162490214877033",
  "handle": "maxcomfi",
  "shop_name": "Maxcomfi",
  "shop_url": "https://www.tiktok.com/shop/store/maxcomfi/7494162490214877033",
  "shop_logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a7c512a028e545818dac5870cb087ebe~tplv-fhlh96nyum-resize-webp:300:300.webp",
  "shop_badge": "Gold Star Seller",
  "shop_badge_key": "gold",
  "shop_is_brand": false,
  "shop_rating": "4.7",
  "best_rating": "5",
  "worst_rating": "0",
  "sold_count": 351338,
  "on_sell_product_count": 46,
  "review_count": 19994,
  "followers_count": 56817,
  "video_count": 1563,
  "creator_name": "Maxcomfi",
  "description": "Shop Maxcomfi on TikTok Shop! 351.3K sold, 56.8K+ followers.",
  "enable_follow": true,
  "region": "US",
  "scrapedAt": "2026-08-22T00:00:00+00:00"
}
```

A product record (when `include_products` is true) carries the store info in `store_*` fields first, followed by the product data:

```json
{
  "record_type": "product",
  "store_seller_id": "7494162490214877033",
  "store_handle": "maxcomfi",
  "store_name": "Maxcomfi",
  "store_url": "https://www.tiktok.com/shop/store/maxcomfi/7494162490214877033",
  "store_badge": "Gold Star Seller",
  "store_rating": "4.7",
  "store_followers_count": 56817,
  "store_review_count": 19994,
  "product_id": "1732019802538742633",
  "title": "MaxComfi Lash Clusters Cosmetic Eyelashes - DD Curl",
  "product_url": "https://shop.tiktok.com/us/pdp/maxcomfi-ghost-lashes-long-lasting-waterproof-lightweight/1732019802538742633",
  "product_photo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3967c1a340434eb8a32de0d49cad8e03~tplv-fhlh96nyum-crop-webp:1200:1200.webp",
  "currency": "USD",
  "currency_symbol": "$",
  "sale_price": "16.99",
  "origin_price": null,
  "discount": null,
  "price_prefix": "From",
  "min_sale_price": "16.99",
  "max_sale_price": "51.99",
  "product_rating": 4.6,
  "product_review_count": 10512,
  "product_sold_count": 181972,
  "sku_id": "1732411834349097833",
  "skus": [
    {
      "sku_id": "1732253559874622313",
      "sale_price": "36.99",
      "origin_price": "60.99",
      "discount": 39.0,
      "currency": "USD"
    },
    {
      "sku_id": "1732253559874687849",
      "sale_price": "22.99",
      "origin_price": "30.99",
      "discount": 26.0,
      "currency": "USD"
    }
  ],
  "labels": ["Back to School"],
  "promotion_id": "7672459765435790",
  "free_shipping": false,
  "region": "US",
  "page": 1,
  "position": 1,
  "scrapedAt": "2026-08-22T00:00:00+00:00"
}
```

Products with multiple variants include `min_sale_price` and `max_sale_price`, plus a `skus` array with per-variant prices. The example shows two variants; the array lists every variant of a product. When the main displayed price is the cheapest variant, `price_prefix` is set to `From`.

### Use cases

- Competitor store analysis and catalog monitoring.
- Price tracking across a store's full product range.
- Building a product database from specific TikTok Shop stores.
- Lead generation from shop and product data.

### Privacy & personal information

This actor collects public business data about TikTok Shop stores and their products. It does not collect personal information about individuals, such as customer names, private messages, or account details.

### Your responsibility

You are responsible for how you use this actor, the data you collect, and your compliance with TikTok's Terms of Service and any applicable laws and regulations.

### Tips

- Set `max_products_per_store` to 0 to collect every product in a store.
- Turn off `include_products` to collect only store metadata and save time.
- Provide full store URLs for the most reliable results. Bare seller IDs also work.
- The output is normalized to a consistent set of fields, so records from different regions line up cleanly.

### Need help?

Questions? Bugs? Something not working? Open an issue or reach out through Apify Support.

# Actor input Schema

## `shops` (type: `array`):

One store per line. Accepts store URLs like https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033 or bare seller IDs.

## `include_products` (type: `boolean`):

Also scrape every product listed in each store.

## `max_products_per_store` (type: `integer`):

Maximum products to collect per store. Set to 0 to collect all products.

## `region` (type: `string`):

Default region used for proxy routing and as a fallback when a URL does not specify a region.

## Actor input object example

```json
{
  "shops": [
    "https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033"
  ],
  "include_products": true,
  "max_products_per_store": 0,
  "region": "US"
}
```

# Actor output Schema

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

Dataset containing store records and product records.

# 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 = {
    "shops": [
        "https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("web_wanderer/tiktok-stores").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 = { "shops": ["https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033"] }

# Run the Actor and wait for it to finish
run = client.actor("web_wanderer/tiktok-stores").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 '{
  "shops": [
    "https://shop.tiktok.com/us/store/maxcomfi/7494162490214877033"
  ]
}' |
apify call web_wanderer/tiktok-stores --silent --output-dataset

```

## MCP server setup

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

```

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/YPnGkIVe6jpQazo8G/builds/91HyMkfXCegk9g8vC/openapi.json