# TikTok Shop Top Shops Scraper - Seller Rankings (`zen-studio/tiktok-shop-top-shops-scraper`) Actor

Find the biggest TikTok Shop sellers in 24 markets: revenue, units sold, growth and the affiliate / own-account / shop-window split per shop, plus rating, followers, units sold to date and current best sellers from each TikTok store page. Rank by keyword or category, brands or retailers.

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

## Pricing

from $2.09 / 1,000 shops

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

[![See how much top TikTok shops sell through affiliates. Compare estimated revenue from affiliates, the shop’s own accounts and the storefront.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-top-shops-scraper-readme-hero-a302dbc792fd.png)](https://console.apify.com/actors/IKjOhtZj1dyUrZuxM/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**.

### Compare shops by affiliate sales

- See where shop sales come from. Compare the estimated revenue attributed to affiliates, the shop’s own TikTok accounts and its storefront.
- Go from shops to products. In the US beauty example, affiliates accounted for 93% of medicube’s estimated $30.4M in 30-day revenue. Store data includes best sellers, ratings and followers where available.
- **24 markets.** Choose a country and a reporting period. Sales and revenue figures are estimates.

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

#### Compare US beauty shops over 30 days

```json
{
  "categories": [
    "Beauty & Personal Care"
  ],
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 20,
  "addStoreData": true
}
```

[Open the actor input](https://console.apify.com/actors/IKjOhtZj1dyUrZuxM/input), paste the example in JSON view and press **Start**. Store data is on by default and included in the shop charge. Analytics and sales history cost extra when enabled.

#### Copy to your AI assistant

```text
Help me use zen-studio/tiktok-shop-top-shops-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-top-shops-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 or category is its own ranked list of shops capped by maxResultsPerSource; with no keyword or category the run returns the overall top shops of the country, and a shop found by several inputs is delivered and charged once. addStoreData is on by default and included in the shop price; addAnalytics and addSalesHistory are off by default and each adds its own charge per shop, about ten times the base row price, so switch them on only when I need those fields. Keywords found shops by their name in our tests; to rank the shops of a product type, use categories. Revenue and period units are estimates for comparing shops, not accounting figures. 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 shops, and addAnalytics and addSalesHistory apply to the first 10 shops 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 Shops Scraper do?

It ranks TikTok Shop shops by sales for the market and time window you choose, and returns one row per shop. Use it to find the biggest TikTok Shop sellers in a category, to see how competing brands sell (through affiliate creators or their own accounts), to find shops that could use more affiliates, or to compare the top sellers of several countries.

Each list is the top of TikTok Shop by your chosen order: revenue, units sold, revenue growth, average selling price, affiliate revenue, own-account revenue, shop-window revenue or products on sale. Live streams, videos, creators and products each have their own actor (see the end of this page).

### What you get beyond a plain shop ranking

| | |
|---|---|
| **Store data for every shop** | Shop rating, followers, units sold to date across all products, review count, products on sale, videos and TikTok's shop badge, from the shop's TikTok store page |
| **Each shop's current best sellers** | `storeTopProducts`: product ID, title, units sold to date, price, rating, reviews and image of the store's best sellers, most units sold first |
| **Revenue channels in percent** | Affiliate, own-account and shop-window revenue as amounts and as shares of the shop's revenue |
| **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 |
| **90-day sales history** | Optional day-by-day revenue for the last 90 days, whatever window you rank by |
| **A summary per input** | The run's OUTPUT record lists how many shops each input delivered and what to change for an input that found nothing |

### How to find the top TikTok Shop sellers

1. Pick a **🌍 Country** and a **📅 Period**. With nothing else set, you get the overall top shops of that market.
2. Optionally add **🔍 Keywords** or **🗂️ Categories**. Each entry is its own ranked list.
3. Set **🔢 Max results per source** (shops per list) and, if you like, a sort order, a shop type and revenue or price filters.
4. Press **Start** and export JSON, CSV, Excel or HTML. JSON keeps the nested best-seller and day-by-day lists.

#### Input options

| Parameter | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | list | empty | Each keyword is its own ranked list of shops matching it, for example `skincare` |
| `categories` | list | empty | TikTok Shop category names or IDs: `Beauty & Personal Care`, `Kitchen Appliances`, `601450` |
| `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` | Shops 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 | Order of each list; `ascending` puts the lowest first |
| `shopType` | select | `all` | `BRAND` for brand shops, `RETAILER` for retailers |
| Filters | numbers | off | Minimum and maximum revenue, minimum and maximum average selling price |
| `addStoreData` | switch | on | Store data from each shop's TikTok store page, included in the row price |
| `addAnalytics` | switch | off | Creator, product, video and live counts, top product IDs, day-by-day revenue. Extra charge per shop |
| `addSalesHistory` | switch | off | Day-by-day revenue for the last 90 days with 90-day revenue and units. Extra charge per shop |

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

#### More input examples

The top 50 brand shops in the UK last month, in British pounds:

```json
{
  "country": "GB",
  "month": "2026-10",
  "currency": "local",
  "shopType": "BRAND",
  "maxResultsPerSource": 50
}
```

Kitchen shops ranked by what they sell through their own TikTok accounts, a starting list for affiliate outreach:

```json
{
  "categories": [
    "Kitchen Appliances"
  ],
  "country": "US",
  "period": "last30Day",
  "sortBy": "ownAccountRevenue",
  "maxResultsPerSource": 100
}
```

The fastest-growing shops in the US over the last 7 days, with at least $50,000 revenue:

```json
{
  "country": "US",
  "period": "last7Day",
  "sortBy": "revenueGrowth",
  "minRevenue": 50000,
  "maxResultsPerSource": 100
}
```

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

| Group | Fields |
|---|---|
| **Shop** | `shopId`, `shopName`, `shopUrl`, `imageUrl`, `shopType`, `shopTypeLabel`, `productsOnSale`, `categoryIds`, `categoryNames`, `categoryPaths` |
| **Sales in the window** | `revenue`, `unitsSold`, `avgSellingPrice`, `revenueGrowthPercent`, `rank` |
| **How it sells** | `affiliateRevenue`, `ownAccountRevenue`, `shopWindowRevenue` and their shares in percent |
| **Store data** | `shopRating`, `shopFollowers`, `unitsSoldTotal`, `reviewCount`, `storeProductCount`, `shopVideoCount`, `shopLabel`, `shopLogoUrl`, `storeTopProducts`, `storeHasMoreProducts`, `storeStatus`, `storeCheckedAt` |
| **Analytics (option)** | `creatorCount`, `productCount`, `videoCount`, `liveCount`, `topProductIds`, `dailyRevenue`, `revenueYesterday`, `revenue7d`, `revenue28d` |
| **90-day history (option)** | `dailyRevenue90d`, `revenue90d`, `unitsSold90d` |
| **Context** | `type`, `country`, `period`, `periodStart`, `periodEnd`, `currency`, `source`, `sourceInput`, `category`, `matchStrict`, `analytics`, `salesHistory`, `scrapedAt` |

#### Output example

The first row of the beauty example above (US, last 30 days, real run). The store page listed 20 best sellers for this shop; two are shown.

```json
{
  "type": "shop",
  "shopId": "7495514739648989419",
  "shopName": "medicube US Store",
  "shopUrl": "https://shop.tiktok.com/us/store/shop/7495514739648989419",
  "imageUrl": "https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3fda6fbf695c4a8792a3059b4e1546e3~tplv-omjb5zjo8w-resize-webp:800:800.jpeg",
  "shopType": "BRAND",
  "shopTypeLabel": "Brand shop",
  "revenue": 30412537.69,
  "unitsSold": 1029053,
  "avgSellingPrice": 29.55,
  "revenueGrowthPercent": 2.4,
  "affiliateRevenue": 28289081.89,
  "ownAccountRevenue": 992469.45,
  "shopWindowRevenue": 1130986.35,
  "affiliateRevenueSharePercent": 93.02,
  "ownAccountRevenueSharePercent": 3.26,
  "shopWindowRevenueSharePercent": 3.72,
  "productsOnSale": 164,
  "categoryIds": [
    "601450"
  ],
  "categoryNames": [
    "Beauty & Personal Care"
  ],
  "categoryPaths": [
    "Beauty & Personal Care > Skincare > Skin Care Kits"
  ],
  "matchStrict": null,
  "analytics": false,
  "salesHistory": false,
  "rank": 1,
  "country": "US",
  "period": "last30Day",
  "periodStart": null,
  "periodEnd": null,
  "currency": "USD",
  "source": "category",
  "sourceInput": "Beauty & Personal Care",
  "category": "Beauty & Personal Care",
  "scrapedAt": "2026-11-10T14:02:19Z",
  "shopRating": 4.6,
  "shopFollowers": 754816,
  "unitsSoldTotal": 10978978,
  "reviewCount": 663100,
  "storeProductCount": 163,
  "shopVideoCount": 1130,
  "shopLabel": "OFFICIAL SHOP",
  "shopLogoUrl": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3fda6fbf695c4a8792a3059b4e1546e3~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=8dbd94bf&idc=useast5&from=2422056039",
  "storeTopProducts": [
    {
      "productId": "1729508370969629931",
      "title": "[medicube] PDRN Pink Collagen Volume Multi Balm | All In One Volufiline, PDRN, NAD Stick for Youthful-Looking, Helping Look of Fine Lines, Firming Care, Anti-Aging Care | For Under-Eyes, Neck, Forehead, Smile Lines, Lip Care | Korean Skincare",
      "unitsSoldTotal": 1203814,
      "price": 27.3,
      "currency": "USD",
      "rating": 4.2,
      "reviewCount": 69242,
      "imageUrl": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9bc5a612ca8c4a8ca00dddc0c0906cbc~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839"
    },
    {
      "productId": "1732052189676081387",
      "title": "[medicube] Smooth & Clear Body Care Set | Hypochlorous Acid Body Peel Shot, Kojic Acid Turmeric Body Wash, Toner Pad, Toner, Mist | Exfoliating for Dead Skin Cells & Excess Sebum & Clearing for After Spots, Texture & Uneven Skin Tone | K-Beauty",
      "unitsSoldTotal": 663034,
      "price": 87.1,
      "currency": "USD",
      "rating": 4.6,
      "reviewCount": 36486,
      "imageUrl": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/5cf5212fe8f3451fb063a8ee7d0c1de1~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839"
    }
  ],
  "storeHasMoreProducts": true,
  "storeStatus": "ok",
  "storeCheckedAt": "2026-11-10T14:02:21Z"
}
```

#### Analytics and 90-day history fields

With `addAnalytics` and `addSalesHistory` switched on, a row also carries the fields below. This excerpt shows only those fields of a real US row from the last 30 days; `dailyRevenue` (30 values) and `dailyRevenue90d` (90 values) are cut to their last 7.

```json
{
  "shopId": "7495514739648989419",
  "analytics": true,
  "creatorCount": 48872,
  "productCount": 198,
  "videoCount": 211871,
  "liveCount": 37278,
  "topProductIds": [
    "1732052189676081387",
    "1732293553906094315",
    "1732685687477735659"
  ],
  "dailyRevenue": [
    780046.24,
    941311.59,
    850640.89,
    1401168.1,
    1584977.08,
    1716918.72,
    1578812.89
  ],
  "revenueYesterday": 1578812.89,
  "revenue7d": 8853875.51,
  "revenue28d": 26926114.74,
  "salesHistory": true,
  "dailyRevenue90d": [
    780046.24,
    941311.59,
    850640.89,
    1401168.1,
    1584977.08,
    1716918.72,
    1578812.89
  ],
  "revenue90d": 71333696.61,
  "unitsSold90d": 2375475
}
```

#### Store data status

`storeStatus` tells you how complete the store data of a row is:

- `ok`: the shop's store page was read.
- `unavailable in this market`: TikTok does not show this shop's store page in the market. The row keeps every sales figure.
- `not available right now`: the store page could not be read during this run. The row keeps every sales figure; run it again later for the store data.

In the 20-shop beauty run above (US, 10 November 2026), 19 shops carried store data; TikTok showed no store page in the US for the other one.

#### Run summary

Besides the dataset, each run writes an **OUTPUT** record to its key-value store, also linked on the run's Output tab:

```json
{
  "delivered": 0,
  "duplicatesSkipped": 0,
  "country": "US",
  "period": "lastDay",
  "currency": "USD",
  "inputs": [
    {
      "input": "qzxvw jjkqp nonexistent",
      "kind": "keyword",
      "rows": 0,
      "status": "no-results",
      "error": "No results for this input with the chosen country, period and filters."
    }
  ]
}
```

### Use cases

- **Competitor research for sellers and brands.** The biggest shops of your category this month, how much of their revenue comes from affiliate creators, and which of their products sell best right now.
- **Affiliate and agency prospecting.** Sort by own-account revenue, or compare `affiliateRevenueSharePercent`, to find shops that sell mostly through their own accounts, then look up creators who sell in the same niche with the [TikTok Shop Top Creators Scraper](https://apify.com/zen-studio/tiktok-shop-top-creators-scraper).
- **Brand and market-share tracking.** Run the same category every week on a schedule and compare revenue, growth and followers of the top shops between runs.
- **Market sizing across countries.** Compare the top sellers of one category in the US, UK, Germany and Indonesia side by side in US dollars.
- **Product research.** Take a top shop's ID into the [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper) to rank everything it sells, with stock and SKU prices.

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

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

- The store data (rating, followers, units sold to date, best sellers) is included in the shop price.
- **Analytics** and the **90-day sales history** are optional. Each adds its own charge per shop, about ten times the base shop price, so a row with both costs roughly 21 times a plain row. The Pricing tab lists the exact amounts.
- A shop 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 shops, and analytics and the sales history on the first 10 shops of each run. Any paid Apify plan removes every limit.

### FAQ

**How accurate are the revenue and units sold figures?**
TikTok does not publish revenue. `revenue`, `unitsSold` and the affiliate, own-account and shop-window split are market estimates, made to compare and rank shops, not accounting figures. `unitsSoldTotal` is different: it is the lifetime units-sold counter TikTok shows on the shop's store page.

**How do I find the biggest TikTok Shop sellers right now?**
Leave every input empty, pick your country and choose **Yesterday** or **Last 7 days** as the period. The list is ordered by revenue; switch **Sort by** to **Units sold** for the shops with the most orders.

**What do affiliate, own-account and shop-window revenue mean?**
Affiliate revenue comes from creators who promote the shop's products in their videos and live streams. Own-account revenue comes from the shop's own TikTok accounts. Shop-window revenue comes from the shop page and product cards. The three add up to the shop's revenue, and each also comes as a percent share.

**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.

**Does a keyword search shop names or what the shops sell?**
In our test, `skincare` in the UK returned ten shops, each with "Skincare" in its name. To rank the shops that sell a product type, use **Categories**, for example `Beauty & Personal Care`.

**Can I keep only brands or only retailers?**
Yes. Set **Shop type** to **Brand shops** or **Retailers**.

**Why do some shops have no rating or followers?**
TikTok does not show some store pages in some markets. Those rows keep every sales figure, and `storeStatus` says why the store data is missing.

**How do I see everything one shop sells?**
Put the shop ID from `shopId` into **Shops** of the [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper). It ranks that shop's products with revenue, stock and SKU prices.

**How many shops can I get?**
Up to 10,000 per input with `maxResultsPerSource`. Long lists can end earlier when fewer shops 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 applicable laws 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.
- [TikTok Shop Live Sales Scraper](https://apify.com/zen-studio/tiktok-shop-live-sales-scraper): the live streams that sold the most, with viewers and revenue per hour.
- [TikTok Shop Top Videos Scraper](https://apify.com/zen-studio/tiktok-shop-top-videos-scraper): the shoppable videos with the highest revenue, views and engagement.
- [TikTok Shop Top Creators Scraper](https://apify.com/zen-studio/tiktok-shop-top-creators-scraper): the affiliate creators who sell the most, with followers, categories and revenue.
- [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 shops 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 shops of the country. Each keyword is its own ranked list of shops matching it (by shop name), for example <code>skincare</code> or <code>kitchen</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>.

## `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 shops from each keyword or category (or from the overall top list). Duplicates across sources are delivered and charged once. Apify Free plan preview: up to 100 shops 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.

## `minPrice` (type: `number`):

Average selling price floor.

## `maxPrice` (type: `number`):

0 = no ceiling.

## `shopType` (type: `string`):

Keep brand shops or retailers only.

## `addStoreData` (type: `boolean`):

Reads each shop's TikTok store page: rating, followers, units sold to date, review count and its current best sellers. Included in the row price.

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

Adds creator, product, video and live counts, the top product IDs and day-by-day revenue. Each such row is charged one extra analytics event. Apify Free plan preview: analytics on the first 10 shops of each run.

## `addSalesHistory` (type: `boolean`):

Adds day-by-day revenue for the last 90 days, 90-day revenue and units, and exact yesterday, 7- and 28-day revenue, whatever the period. Each such row is charged one extra sales-history event. Apify Free plan preview: the sales history on the first 10 shops 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,
  "shopType": "all",
  "addStoreData": true,
  "addAnalytics": false,
  "addSalesHistory": 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-shops-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-shops-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-shops-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-shops-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/IKjOhtZj1dyUrZuxM/builds/GhKoSf5TZhf57QP6c/openapi.json
