# TikTok Shop Search Scraper (`apimy/tiktok-shop-search-scraper`) Actor

Search TikTok Shop US by keyword and get products with price, original price, discount, units sold, revenue estimate, rating, review count and shop. Typical run: a 30-product search in about 20 seconds. Example input: {"keywords": \["air fryer"], "country": "US", "maxProducts": 30}

- **URL**: https://apify.com/apimy/tiktok-shop-search-scraper.md
- **Developed by:** [Nikita Iakovlev](https://apify.com/apimy) (community)
- **Categories:** E-commerce, Social media
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

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

### What does TikTok Shop Search Scraper do?

**TikTok Shop Search Scraper** takes product keywords and returns what a shopper sees in TikTok Shop search: one row per product with **title, price, discount, units sold, estimated revenue, rating, review count, shop, labels and 7- / 30-day sales**. No login, no cookies, no browser.

- **Typical run:** a 30-product search in about 20 seconds (7–40 s over 40 identical runs on 19 November 2026, median 10 s).
- **Example input:** `{"keywords": ["air fryer"], "maxProducts": 30}`
- Keyword search exists on **TikTok Shop US**. For product pages by link use [TikTok Shop Product Scraper](https://apify.com/apimy/tiktok-shop-product-scraper).

### What data can you get from a TikTok Shop search?

| Field | Example | Notes |
|---|---|---|
| `position` | `1` | Rank in the results for this keyword |
| `title` | `Sweetcrispy 6.34QT Stainless Steel Air Fryer…` | |
| `price`, `currency` | `76.67`, `USD` | Current price |
| `originalPrice`, `discountPercent` | `116.99`, `34` | Empty when the product is not discounted |
| `soldCount` | `15356` | Units sold since listing |
| `estimatedRevenue` | `1177345` | `price × soldCount` |
| `sold7d`, `sold30d`, `revenue7d`, `revenue30d` | `499`, `2055` | From our daily sales history; empty for products we have not tracked yet |
| `salesHistory`, `trackedSince`, `soldSinceTracked` | | Daily points of the last 30 days |
| `rating`, `reviewCount` | `4.6`, `2693` | |
| `shopName`, `sellerId` | | |
| `brand`, `labels`, `variantCount` | `["Free shipping"]` | `brand` is filled only when the seller set one |
| `imageUrl`, `url`, `productId` | | |
| `sourceInput`, `foundVia` | `air fryer`, `search` | Which keyword produced the row and how it was found |

With **Open every product page** on, each row also gets `variants` (price and stock per variant), `totalStock`, `minPrice`, `maxPrice`, `ratingBreakdown`, `description`, `specifications`, `images`, `shipping`, `categories`, `topReviews` and `shop` (shop units sold, followers, rating).

### How to scrape TikTok Shop search results

1. Type one or more keywords into **Keywords** — the words a shopper would type.
2. Set **Max products per keyword**.
3. Press **Start**. Download the table as JSON, CSV or Excel, or read it through the API.

```json
{
  "keywords": ["air fryer", "phone case"],
  "maxProducts": 50,
  "sortBy": "soldCount",
  "minRating": 4
}
```

#### Input options

| Field | What it does |
|---|---|
| `keywords` | Product keywords, one search each. A TikTok Shop search link (`shop.tiktok.com/us/s?q=…`) works too |
| `maxProducts` | Rows per keyword (default 30) |
| `sortBy` | TikTok's own order, or units sold, estimated revenue, 7-day sales, 30-day sales, rating, price up or down. Any order other than TikTok's reads up to 5× deeper and returns the top products by that measure |
| `productDetails` | Open every product page for variants, stock, description, images, shipping and shop stats. About 1–2 seconds more per product, same price per row |
| `minSoldCount`, `minPrice`, `maxPrice`, `minRating` | Filters. Products they remove are not charged |

### How many products does one keyword return?

TikTok Shop shows roughly **45 products for one keyword**. When you ask for more, the run continues the way a shopper would — through TikTok's own related searches and the related category — and marks every such row in `foundVia` (`related search: air fryer oven`). A broad keyword gives 100–150 products this way. When the list ends before your limit, the last row of the dataset is a free note that says so.

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

Pay per result, no subscription.

| Apify plan | Price per product | 1,000 products |
|---|---|---|
| Free | $0.012 | $12.00 |
| Starter (Bronze) | $0.0096 | $9.60 |
| Scale (Silver) | $0.0084 | $8.40 |
| Business (Gold) and above | $0.0072 | $7.20 |

Plus $0.0016 per run on paid plans, charged only when the run delivers at least one product. Products removed by your filters, duplicates and note rows are free. A run that finds nothing costs nothing.

### Notes that keep the table honest

- A keyword TikTok does not recognise (a typo like `zxqvkjw`) is answered by TikTok with random products. The Actor does not deliver or charge them — you get a free note instead.
- Search is published on the US shop only; a keyword with another country gets a free note.
- An empty input is a free note with a working example, not a paid demo run.
- If the run timeout is too short for the list, the rows read so far are delivered and a note says what timeout to set.
- With **Open every product page** on, a page TikTok did not open leaves the row with search-card fields and a `rowNote`.

### Use it from the API or an AI agent

```bash
curl -X POST "https://api.apify.com/v2/acts/apimy~tiktok-shop-search-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["air fryer"], "maxProducts": 30}'
```

The Actor works through the Apify MCP server: an agent passes `keywords` and `maxProducts` and reads product rows back.

### Is it legal to scrape TikTok Shop?

The Actor reads public product listings that any visitor sees without logging in. It collects no private user data. Check the rules that apply to your own use of the data.

### You might also like

| Actor | What it adds |
|---|---|
| [TikTok Shop Product Scraper](https://apify.com/apimy/tiktok-shop-product-scraper) | One product page by link, ID or name: variants, stock, description, shipping |
| [TikTok Shop Top Products](https://apify.com/lergassy/tiktok-shop-top-products-scraper) | Best-selling products with sales and revenue analytics |
| [TikTok Shop Videos Scraper](https://apify.com/lergassy/tiktok-shop-videos-scraper) | Videos that sell products, with views and revenue |
| [TikTok Shop Scraper](https://apify.com/lergassy/tiktok-shop-scraper) | Stores, categories, best sellers, creators and full reviews |
| [TikTok Shop Product API](https://apify.com/blueskyscraper/tiktok-shop-product-api) | Sales and revenue analytics for a product |

### Support

Found a keyword that returns fewer products than the TikTok Shop site shows? Open an issue on the Issues tab with the keyword — we answer within a day.

# Changelog

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

# Actor input Schema

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

Product keywords as a shopper would type them into TikTok Shop search — <b>air fryer</b>, <b>phone case</b>, <b>protein powder</b>. One search per keyword. A TikTok Shop search link (<code>shop.tiktok.com/us/s?q=…</code>) works too. Search runs on TikTok Shop US.

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

TikTok Shop market to search. Keyword search is published on <b>TikTok Shop US</b> only, so this is the one value; prices come in USD. For the UK and Southeast Asia read category, store or product links with <code>lergassy/tiktok-shop-scraper</code>.

## `maxProducts` (type: `integer`):

How many product rows to return for each keyword. TikTok Shop shows about 45 products for one keyword; above that the run continues with TikTok's own related searches and related category, and every row says how it was found (foundVia).

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

Any order other than TikTok's reads deeper into the results (up to 5× your limit) and returns the top products by this measure. Last 7 / 30 days come from our daily sales history; products not tracked yet go last.

## `productDetails` (type: `boolean`):

Off: fast search rows (title, price, discount, units sold, rating, shop, labels). On: also variants with stock, min/max price, rating breakdown, description, specifications, all images, shipping, category path, latest reviews and shop stats — about 1–2 seconds more per product, same price per row.

## `minSoldCount` (type: `integer`):

Skip products with fewer units sold. Skipped products are free.

## `minPrice` (type: `integer`):

Skip products cheaper than this. 0 = no floor.

## `maxPrice` (type: `integer`):

Skip products more expensive than this. 0 = no ceiling.

## `minRating` (type: `integer`):

Skip products rated below this (1–5). 0 = keep all, including products without reviews.

## `concurrency` (type: `integer`):

How many product pages to open at the same time.

## Actor input object example

```json
{
  "keywords": [
    "air fryer"
  ],
  "country": "US",
  "maxProducts": 30,
  "sortBy": "relevance",
  "productDetails": false,
  "minSoldCount": 0,
  "minPrice": 0,
  "maxPrice": 0,
  "minRating": 0,
  "concurrency": 5
}
```

# Actor output Schema

## `products` (type: `string`):

One row per product found: rank, price, discount, units sold, revenue estimate, rating and shop.

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

Every row of the run: products plus free notice rows (type field tells them apart).

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

JSON counters for the run: rows delivered, filtered out, duplicates, errors and request statistics.

# 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 = {
    "keywords": [
        "air fryer"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("apimy/tiktok-shop-search-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 = { "keywords": ["air fryer"] }

# Run the Actor and wait for it to finish
run = client.actor("apimy/tiktok-shop-search-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 '{
  "keywords": [
    "air fryer"
  ]
}' |
apify call apimy/tiktok-shop-search-scraper --silent --output-dataset

```

## MCP server setup

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