# TikTok Shop Top Creators Scraper - Creator Sales & Emails (`zen-studio/tiktok-shop-top-creators-scraper`) Actor

Find the TikTok Shop creators who sell the most in 24 markets: revenue (GMV), units sold, followers, views and the video / live split, plus top categories. Optional analytics adds contact e-mail and other channels when listed, bio and creator type. Rank by keyword, category, shop or product.

- **URL**: https://apify.com/zen-studio/tiktok-shop-top-creators-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** E-commerce, Social media, Lead generation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 93.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.09 / 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

[![Find TikTok creators who already sell in your category. Compare estimated sales, followers and the split between video and live revenue.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-top-creators-scraper-readme-hero-e0f7fec42b4f.png)](https://console.apify.com/actors/q2v6x52Qe3lyvGhYs/input)

From **Zen Studio**, creators of the [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper), used by **5,000+ users** to track sales and commission on China's TikTok, and the [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper), used by **9,000+ users**.

### Find creators by what they sell

- Find creators who sell in your category. Filter by category, shop or product, then compare estimated sales and units sold alongside follower counts.
- See whether creators sell through videos or live streams. The seven-day US example shows $775.8K in estimated sales, with 99.6% from videos.
- **24 markets.** Choose a country and a reporting period. Sales and revenue figures are estimates.

<a href="https://console.apify.com/actors/q2v6x52Qe3lyvGhYs/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-top-creators-scraper-readme-cta-v1-9ca53812c8cd.svg" width="240" height="48" alt="Try 20 top creators" /></a>

#### Find US creators in Household Appliances

```json
{
  "categories": [
    "Household Appliances"
  ],
  "country": "US",
  "period": "last7Day",
  "maxResultsPerSource": 20
}
```

[Open the actor input](https://console.apify.com/actors/q2v6x52Qe3lyvGhYs/input), paste the example in JSON view and press **Start**. Contact emails and other listed contact details require the optional paid analytics setting. Availability varies by creator.

#### Copy to your AI assistant

```text
Help me use zen-studio/tiktok-shop-top-creators-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-top-creators-scraper.md for documentation, input schema, pricing and limits. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. Each keyword, category, shop or product is its own ranked list of creators capped by maxResultsPerSource; with no input the run returns the overall top creators of the country, and a creator found by several inputs is delivered and charged once. Keywords match the creator's name or username. addAnalytics is off by default and adds its own charge per creator, about ten times the base row price, so switch it on only when I need contact details, bio, creator type, video and live views, GPM, counts or day-by-day revenue. Contact channels are filled only when the creator lists them, and contacting creators is subject to data-protection and anti-spam rules. Revenue is an estimate of the sales a creator drove, for comparing creators, not their earnings. To see a creator's products, videos or live streams, pass the username as creators to zen-studio/tiktok-shop-top-products-scraper, zen-studio/tiktok-shop-top-videos-scraper or zen-studio/tiktok-shop-live-sales-scraper. The per-input run summary is in the OUTPUT record of the run's key-value store. On the Apify Free plan the actor is a preview: 5 runs of up to 100 creators, and addAnalytics applies to the first 10 creators of each run. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### What does the TikTok Shop Top Creators Scraper do?

It ranks TikTok Shop creators by sales for the market and time window you choose, and returns one row per creator. Use it to find affiliates who already sell in your category, to see which creators sell for a competitor's shop or product, to compare video sellers with live sellers, or to build an outreach list of creators with proven sales.

Each list is the top of TikTok Shop by your chosen order: revenue, revenue growth, units sold, followers, views, video revenue or live revenue. Products, shops, live streams and videos each have their own actor (see the end of this page).

### What you get beyond a plain creator ranking

| | |
|---|---|
| **Video and live split** | Video and live revenue as amounts and as a percent of revenue, so you see at a glance whether a creator sells through videos or live streams |
| **Top categories** | Up to three top categories and three subcategories per creator, with category IDs |
| **Contact details (option)** | E-mail and WhatsApp, Instagram, Facebook, LINE and Zalo when the creator lists them, plus bio, creator type and the shop a shop-owned account belongs to |
| **Four ways in** | Keywords (matched against the creator's name and username), categories, shops and products |
| **Creator type and engagement filters** | Independent affiliate creators or shops' own accounts; low, medium or high engagement |
| **24 markets** | US, UK, Germany, France, Italy, Spain, Poland, Netherlands, Belgium, Czechia, Austria, Greece, Portugal, Hungary, Ireland, Indonesia, Thailand, Vietnam, Philippines, Malaysia, Singapore, Japan, Mexico, Brazil |
| **Any currency, any window** | US dollars, each market's own currency or one of 16 currencies; yesterday, 7 or 30 days, a past month or a custom range of up to 31 days |
| **A summary per input** | The run's OUTPUT record lists how many creators each input delivered and what to change for an input that found nothing |

### How to find the top TikTok Shop creators

1. Pick a **🌍 Country** and a **📅 Period**. With nothing else set, you get the overall top creators of that market.
2. Optionally add **🔍 Keywords**, **🗂️ Categories**, **🏪 Shops** or **📦 Products**. Each entry is its own ranked list.
3. Set **🔢 Max results per source** (creators per list) and, if you like, a sort order and filters.
4. Switch on **📊 Add analytics** when you need contact details or the creator's performance detail.
5. Press **Start** and export JSON, CSV, Excel or HTML.

#### Input options

| Parameter | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | list | empty | Each keyword is its own ranked list of creators whose name or username matches it, for example `beauty` or `fitness` |
| `categories` | list | empty | TikTok Shop category names or IDs: `Beauty & Personal Care`, `Kitchen Appliances`, `601450` |
| `shops` | list | empty | Store links, shop IDs or exact shop names: the creators of each shop |
| `productIds` | list | empty | TikTok Shop product links or IDs: the creators selling each product |
| `country` | select | `US` | One of 24 TikTok Shop markets |
| `period` | select | `last30Day` | `lastDay` (yesterday), `last7Day` or `last30Day` |
| `month` | text | empty | A past calendar month such as `2026-10`; overrides `period` |
| `dateFrom`, `dateTo` | date | empty | Your own window of up to 31 days, ending yesterday or earlier; overrides `month` and `period` |
| `maxResultsPerSource` | number | `100` | Creators per list, 1 to 10,000 |
| `currency` | select | `USD` | `USD`, `local` (the market's own currency) or one of 16 currencies |
| `sortBy`, `ascending` | select, switch | `revenue`, off | `revenue`, `revenueGrowth`, `unitsSold`, `followers`, `views`, `videoRevenue` or `liveRevenue`; `ascending` puts the lowest first |
| `minRevenue`, `maxRevenue` | numbers | off | Revenue range in the period, in the chosen currency |
| `minFollowers`, `maxFollowers` | numbers | off | Follower range |
| `creatorType` | select | `all` | `all`, `independent` (affiliate creators) or `shopOwned` (shops' own accounts) |
| `engagementRate` | select | `any` | `any`, `low` (under 8%), `medium` (8 to 20%) or `high` (over 20%) |
| `addAnalytics` | switch | off | Contact details when listed, bio, creator type, video and live views and GPM, new followers, counts, top products and day-by-day revenue. Extra charge per creator |

Keyword rows carry `matchStrict`, true when the name or username holds every word of the keyword.

#### More input examples

A first test with contact details: the top 3 beauty creators in Indonesia over the last 30 days, in rupiah, with analytics:

```json
{
  "keywords": [
    "beauty"
  ],
  "country": "ID",
  "period": "last30Day",
  "currency": "local",
  "maxResultsPerSource": 3,
  "addAnalytics": true
}
```

In our run all 3 creators had "beauty" in their name, two of them were brands' own shop accounts, and one listed both an e-mail and a WhatsApp number.

Affiliates to recruit: independent creators with 10,000 to 100,000 followers who sold at least $10,000 in the last 30 days:

```json
{
  "country": "US",
  "period": "last30Day",
  "creatorType": "independent",
  "minFollowers": 10000,
  "maxFollowers": 100000,
  "minRevenue": 10000,
  "maxResultsPerSource": 100
}
```

The creators selling one product, best-selling first:

```json
{
  "productIds": [
    "1732390274888863829"
  ],
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 100
}
```

The top 50 live sellers in UK beauty last month, in pounds:

```json
{
  "categories": [
    "Beauty & Personal Care"
  ],
  "country": "GB",
  "month": "2026-10",
  "currency": "local",
  "sortBy": "liveRevenue",
  "maxResultsPerSource": 50
}
```

### What data can you extract from TikTok Shop creators?

| Group | Fields |
|---|---|
| **Creator** | `creatorId`, `username`, `nickname`, `profileUrl`, `followers`, `rank` |
| **Sales in the window** | `revenue`, `unitsSold`, `avgSellingPrice`, `revenueGrowthPercent`, `contentViews` |
| **Video and live** | `videoRevenue`, `liveRevenue`, `videoRevenueSharePercent`, `liveRevenueSharePercent` |
| **Categories** | `topCategories`, `topCategoryIds`, `topSubcategories` |
| **Contacts and profile (analytics)** | `email`, `whatsapp`, `instagram`, `facebook`, `line`, `zalo`, `bio`, `creatorType`, `creatorTypeLabel`, `ownShopId` |
| **Performance (analytics)** | `videoViews`, `liveViews`, `videoGpm`, `liveGpm`, `newFollowers`, `videoCount`, `liveCount`, `shopCount`, `productCount`, `topProductIds`, `dailyRevenue` |
| **Context** | `type`, `country`, `period`, `periodStart`, `periodEnd`, `currency`, `source`, `sourceInput`, `category`, `matchStrict`, `analytics`, `scrapedAt` |

#### Output example

The first row of the quick-start example above, at 100 creators (US, last 7 days, real run on 10 November 2026):

```json
{
  "type": "creator",
  "creatorId": "7275090345011414059",
  "username": "dealswithty",
  "nickname": "Ty",
  "profileUrl": "https://www.tiktok.com/@dealswithty",
  "followers": 165000,
  "revenue": 775826.31,
  "unitsSold": 4581,
  "avgSellingPrice": 169.36,
  "revenueGrowthPercent": 37.87,
  "videoRevenue": 773057.15,
  "liveRevenue": 0,
  "videoRevenueSharePercent": 99.64,
  "liveRevenueSharePercent": 0,
  "contentViews": 14739341,
  "topCategories": [
    "Household Appliances",
    "Automotive & Motorcycle",
    "Toys & Hobbies"
  ],
  "topCategoryIds": [
    "600942",
    "605196",
    "604206"
  ],
  "topSubcategories": [
    "Vacuums & Floor Care",
    "Electric Mops",
    "Specialty Kitchen Appliances"
  ],
  "matchStrict": null,
  "analytics": false,
  "rank": 1,
  "country": "US",
  "period": "last7Day",
  "periodStart": null,
  "periodEnd": null,
  "currency": "USD",
  "source": "top",
  "sourceInput": "top creators US",
  "category": null,
  "scrapedAt": "2026-11-10T15:25:50Z"
}
```

In this 100-creator run, 77 creators made at least 90% of their revenue with videos and 9 with live streams. Half had fewer than 75,000 followers: a big audience is not what puts a creator at the top.

#### Analytics fields

With `addAnalytics` switched on, a row also carries the fields below. This excerpt is rank 1 of the Indonesian `beauty` example above (real run on 10 November 2026, revenue in rupiah); `nickname` and `revenue` are included for comparison, and the e-mail address and WhatsApp number are masked here.

```json
{
  "creatorId": "6683111576708383745",
  "username": "ammy540",
  "nickname": "NAMIKA BEAUTY",
  "revenue": 4193763645.02,
  "currency": "IDR",
  "analytics": true,
  "creatorType": "independent",
  "creatorTypeLabel": "Independent creator",
  "ownShopId": null,
  "bio": null,
  "email": "a••••••••••••7@gmail.com",
  "whatsapp": "8121•••••45",
  "instagram": null,
  "facebook": null,
  "line": null,
  "zalo": null,
  "videoViews": 19388651,
  "liveViews": 768308,
  "videoGpm": 149815,
  "liveGpm": 1663175.94,
  "newFollowers": 12500,
  "videoCount": 60,
  "liveCount": 59,
  "shopCount": 23,
  "productCount": 117,
  "topProductIds": [
    "1736746765782124110",
    "1736785881026430542",
    "1734260330218751544"
  ],
  "dailyRevenue": [
    78915954, 71946413, 50500134, 62252930, 82394443,
    134054045, 140365106, 96826047, 51753695, 74017450,
    116400877, 98049276, 100400704, 90561043, 139040932,
    126800044, 138905624, 86015546, 135354721, 96212326,
    133710669, 214725040, 451329370, 302747361, 203158549,
    197220421, 198009628, 178822124, 216826328, 126446848
  ]
}
```

`dailyRevenue` holds one value per day of the period, oldest first; in our tests it added up to `revenue`. `videoGpm` and `liveGpm` are revenue per 1,000 views of that channel, and `contentViews` equals `videoViews` plus `liveViews`. `ownShopId` is filled for shops' own accounts. `topProductIds` lists the creator's best-selling products.

#### Good to know about the figures

- **Revenue is the creator's sales, not their earnings.** `revenue` is the estimated value of the sales a creator drove in the window (GMV), not the commission they were paid.
- **Figures update during the day.** Two runs a few hours apart can rank creators differently as new sales come in, so compare creators within one run.
- **Video and live shares** usually add up to almost 100%. The rest is revenue the ranking attributes to neither; in our US test 3 of 100 creators were below 90%.
- **Follower counts** are rounded the way TikTok shows them, for example 165,000.
- **Contact details only when listed.** In our tests 4 of 8 creators listed an e-mail and 1 a WhatsApp number, written without the country code; Instagram, Facebook, LINE and Zalo were empty for all 8. Analytics is charged for every row it fills, with or without contacts.
- **Video and live counts** read 0 for both US creators in our analytics test although they sold through videos, while creators in Vietnam and Indonesia had counts. Use the revenue split to judge how a creator sells.
- **Creator type** (`creatorType`, `creatorTypeLabel`) is filled only with analytics; the **Creator type** filter works without it.

#### Contacting creators responsibly

Contact details are personal data. Before you e-mail or message a creator, make sure you have a lawful reason under the data-protection rules that apply to you and to them (for example GDPR in the EU and the UK), follow anti-spam rules such as CAN-SPAM, keep the message relevant to their TikTok Shop work, honour opt-out requests and keep the data only as long as you need it.

#### Run summary

Besides the dataset, each run writes an **OUTPUT** record to its key-value store, also linked on the run's Output tab. This one comes from a run whose only input was not a product link or ID:

```json
{
  "delivered": 0,
  "duplicatesSkipped": 0,
  "country": "US",
  "period": "lastDay",
  "currency": "USD",
  "inputs": [
    {
      "input": "not-a-product",
      "kind": "product",
      "rows": 0,
      "status": "bad-input",
      "error": "\"not-a-product\": use the product link or the numeric product ID."
    }
  ]
}
```

### Use cases

- **Affiliate recruitment.** Find independent creators who already sell in your category, filtered by follower range and minimum revenue, and invite the ones whose video or live mix fits your product.
- **Competitor research.** Put a competitor's store into **Shops** or a product link into **Products** to see which creators sell for them and how much.
- **Live selling and agency scouting.** Sort by **Live revenue** to find the hosts who sell best on live streams in a market or category.
- **Creator outreach lists.** Switch on analytics for the creators you shortlisted to get their listed contact details and bio, then export to your CRM or spreadsheet.
- **Market and category research.** Compare the top creators of two markets or categories, their top categories and their growth over the window.
- **Deeper creator research.** Take a creator's username into the [TikTok Shop Top Videos Scraper](https://apify.com/zen-studio/tiktok-shop-top-videos-scraper), the [TikTok Shop Live Sales Scraper](https://apify.com/zen-studio/tiktok-shop-live-sales-scraper) or the [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper) to see the videos, live streams or products behind their sales.

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

You pay per creator delivered: **$2.99 per 1,000 creators** on the Free plan. Bronze pays $2.79, Silver $2.49, Gold and above $2.09 per 1,000.

- **Analytics** is optional and adds its own charge per creator, about ten times the base price. The Pricing tab lists the exact amount.
- A creator found by several inputs is delivered and charged once. Inputs that find nothing, the run summary and failed inputs are never charged.
- Set **Max cost per run** in the run options and the run stops at that amount.
- **Apify Free plan preview:** 5 runs, each with up to 100 creators, and analytics on the first 10 creators of each run. Any paid Apify plan removes every limit.

### FAQ

**How accurate are the revenue figures?**
TikTok does not publish creator revenue. `revenue` is a market estimate of the sales a creator drove, made to compare and rank creators, not an accounting figure and not the creator's earnings.

**How do I find TikTok Shop affiliates for my products?**
Pick your market, add your category under **Categories** or a keyword under **Keywords**, set **Creator type** to **Independent creators** and a follower range that suits your budget, and sort by **Revenue**. To find creators who already sell a similar product, put that product's link into **Products**.

**Can I get the creators' e-mail addresses?**
Yes, when the creator lists one. Switch on **Add analytics**: each row then carries `email` and the WhatsApp, Instagram, Facebook, LINE and Zalo fields, filled only when the creator lists that channel. In our tests about half of the creators listed an e-mail. See "Contacting creators responsibly" above before you reach out.

**What does a keyword match?**
The creator's name and username. In our Indonesian test, `beauty` returned 3 creators, each with "beauty" in the name, and `matchStrict` was true on all 3.

**Does a creator sell through videos or live streams?**
Every row has `videoRevenue`, `liveRevenue` and their share of revenue. Sort by **Video revenue** or **Live revenue** to rank creators by one channel.

**Can I see the creators of one shop or product?**
Yes. Put the store link or shop ID into **Shops**, or the product link or ID into **Products**. Each becomes its own list, ranked by revenue.

**Which countries are covered?**
24 TikTok Shop markets: the United States, the United Kingdom, Germany, France, Italy, Spain, Poland, the Netherlands, Belgium, Czechia, Austria, Greece, Portugal, Hungary, Ireland, Indonesia, Thailand, Vietnam, the Philippines, Malaysia, Singapore, Japan, Mexico and Brazil.

**Can I get a past month or my own date range?**
Yes. Set **Month** (for example `2026-10`) or **From date** and **To date** for a window of up to 31 days that ends yesterday or earlier.

**How many creators can I get?**
Up to 10,000 per input with `maxResultsPerSource`. Long lists can end earlier when fewer creators match the window and filters.

**Can I use it in my own tools or with an AI agent?**
Yes. Start runs and read results with the Apify Python and JavaScript clients, connect it to n8n, Make, Zapier or Google Sheets, trigger it on a schedule or with webhooks, or let AI agents call it through the Apify MCP server.

**Is it legal to scrape TikTok Shop?**
The actor works without any TikTok login or account. You are responsible for how you use the data, including data-protection and anti-spam laws when you contact creators, and TikTok's terms.

### More TikTok Shop data from Zen Studio

- [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper): the best-selling products by revenue, with units sold, live stock and SKU prices, and the products a creator sells.
- [TikTok Shop Top Shops Scraper](https://apify.com/zen-studio/tiktok-shop-top-shops-scraper): the best-selling shops by revenue, with affiliate and own-account sales.
- [TikTok Shop Live Sales Scraper](https://apify.com/zen-studio/tiktok-shop-live-sales-scraper): the live streams that sell the most, and which hosts are live right now.
- [TikTok Shop Top Videos Scraper](https://apify.com/zen-studio/tiktok-shop-top-videos-scraper): the videos that sell the most, with engagement rate, ad flag and ad ROAS.
- [TikTok Shop Product Scraper](https://apify.com/zen-studio/tiktok-shop-product-scraper): search products by keyword in 16 marketplaces, with variant stock and the videos promoting them.
- [TikTok Shop Review Scraper](https://apify.com/zen-studio/tiktok-shop-review-scraper): every buyer review of the products these creators sell.

### Support

Found a bug or need a field? Open an issue on the **Issues** tab and we will get back to you.

# Actor input Schema

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

Leave every source empty for the overall top creators of the country. Each keyword is its own ranked list of creators matching it (by name or username), for example <code>beauty</code> or <code>fitness</code>.

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

TikTok Shop category names or IDs, each a separate list: <code>Beauty & Personal Care</code>, <code>Kitchen Appliances</code>, <code>601450</code>.

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

Store links (<code>shop.tiktok.com/us/store/…/7495…</code>), shop IDs or exact shop names: the creators of each shop.

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

TikTok Shop product links or IDs: the creators selling each product.

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

TikTok Shop market.

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

Sales window for revenue, units and growth. A month or a date range below overrides it.

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

Upper limit of creators from each keyword, category, shop or product (or from the overall top list). Duplicates across sources are delivered and charged once. Apify Free plan preview: up to 100 creators per run.

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

Optional, overrides Period: a calendar month such as <code>2026-10</code>.

## `dateFrom` (type: `string`):

Optional custom window, up to 31 days ending yesterday or earlier. Overrides Month and Period. Give both dates.

## `dateTo` (type: `string`):

Last day of the custom window (inclusive).

## `currency` (type: `string`):

Currency of every revenue and price figure. "Local" uses the market's own currency.

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

Order of each list, highest first.

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

Reverse the order: lowest values first.

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

Only rows with at least this revenue in the period, in the chosen currency.

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

0 = no ceiling.

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

Follower floor of the creator.

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

0 = no ceiling.

## `creatorType` (type: `string`):

Independent affiliate creators or shops' own accounts.

## `engagementRate` (type: `string`):

Engagement band: low under 8%, medium 8 to 20%, high over 20%.

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

Adds contact e-mail and WhatsApp, Instagram, Facebook, LINE and Zalo when listed, bio, creator type, video and live views and GPM, new followers, counts and day-by-day revenue. Each such row is charged one extra analytics event. Apify Free plan preview: analytics on the first 10 creators of each run.

## `feedback` (type: `string`):

For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.

## Actor input object example

```json
{
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 20,
  "currency": "USD",
  "sortBy": "revenue",
  "ascending": false,
  "creatorType": "all",
  "engagementRate": "any",
  "addAnalytics": false
}
```

# Actor output Schema

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

No description

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

No description

# 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("zen-studio/tiktok-shop-top-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("zen-studio/tiktok-shop-top-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 zen-studio/tiktok-shop-top-creators-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zen-studio/tiktok-shop-top-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/q2v6x52Qe3lyvGhYs/builds/4SPkAcY2Rs9A1kVQd/openapi.json
