# TikTok Shop Top Products Scraper - Sales & Stock (`zen-studio/tiktok-shop-top-products-scraper`) Actor

Find TikTok Shop best sellers in 24 markets: revenue, units sold, growth and the video / live / shop-window split per product, plus TikTok's units-sold counter, stock and SKU prices from each product page. Rank by keyword, category, shop, creator, video or live stream.

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

## Pricing

from $2.09 / 1,000 products

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 Shop best sellers and check their stock. Compare estimated units sold with checked stock and variant prices.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-top-products-scraper-readme-hero-7572739202a0.png)](https://console.apify.com/actors/QHRLJgUf6Xjhj67cr/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 best sellers and check their stock

- Rank products by sales. Get estimated units sold, revenue and growth for a keyword, category, shop or market.
- Check each variant. Stock and SKU prices are included by default where available. The example shows 69,599 estimated units sold in seven days and 34,274 units in stock at the time of the check.
- **24 markets.** Choose a country and a reporting period. Sales and revenue figures are estimates.

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

#### Run a seven-day US best-seller search

```json
{
  "country": "US",
  "period": "last7Day",
  "maxResultsPerSource": 20,
  "addStoreData": true
}
```

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

#### Copy to your AI assistant

```text
Help me use zen-studio/tiktok-shop-top-products-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-top-products-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, creator, video or live stream is its own ranked list capped by maxResultsPerSource, and a product found by several inputs is delivered and charged once. addAnalytics and addSalesHistory are off by default and each adds its own charge per product, about ten times the base row price, so switch them on only when I need the extra fields. Revenue and period units are estimates for comparing products, 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 products, and addAnalytics and addSalesHistory apply to the first 10 products 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 Products Scraper do?

It ranks TikTok Shop products by sales for the market and time window you choose, and returns one row per product. Use it to find the best-selling products on TikTok Shop right now, to see what trends in a category, to research what a competing shop or a creator sells, or to size a market across countries.

Each list is the top of TikTok Shop by your chosen order: revenue, units sold, revenue growth, video revenue, live revenue, shop-window revenue, commission rate, average selling price or newest launch.

### What you get beyond a plain sales ranking

| | |
|---|---|
| **TikTok's own units-sold counter** | `unitsSoldTotal` is the exact number of units sold since listing, as TikTok shows it on the product page |
| **Stock and SKU prices** | Current price, original price and stock for every variant, total stock and an in-stock flag |
| **Product page details** | Rating, review count, brand, attributes, shipping fee, delivery days, shop rating, followers and badge |
| **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 |
| **More ways in** | Rank the products shown in a TikTok video or sold in a live stream, next to keywords, categories, shops and creators |
| **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 products each input delivered and what to change for an input that found nothing |

### How to scrape TikTok Shop best sellers

1. Pick a **🌍 Country** and a **📅 Period**. With nothing else set, you get the overall top products of that market.
2. Optionally add **🔍 Keywords**, **🗂️ Categories**, **🏪 Shops**, **👤 Creators**, **🎬 Videos** or **🔴 Live streams**. Each entry is its own ranked list.
3. Set **🔢 Max results per source** (products per list) and, if you like, a sort order and filters.
4. Press **Start** and export JSON, CSV, Excel or HTML. JSON keeps the nested SKU, attribute and day-by-day lists.

#### Input options

| Parameter | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | list | empty | Each keyword is its own ranked list, for example `air fryer` or `lip gloss` |
| `categories` | list | empty | TikTok Shop category names or IDs: `Kitchen Appliances`, `Beauty & Personal Care`, `601450` |
| `shops` | list | empty | Store links, shop IDs or exact shop names: that shop's best sellers |
| `creators` | list | empty | `@username`, profile link or creator ID: the products that creator sold |
| `videoIds`, `liveIds` | list | empty | TikTok video links or IDs, live stream IDs: the products shown or sold in them |
| `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` | Products 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 |
| Filters | numbers, selects | off | Revenue, average price and commission ranges; affiliate program, fulfilled by TikTok, shipping type, launch date; include products without sales; strict keyword match |
| `addStoreData` | switch | on | Live store data from each product page, included in the row price |
| `addAnalytics` | switch | off | Creator, video and live counts, price range, delivery type, description, day-by-day revenue. Extra charge per product |
| `addSalesHistory` | switch | off | Day-by-day revenue for the last 90 days with 90-day revenue and units. Extra charge per product |

Keyword lists also include close matches. Every keyword row carries `matchStrict`, true when the title holds every word of the keyword; switch on **Strict keyword match** to keep only those.

#### More input examples

The top 50 beauty products in the UK last month, in British pounds:

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

The fastest-growing new products in the US over the last 30 days, with at least $10,000 revenue:

```json
{
  "country": "US",
  "period": "last30Day",
  "sortBy": "revenueGrowth",
  "launchedWithin": "last7Days",
  "minRevenue": 10000,
  "maxResultsPerSource": 100
}
```

Everything one shop sells, best sellers first, with the 90-day history:

```json
{
  "shops": [
    "7495373657684019285"
  ],
  "country": "US",
  "period": "last30Day",
  "addSalesHistory": true,
  "maxResultsPerSource": 20
}
```

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

| Group | Fields |
|---|---|
| **Product** | `productId`, `title`, `url`, `imageUrl`, `images`, `launchDate`, `productAgeDays`, `categoryIds`, `categoryNames`, `categoryPath` |
| **Sales in the window** | `revenue`, `unitsSold`, `avgSellingPrice`, `revenueGrowthPercent`, `rank` |
| **Where it sells** | `videoRevenue`, `liveRevenue`, `shopWindowRevenue` and their shares in percent, `creatorRevenueSharePercent`, `commissionRatePercent` |
| **Live store data** | `unitsSoldTotal`, `rating`, `reviewCount`, `listPriceMin`, `listPriceMax`, `listPriceCurrency`, `skus`, `stockTotal`, `inStock`, `freeShipping`, `shippingFee`, `deliveryDaysMin`, `deliveryDaysMax`, `brand`, `specifications`, `storeStatus`, `storeCheckedAt` |
| **Shop** | `shopId`, `shopName`, `skuCount`, `shopRating`, `shopFollowers`, `shopProductCount`, `shopLabel`, `sellerInfo` |
| **Analytics (option)** | `minPrice`, `maxPrice`, `creatorCount`, `videoCount`, `liveCount`, `deliveryType`, `deliveryTypeLabel`, `dailyRevenue`, `revenueYesterday`, `revenue7d`, `revenue28d`, `description` |
| **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 air fryer example above (US, last 7 days, real run). The product has 4 SKUs and 8 images; two of each are shown.

```json
{
  "type": "product",
  "productId": "1732390274888863829",
  "title": "Ninja French Door Premier Air Fryer, Convection Oven, Toaster - FO101",
  "url": "https://shop.tiktok.com/us/pdp/1732390274888863829",
  "imageUrl": "https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e5b26ab8e31248f28722652d7b762b7b~tplv-omjb5zjo8w-resize-webp:800:800.jpeg",
  "revenue": 157777.84,
  "unitsSold": 655,
  "avgSellingPrice": 240.88,
  "revenueGrowthPercent": -81.17,
  "videoRevenue": 143383.49,
  "liveRevenue": 13594.39,
  "shopWindowRevenue": 799.96,
  "videoRevenueSharePercent": 90.88,
  "liveRevenueSharePercent": 8.62,
  "shopWindowRevenueSharePercent": 0.51,
  "creatorRevenueSharePercent": 99.49,
  "commissionRatePercent": 5,
  "launchDate": "2026-05-12",
  "productAgeDays": 182,
  "shopId": "7495373657684019285",
  "shopName": "Ninja Kitchen US",
  "skuCount": 4,
  "categoryIds": [
    "600942",
    "844168",
    "848264"
  ],
  "categoryNames": [
    "Household Appliances",
    "Kitchen Appliances",
    "Countertop Ovens"
  ],
  "categoryPath": "Household Appliances > Kitchen Appliances > Countertop Ovens",
  "matchStrict": true,
  "analytics": false,
  "salesHistory": false,
  "rank": 1,
  "country": "US",
  "period": "last7Day",
  "periodStart": null,
  "periodEnd": null,
  "currency": "USD",
  "source": "keyword",
  "sourceInput": "air fryer",
  "category": null,
  "scrapedAt": "2026-11-10T12:40:57Z",
  "unitsSoldTotal": 1662,
  "rating": 4.6,
  "reviewCount": 60,
  "listPriceMin": 363.99,
  "listPriceMax": 389.99,
  "listPriceCurrency": "USD",
  "skus": [
    {
      "skuId": "1732390272491753557",
      "options": "Color: Stainless Steel",
      "price": 363.99,
      "originalPrice": null,
      "stock": 397,
      "purchaseLimit": 200,
      "available": true
    },
    {
      "skuId": "1732390272491819093",
      "options": "Color: Black",
      "price": 389.99,
      "originalPrice": null,
      "stock": 0,
      "purchaseLimit": 200,
      "available": false
    }
  ],
  "stockTotal": 397,
  "inStock": true,
  "freeShipping": true,
  "shippingFee": 0,
  "deliveryDaysMin": 6,
  "deliveryDaysMax": 9,
  "brand": "NINJA",
  "specifications": [
    {
      "name": "Brand",
      "value": "NINJA"
    },
    {
      "name": "Dangerous goods or hazardous materials",
      "value": "No"
    },
    {
      "name": "Warranty type",
      "value": "Manufacturer warranty"
    },
    {
      "name": "Door material type",
      "value": "Stainless Steel"
    },
    {
      "name": "Door style",
      "value": "French door"
    },
    {
      "name": "Control type",
      "value": "Button"
    }
  ],
  "images": [
    "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e5b26ab8e31248f28722652d7b762b7b~tplv-fhlh96nyum-crop-webp:800:800.webp?dr=12190&t=555f072d&ps=933b5bde&shp=c940a200&shcp=9b759fb9&idc=useast5&from=3376456192",
    "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/9659b3e154054da284f9a6a8a2cdd0ce~tplv-fhlh96nyum-crop-webp:800:800.webp?dr=12190&t=555f072d&ps=933b5bde&shp=c940a200&shcp=9b759fb9&idc=useast5&from=3376456192"
  ],
  "shopRating": 4.8,
  "shopFollowers": 2155453,
  "shopProductCount": 67,
  "shopLabel": "OFFICIAL SHOP",
  "sellerInfo": [
    "Business name: SharkNinja Sales Company",
    "Business address: 89 A Street,Needham,Massachusetts,02494"
  ],
  "storeStatus": "ok",
  "storeCheckedAt": "2026-11-10T12:40:59Z"
}
```

#### 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 7 days; the description is cut to its first sentence and `dailyRevenue90d`, which holds 90 values, to its last 7.

```json
{
  "productId": "1732052189676081387",
  "analytics": true,
  "minPrice": 67.0,
  "maxPrice": 202.8,
  "creatorCount": 3155,
  "videoCount": 7978,
  "liveCount": 1277,
  "deliveryType": "local",
  "deliveryTypeLabel": "Ships from inside the market",
  "dailyRevenue": [
    237181.0,
    322989.0,
    264027.0,
    160766.0,
    127162.0,
    316138.0,
    450089.0
  ],
  "revenueYesterday": 450089.0,
  "revenue7d": 1878352.0,
  "revenue28d": 5927727.0,
  "description": "Smooth, clear, and brighten your skin with every shower!",
  "salesHistory": true,
  "dailyRevenue90d": [
    237181.0,
    322989.0,
    264027.0,
    160766.0,
    127162.0,
    316138.0,
    450089.0
  ],
  "revenue90d": 14694755.5,
  "unitsSold90d": 481073
}
```

#### Store data status

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

- `ok`: the product page was read.
- `from the shop page`: TikTok restricts this product's page in the market; units sold to date, price and rating come from the shop's listing instead.
- `unavailable in this market`: TikTok does not show this product's page in the market. The row keeps every sales figure.
- `not available right now`: the page could not be read during this run. The row keeps every sales figure; run it again later for the store data.

In a 100-product run for `air fryer` in the US on 10 November 2026, 87 products carried units sold to date; TikTok showed no product page in the US for the other 13.

#### 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

- **Product research and dropshipping.** Find the top selling TikTok Shop products in a category this week, with their price, stock and the commission creators earn.
- **Trending and winning products.** Sort by revenue growth, or keep products launched in the last 3 or 7 days, to catch rising products early.
- **Affiliate research.** See which products pay commission and sell through creators' videos and live streams, then look up the creators with the [TikTok Shop Top Creators Scraper](https://apify.com/zen-studio/tiktok-shop-top-creators-scraper).
- **Competitor and brand tracking.** Rank a rival shop's catalogue, or your own brand's, every week with a schedule, and compare revenue, units and stock between runs.
- **Market sizing across countries.** Run the same category in the US, UK, Germany and Indonesia side by side in US dollars.

### How much does it cost to scrape TikTok Shop best sellers?

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

- The live store data (stock, SKU prices, units sold to date) is included in the product price.
- **Analytics** and the **90-day sales history** are optional. Each adds its own charge per product, about ten times the base product price, so a row with both costs roughly 21 times a plain row. The Pricing tab lists the exact amounts.
- A product 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 products, and analytics and the sales history on the first 10 products 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 video, live and shop-window split are market estimates, made to compare and rank products, not accounting figures. `unitsSoldTotal` is different: it is TikTok's own lifetime counter from the product page.

**How do I find the best-selling products on TikTok Shop 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 most-ordered products.

**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 do I see what one shop or one creator sells?**
Put the store link, shop ID or exact shop name in **Shops**, or the `@username` in **Creators**. Each becomes its own ranked list. Switch on **Include products without sales** for a shop's full catalogue.

**Why do some rows have no stock or units sold to date?**
TikTok restricts some product pages in some markets, including some best sellers. Those rows keep every sales figure, and `storeStatus` says why the store data is missing.

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

**Is the 90-day history the same as a longer period?**
No. The period decides the ranking and the sales figures. The 90-day history adds day-by-day revenue for the last 90 days to each product, whatever period you rank by.

**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 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 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 you find here.

### 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 products of the country. Each keyword is its own ranked list of products matching it (by title), for example <code>air fryer</code> or <code>lip gloss</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 products of each shop.

## `creators` (type: `array`):

TikTok usernames (<code>@name</code>), profile links or numeric creator IDs: the products of each creator.

## `videoIds` (type: `array`):

TikTok video links or IDs: the products shown in each video.

## `liveIds` (type: `array`):

Numeric live stream IDs: the products sold in each live stream.

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

## `minCommissionRate` (type: `number`):

Affiliate commission floor in percent.

## `maxCommissionRate` (type: `number`):

0 = no ceiling.

## `affiliateProducts` (type: `string`):

Keep products in, or outside, the affiliate program.

## `fulfilledByTikTok` (type: `string`):

Keep products fulfilled by TikTok, or the others.

## `deliveryType` (type: `string`):

Ships from inside the market or cross-border.

## `launchedWithin` (type: `string`):

Keep new or established products only.

## `includeZeroSales` (type: `boolean`):

Also list products that sold nothing in the period (useful for a full shop catalogue).

## `strictKeywordMatch` (type: `boolean`):

Keep only products whose title holds every keyword word. Every row carries <code>matchStrict</code> either way.

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

Reads each product's TikTok Shop page: exact units sold to date, rating, review count, current SKU prices and stock, shipping and brand. Included in the row price.

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

Adds creator, video and live counts, price range, delivery type, the description and day-by-day revenue with yesterday, 7- and 28-day totals. Each such row is charged one extra analytics event. Apify Free plan preview: analytics on the first 10 products 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 products 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,
  "affiliateProducts": "all",
  "fulfilledByTikTok": "all",
  "deliveryType": "all",
  "launchedWithin": "any",
  "includeZeroSales": false,
  "strictKeywordMatch": false,
  "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-products-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-products-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-products-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-products-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/QHRLJgUf6Xjhj67cr/builds/DcL8MF3sEUBpKnSGS/openapi.json
