# TikTok Shop Creators Scraper (`lergassy/tiktok-shop-creators-scraper`) Actor

Scrape TikTok Shop creators who sell: revenue (GMV), units sold, revenue from videos vs lives, growth, followers and views in 15 markets. Optional profile with contact e-mail, WhatsApp and Instagram. Find them by keyword, category, product or shop. JSON, CSV, API.

- **URL**: https://apify.com/lergassy/tiktok-shop-creators-scraper.md
- **Developed by:** [Matvey](https://apify.com/lergassy) (community)
- **Categories:** Social media, Lead generation, E-commerce
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 creators

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 Creators Scraper** finds the creators who actually **sell** on TikTok Shop and shows how much: **revenue (GMV), units sold, revenue from videos vs lives, growth, followers and content views** for the last day, 7 days, 30 days or any past month, in 15 markets. Turn on **📇 Profile & contacts** and each creator also gets the **e-mail, WhatsApp and Instagram they list**, GPM and video, live, shop and product counts.

**$4 per 1,000 creators** ($0.004 per row, down to $0.0028 on higher Apify plans); with profile and contacts **$40 per 1,000** from 22 October 2026. No login.

### What is TikTok Shop Creators Scraper?

An affiliate-marketing and influencer-sourcing tool. Instead of guessing from follower counts, it ranks creators by the sales they drive: the top sellers of a niche (keyword or category), the creators selling a specific product, or the affiliates of a competitor's shop.

- **Who sells in my niche?** Top creators for "skincare", "protein" or the Beauty category, ranked by revenue.
- **Who sells my competitor's product?** Creators for a product link, with their revenue from it.
- **Who can I contact?** E-mail, WhatsApp, Instagram and more when the creator lists them.

### What data can it extract?

| Field | Meaning |
|---|---|
| `username`, `nickname`, `profileUrl`, `creatorId`, `followers` | The creator |
| `revenue`, `unitsSold`, `revenueGrowthPercent` | Sales revenue (USD) and units sold in the period, change against the previous period |
| `videoRevenue`, `liveRevenue`, `contentViews` | Revenue from shoppable videos vs live streams, views of selling content |
| `email`, `whatsapp`, `instagram`, `facebook`, `line`, `zalo` | Contacts the creator lists (profile option) |
| `creatorType`, `bio`, `videoGpm`, `liveGpm`, `avgSellingPrice` | Independent or agency, bio, revenue per 1,000 views, average order value (profile option) |
| `videoCount`, `liveCount`, `shopCount`, `productCount`, `newFollowers` | Selling activity (profile option) |
| `rank`, `country`, `period`, `source`, `sourceInput`, `category` | Position in the list and which input found the creator |

### How much does it cost?

Pay per event:

| Event | Free plan | Bronze | Silver | Gold and up |
|---|---|---|---|---|
| Creator row | $0.004 | $0.0036 | $0.0032 | $0.0028 |
| Creator row with profile & contacts | $0.02 | $0.019 | $0.018 | $0.017 |

From **22 October 2026**: a **run start fee of $0.005**, and a row with profile & contacts costs **$0.04 / $0.038 / $0.036 / $0.035** (the price covers the paid data call behind each such row).

- Rows with profile & contacts are **paused until 22 October 2026**: with the option on, rows are delivered and charged as plain rows.
- Each row is charged once: as a plain creator or, with the option on, as a creator with profile & contacts.
- Notices (an input with no results), duplicates across inputs and errors are **never billed**.
- Set **Max cost per run** in the run options and the run stops by itself at that amount, with every delivered row paid for.
- **Free Apify plan:** a preview of up to 20 rows from each of the first 2 inputs, without the analytics option (Apify does not pay out free-plan runs, while every row costs us a licensed data call). Any paid Apify plan removes these limits.

In a test on 8 October 2026, 3 skincare creators with 10,000+ followers came back with profile — **3 of 3 had a contact e-mail**.

### How to scrape TikTok Shop creators

1. Leave the inputs empty for the overall top creators of a country, or add **🔍 Keywords**, **🗂️ Categories**, **🛍️ Products** or **🏪 Shops**.
2. Pick the **🌍 Country**, **📅 Period** and **↕️ Sort by** (revenue, units sold, growth, followers, views, video or live revenue). Optionally set follower and revenue filters.
3. Turn on **📇 Profile & contacts** if you need e-mails and the full profile, press **Start**, and export JSON, CSV or Excel.

### ⬇️ Input

```json
{
  "keywords": ["skincare"],
  "categories": ["Vitamins"],
  "productIds": ["https://shop.tiktok.com/us/pdp/x/1729448464509734958"],
  "country": "US",
  "period": "last30Day",
  "sortBy": "revenue",
  "maxResultsPerSource": 100,
  "minFollowers": 10000,
  "addAnalytics": true
}
```

Categories are TikTok Shop category names; the matched category is written into each row.

### ⬆️ Output

A creator row with profile (real run of 8 October 2026; name and contacts replaced by placeholders):

```json
{
  "type": "creator",
  "rank": 1,
  "creatorId": "7000000000000000000",
  "username": "example_creator",
  "nickname": "Example Creator",
  "profileUrl": "https://www.tiktok.com/@example_creator",
  "followers": 73700,
  "revenue": 151556.98,
  "unitsSold": 6678,
  "revenueGrowthPercent": -8.53,
  "videoRevenue": 149700.64,
  "liveRevenue": 0,
  "contentViews": 5257352,
  "country": "US",
  "period": "last30Day",
  "currency": "USD",
  "source": "keyword",
  "sourceInput": "skincare",
  "scrapedAt": "2026-10-08T14:11:05.364Z",
  "creatorType": "INDEPENDENT",
  "bio": null,
  "email": "name@example.com",
  "whatsapp": null,
  "instagram": null,
  "facebook": null,
  "line": null,
  "zalo": null,
  "avgSellingPrice": 22.69,
  "videoViews": 5257352,
  "liveViews": 0,
  "videoGpm": 28.47,
  "liveGpm": 0,
  "newFollowers": 700,
  "videoCount": 1,
  "liveCount": 0,
  "shopCount": 227,
  "productCount": 495,
  "analytics": true
}
```

### Use cases

#### Affiliate recruiting for TikTok Shop sellers

Find the 200 creators who sell most in your category this month and contact them from the e-mails in the profile.

#### Competitor research

Add a competitor's product link and see which creators sell it and how much revenue each one drives.

#### Influencer agencies

Rank creators by revenue per view (GPM) instead of followers.

#### AI agents and pipelines

Call the Actor from an AI agent through the Apify MCP server or the API to answer "who sells X on TikTok Shop".

### Integrations

Apify API (`POST /v2/acts/lergassy~tiktok-shop-creators-scraper/run-sync-get-dataset-items`), Python and JavaScript clients, n8n, Make, Zapier, Google Sheets, webhooks and schedules, and the Apify MCP server for AI agents.

### Troubleshooting

- **A notice "Stopped here"**: the inputs before it returned almost no matching rows, so the run ended instead of reading on; nothing is charged for inputs that were not read. Use broader keywords or categories.
- **A notice row "No TikTok Shop category matches"**: use a broader name ("Beauty", "Phones", "Vitamins").
- **Empty contact fields**: the creator does not list that contact; nothing is invented.
- **Fewer creators than the limit**: the niche has fewer selling creators in the period, or your filters removed them.

### ❓ FAQ

#### Where do the revenue numbers come from?

From licensed TikTok Shop analytics data: the same kind of figures sales-analytics dashboards show. TikTok does not publish revenue, so revenue, units sold and the video / live split are **estimates** built from public sales counters, prices and content. Use them to compare and rank, not as accounting figures.

#### Which markets are covered?

The US, UK, Indonesia, Thailand, Vietnam, the Philippines, Malaysia, Singapore, Japan, Mexico, Germany, Italy, France, Spain and Brazil. Revenue is in US dollars for every market.

#### Does it need a TikTok account, cookies or an API key?

No. Nothing to log in to and no key to bring.

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

The Actor returns aggregated sales analytics and public profile information. Check that your use complies with TikTok's terms and with data-protection law in your country (GDPR, CCPA), especially before contacting creators.

#### Can I export creator e-mails?

Yes, with the profile option on: the e-mail and other contacts the creator lists for business. Use them in line with anti-spam law and the creator's own wishes.

### Your feedback

Found a bug or need a field? Open an issue on the Actor's **Issues** tab. If the Actor saved you time, a short review helps other buyers find it.

### You might also like

| Actor | What it does |
|---|---|
| [TikTok Shop Scraper](https://apify.com/lergassy/tiktok-shop-scraper) | Live product pages: price, stock per variant, shipping, shop stats and up to 25,000 reviews per product |
| [TikTok Shop Top Products Scraper](https://apify.com/lergassy/tiktok-shop-top-products-scraper) | Best-selling products with revenue, units sold and the video / live split in 15 markets |
| [TikTok Shop Creators Scraper](https://apify.com/lergassy/tiktok-shop-creators-scraper) | Selling creators with revenue, followers and contact e-mails |
| [TikTok Shop Videos Scraper](https://apify.com/lergassy/tiktok-shop-videos-scraper) | Shoppable videos with revenue, views, ad ROAS and the AI-video flag |
| [TikTok Shop Shops & Live Scraper](https://apify.com/lergassy/tiktok-shop-shops-live-scraper) | Top shops with the affiliate / own-account split, and top live streams with revenue and views |
| [TikTok Shop Reviews Scraper](https://apify.com/lergassy/tiktok-shop-reviews-scraper) | Every buyer review of US and UK products, or only the new ones since a date |
| [TikTok Influencer Scraper](https://apify.com/lergassy/tiktok-influencer-scraper) | Followers, engagement rate and average views for any list of TikTok creators |

# Changelog

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

# Actor input Schema

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

Give this or another input below — or leave all empty for the overall top creators of the chosen country. Creators matching each keyword: <b>air fryer</b>, <b>lip gloss</b>, <b>protein</b>.

## `categories` (type: `array`):

Optional. TikTok Shop category names — <b>Beauty & Personal Care</b>, <b>Phones & Electronics</b>, <b>Skincare</b>, <b>Air Fryers</b>. Each one is a separate list of top creators; the matched category is in the row.

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

Optional. TikTok Shop product links or IDs (<code>shop.tiktok.com/us/pdp/…/1729…</code>): the creators selling each product.

## `shopIds` (type: `array`):

Optional. TikTok Shop shop IDs or store links (<code>shop.tiktok.com/us/store/…/7495…</code>): the creators of each shop.

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

TikTok Shop market. Revenue is in US dollars for every market.

## `period` (type: `string`):

Sales window for revenue, units sold and growth.

## `month` (type: `string`):

Optional, overrides Period: a past month as <code>2026-09</code>.

## `sortBy` (type: `string`):

Order of the list, highest first.

## `maxResultsPerSource` (type: `integer`):

Upper limit of creators from each keyword, category, product, creator or shop (or from the overall top list). Duplicates across inputs are skipped and not charged. Free Apify plan: up to 20 from each of the first 2 inputs.

## `addAnalytics` (type: `boolean`):

<b>Paused until 22 October 2026</b> (rows come as plain rows at the plain price); from then $0.04 per row. Not on the free Apify plan. Adds to each creator: e-mail, WhatsApp, Instagram, Facebook, LINE and Zalo when the creator lists them, bio, creator type (independent or agency), video and live GPM, views, new followers, video / live / shop / product counts. Each such row is charged as a creator with profile instead of a plain creator.

## `minRevenue` (type: `integer`):

Only rows with at least this revenue in the period. 0 = no floor.

## `maxRevenue` (type: `integer`):

0 = no ceiling.

## `minFollowers` (type: `integer`):

0 = no floor.

## `maxFollowers` (type: `integer`):

0 = no ceiling.

## `ascending` (type: `boolean`):

Reverse the order: lowest values first.

## Actor input object example

```json
{
  "country": "US",
  "period": "last30Day",
  "sortBy": "revenue",
  "maxResultsPerSource": 20,
  "addAnalytics": false,
  "minRevenue": 0,
  "maxRevenue": 0,
  "minFollowers": 0,
  "maxFollowers": 0,
  "ascending": false
}
```

# Actor output Schema

## `creators` (type: `string`):

One row per creator: revenue, units sold and the rest of the fields, in rank order.

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

Every row of the run, including notices; the type field tells them apart.

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

Counters for the run: rows, inputs, duplicates, errors.

# 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 = {
    "maxResultsPerSource": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("lergassy/tiktok-shop-creators-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 = { "maxResultsPerSource": 20 }

# Run the Actor and wait for it to finish
run = client.actor("lergassy/tiktok-shop-creators-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 '{
  "maxResultsPerSource": 20
}' |
apify call lergassy/tiktok-shop-creators-scraper --silent --output-dataset

```

## MCP server setup

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