# Tiktok Shop Search Scraper (`web_wanderer/tiktok-shop-search-scraper`) Actor

Search TikTok Shop by any keyword and export product prices, ratings, reviews, sold counts, and seller details as clean, ready-to-use data.

- **URL**: https://apify.com/web\_wanderer/tiktok-shop-search-scraper.md
- **Developed by:** [Billy](https://apify.com/web_wanderer) (community)
- **Categories:** E-commerce, Automation, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## TikTok Shop Search Scraper

Search TikTok Shop by any keyword and get the top products, with prices, ratings, reviews, and seller info in clean structured JSON.

#### Why use this actor?

- Search TikTok Shop for any list of keywords.
- Get a fixed number of top products per query.
- See price, discount, rating, review count, sold count, and the seller for every product.
- No browsing and no login. Just paste your keywords.
- Clean, flattened output that loads straight into a spreadsheet or database.

### Features

- Searches every query you provide and collects up to max\_products\_per\_query products each.
- Returns product data: title, URL, photo, price, original price, discount percent, price range across variants, rating, review count, and sold count.
- Returns seller data for each product: seller ID, shop name, and shop logo.
- Handles multi-variant products with per-variant prices.
- Optional filters: require a minimum rating or show deals only.
- Deduplicates products across pages so every product appears once in the output.

### Example input

```json
{
  "queries": ["eyelashes", "skincare"],
  "max_products_per_query": 20,
  "min_rating": "any",
  "deals": false,
  "region": "US"
}
```

### Output example

Each product is one record, tagged with the query that produced it.

```json
{
  "record_type": "product",
  "search_query": "eyelashes",
  "search_position": 325,
  "product_id": "1732085814361100785",
  "title": "OKAYLOVE Manga Cluster Lashes Kit, Wispy 8-18MM DIY Lash Extension Kit, Lightweight Reusable False Eyelashes (Bunny, Bunny Lite) - Beauty Products, Nature-Infused, Recommended by .melmel.07,  #sohochic #backtoschool",
  "product_url": "https://shop.tiktok.com/us/pdp/bunny-lite-lash-clusters-by-okaylove-diy-eyelash-kit-waterproof-long-lasting-bond-gift-for-natural-m/1732085814361100785",
  "product_photo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/40857641c98a450ab960ade61789ab65~tplv-fhlh96nyum-crop-webp:1000:1000.webp",
  "image_urls": [
    "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/40857641c98a450ab960ade61789ab65~tplv-fhlh96nyum-crop-webp:1000:1000.webp",
    "https://p19-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/40857641c98a450ab960ade61789ab65~tplv-fhlh96nyum-crop-webp:1000:1000.webp"
  ],
  "rating": 4.7,
  "review_count": 752,
  "sold_count": 9252,
  "currency": "USD",
  "currency_symbol": "$",
  "sale_price": "19.77",
  "origin_price": null,
  "discount": null,
  "price_prefix": "From",
  "min_sale_price": "19.77",
  "max_sale_price": "54.98",
  "sku_id": "1729476632346531313",
  "skus": [
    {
      "sku_id": "1732085841414099441",
      "sale_price": "33.98",
      "origin_price": "67.99",
      "discount": 50.0,
      "currency": "USD"
    },
    {
      "sku_id": "1732085841414164977",
      "sale_price": "27.98",
      "origin_price": "48.99",
      "discount": 43.0,
      "currency": "USD"
    }
  ],
  "seller_id": "7495883420187855345",
  "shop_name": "OKAYLOVE",
  "shop_logo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/3abcf949ecb149019ac214e1ca4a5a2a~tplv-fhlh96nyum-resize-png:300:300.png",
  "labels": ["Back to School"],
  "promotion_id": "7672459768275435790",
  "free_shipping": false,
  "region": "US",
  "page": 3,
  "scrapedAt": "2026-08-26T00:00:00+00:00"
}
```

Products with multiple variants include `min_sale_price`, `max_sale_price`, and a `skus` array with per-variant prices. Fields with no value come back as `null` so the output stays consistent.

### Use cases

- Competitor price and catalog monitoring by keyword.
- Market research on what ranks for a search term.
- Building a product database from specific search terms.
- Tracking new products that appear for a keyword.

### Privacy & personal information

This actor collects public business data about TikTok Shop products and the shops that sell them. It does not collect personal information about individuals, such as customer names, private messages, or account details.

### Your responsibility

You are responsible for how you use this actor, the data you collect, and your compliance with TikTok's Terms of Service and any applicable laws and regulations.

### Tips

- Use plain keywords as queries. The actor searches TikTok Shop for each one exactly as written.
- Set max\_products\_per\_query to a small number when you only need the top results. Set it to 0 to collect every available result for a query.
- Use the filters to narrow results before they are collected. The rating filter (4 stars and up) returns only products rated at or above that level, and Deals-only returns only products currently on promotion.
- Search results can vary between runs because TikTok ranking changes over time.

### Need help?

Questions? Bugs? Something not working? Open an issue or reach out through Apify Support.

# Actor input Schema

## `queries` (type: `array`):

One search query per line. Each query is searched on TikTok Shop and returns up to max\_products\_per\_query products.

## `max_products_per_query` (type: `integer`):

Maximum products to collect per query. Set to 0 to collect all available results.

## `min_rating` (type: `string`):

Only return products rated at or above this.

## `deals` (type: `boolean`):

Only return products that are currently on deal or promotion.

## `region` (type: `string`):

Shop region to search.

## Actor input object example

```json
{
  "queries": [
    "eyelashes",
    "skincare"
  ],
  "max_products_per_query": 20,
  "min_rating": "any",
  "deals": false,
  "region": "US"
}
```

# Actor output Schema

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

Dataset with one product record per search result.

# 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 = {
    "queries": [
        "eyelashes",
        "skincare"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("web_wanderer/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 = { "queries": [
        "eyelashes",
        "skincare",
    ] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,web_wanderer/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/u8oAhP0El9R6yp06I/builds/Q5ZYwqgYDH5Kib3Rw/openapi.json