# TikTok Shop Creators Search (`lemur/tiktok-shop-creators-search`) Actor

Find high performing TikTok Shop creators by GMV, category, sales performance and more.

- **URL**: https://apify.com/lemur/tiktok-shop-creators-search.md
- **Developed by:** [Lemur](https://apify.com/lemur) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 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.

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

### 🔎 TikTok Shop Creators Search

> **Find the TikTok Shop creators that matter — by category, GMV, sales, audience, and more.**

**TikTok Shop Creators Search** is a creator discovery API for finding and analyzing TikTok Shop creators based on the metrics that actually matter for commerce.

Use structured filters to discover creators who match your exact criteria — from niche and audience size to GMV and units sold.

Build creator discovery tools, influencer marketplaces, affiliate recruitment platforms, competitive intelligence products, and internal creator databases on top of a continuously refreshed dataset.

***

### 🚀 What Can You Find?

Search TikTok Shop creators using a combination of:

- 🛍️ **Product category**
- 💰 **GMV (Gross Merchandise Value)**
- 📦 **Units sold**
- 🎯 **Follower demographics**
- 📊 **Creator commerce performance**
- 👤 **Creator profile information**

This means you can move beyond vanity metrics like follower count and discover creators based on their **actual TikTok Shop activity**.

#### Example

Instead of asking:

> "Who are the biggest creators in beauty?"

You can ask:

> "Find female-audience creators in Beauty & Personal Care with 10K+ GMV, 1,000+ units sold, and a specific follower demographic."

That's the kind of creator discovery this API is designed for.

***

### 🌍 Region Support

- ✅ **United States** — fully supported
- 🚧 **Other regions coming soon** (UK, TH, VN, EU, BR)

***

### 📈 Fresh Data, Every Day

Creator statistics represent **rolling 30-day performance** and are **refreshed daily**.

This gives you a current view of creator commerce activity rather than relying on lifetime or outdated performance numbers.

#### What does "rolling 30-day" mean?

A creator's GMV, units sold, and other performance metrics reflect their activity over the most recent 30-day period.

As new data becomes available, the window moves forward.

**Data freshness:** Daily\
**Performance window:** Rolling 30 days

For more detailed performance metrics use my other actor [TikTok Shop Creators](https://apify.com/lemur/tiktok-shop-creators) - TikTok Shop Creator Analytics

***

### 💡 Use Cases — What You Can Build

The API isn't just a creator search endpoint. It's a foundation for building products around TikTok Shop creator intelligence.

1. 🤝 **Influencer Discovery** — Build tools that help brands discover creators based on niche, audience, and commerce performance.
2. 💰 **Affiliate Recruitment** — Find creators who are already generating meaningful TikTok Shop GMV or sales and build targeted affiliate outreach lists.
3. 🏪 **Creator Marketplaces** — Create a searchable marketplace where brands can discover and filter creators according to their campaign requirements.
4. 🎯 **Brand-to-Creator Matching** — Match products and brands with creators based on product category, audience demographics, follower count, and commerce performance.
5. 📊 **Creator Intelligence Platforms** — Build dashboards that let users explore creator performance across categories, audiences, and commerce metrics.
6. 🔍 **Competitive Research** — Discover which creators are active in specific product categories and analyze the creator landscape.
7. 🧑‍💼 **Agency Tools** — Give influencer and affiliate agencies a structured creator database for prospecting, campaign planning, and creator sourcing.
8. 🛠️ **Internal Creator Databases** — Build your own searchable TikTok Shop creator database without manually collecting and organizing creator information.
9. 🤖 **AI-Powered Creator Discovery** — Build AI agents that turn natural-language requests into targeted creator searches and recommendations.
10. 🧲 **Creator Lead Generation** — Generate qualified lists of potential creators based on specific performance and audience criteria.

***

### 🧩 Related Actors

- [TikTok Shop Creators](https://apify.com/lemur/tiktok-shop-creators) - TikTok Shop creator analytics

***

### 📥 Inputs

The API supports the following search filters.

| Input                        | Description                                                            | Possible values                                                 |
| ---------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------- |
| `category`                   | Product category that the creator posts content in.                    | See the <a id="categories">Categories</a> section below         |
| `gmv`                        | Creator's Gross Merchandise Value over the rolling 30-day period.      | `0-100`, `100-1000`, `1000-10000`, `10000+`                     |
| `unitsSold`                  | Number of units sold over the rolling 30-day period.                   | `any`, \`\`0-10`, `10-100`, `100-1000`, `1000+`                  |
|`followerAge`               | Age range of the creator's followers.                                  |`all`, `18-24`, `25-34`, `35-44`, `45-54`, `55+`               |
|`followerCount.min`         | Minimum follower count.                                                | Any non-negative number                                         |
|`followerCount.max`         | Maximum follower count.                                                | Any non-negative number                                         |
|`followerGender.type`       | Gender to filter the creator's audience by.                            |`male`, `female`                                               |
|`followerGender.percentage` | Percentage of the creator's audience belonging to the selected gender. | Percentage value                                                |
|`performance.videoViews`    | Avgerage shoppable video views. Greater than or equal to value         | Number value (max 100000)                                       |
|`performance.liveViews`     | Avgerage shoppable live views. Greater than or equal to value          | Number value (max 100000)                                       |
|`performance.engagementRate`| Average shoppable content engagement rate                              | Percentage value (max 20)                                       |
|`commission`                | Creator average commission rate in percentage                          |`all`, `5`, `10`, `15`, `20`                                   |
|`content`                   | Creator content preference                                             |`any`, `video`, `live`                                         |
|`postRate`                  | How often a creator posts a video or live after receiving a sample     |`any`, `ok`, `good`, `better`                                  |
|`agencyStatus`              | Creator agency status                                                  |`any`, `agency-managed`, `independent`                         |
|`isFastGrowing`             | Top 10% of creators in revenue, views etc in the last 30 days          |`any`, `yes`, `no`                                             |
|`language`                  | Creator primary content language                                       |`all`, `english`, `spanish`, `chinese`                         |
|`creatorCount`              | Total creators to return (max 20/request)                              | Any non-negative number (default 10, max 20)                    |
|`region`                    | ISO 3166-2 country code                                                | Only`US`is supported at the moment. More regions coming soon. |
|`cacheKey`                  | To be used in subsequent requests. It improves query performance.      | The API will return this value after each request.              |
|`nextPageToken\`              | Use this to get the next page of results.                              | The API will return this value after each request.              |

> 💡 **Tip:** Filters can be combined to create highly specific creator searches.

For example, you could search for creators who are in **Beauty & Personal Care**, generate **$10K+ GMV**, have **1,000+ units sold**, and have a predominantly **female audience aged 25–34**.

#### ⚠️ Warning

- We're currently experiencing some difficulties with the category filter and as such advise you to use `All categories` for each request. This issue will be addressed shortly.

***

### 🏷️ Categories

The `category` input accepts the category ID.

| Category ID | Category                          |
| ----------- | --------------------------------- |
| `605196`    | Automotive & Motorcycle           |
| `602284`    | Baby & Maternity                  |
| `601450`    | Beauty & Personal Care            |
| `801928`    | Books, Magazines & Audio          |
| `951432`    | Collectibles                      |
| `601755`    | Computers & Office Equipment      |
| `605248`    | Fashion Accessories               |
| `700437`    | Food & Beverages                  |
| `604453`    | Furniture                         |
| `700645`    | Health                            |
| `604968`    | Home Improvement                  |
| `600001`    | Home Supplies                     |
| `600942`    | Household Appliances              |
| `953224`    | Jewelry Accessories & Derivatives |
| `802184`    | Kids' Fashion                     |
| `600024`    | Kitchenware                       |
| `824584`    | Luggage & Bags                    |
| `824328`    | Menswear & Underwear              |
| `602118`    | Pet Supplies                      |
| `601739`    | Phones & Electronics              |
| `856720`    | Pre-Owned                         |
| `601352`    | Shoes                             |
| `603014`    | Sports & Outdoor                  |
| `600154`    | Textiles & Soft Furnishings       |
| `604579`    | Tools & Hardware                  |
| `604206`    | Toys & Hobbies                    |
| `601152`    | Womenswear & Underwear            |

***

### ⚙️ How to Use

1. Enter inputs to filter creators by.
2. Run the actor.
3. Get structured JSON output with creator details.

You can run this actor directly on Apify or integrate it into your workflows via the Apify API.

***

### 💳 Pricing

The actor is billed at `$10 per 1000 returned creators`.

You are not billed for non-successful responses.

To get updates to actor stats, you can use the [TikTok Shop Creators](https://apify.com/lemur/tiktok-shop-creators) actor at `$5/1000 requests`.

***

### 💡 Please note

If the creator has not given permission for precise data sharing, the `gmv` value might not be available.

In this case, we fall back to the `gmvRange` which at least lets you know where a creator is at.

*If neither of these is available, you can run the creator username through our [TikTok Shop Creators](https://apify.com/lemur/tiktok-shop-creators) API for better luck.*

***

### 💸 Start Exploring TikTok Shop Creators Search

Find the creators that actually move commerce.

*Accurate. Structured. Actionable.*

### 📩 Contact

For any queries, requests for more data or consultation send an email to `lemurxn@gmail.com` ✌️

# Actor input Schema

## `category` (type: `array`):

Creator category

## `gmv` (type: `array`):

No description

## `unitsSold` (type: `array`):

No description

## `followersAge` (type: `array`):

Follower age range options

## `followerCount` (type: `object`):

Filter by creator follower count

## `followersGender` (type: `object`):

No description

## `performance` (type: `object`):

No description

## `commission` (type: `string`):

No description

## `content` (type: `string`):

No description

## `postRate` (type: `string`):

How often a creator posts a video or live after receiving a sample

## `agencyStatus` (type: `string`):

No description

## `isFastGrowing` (type: `string`):

Top 10% of creators in revenue, views etc in the last 30 days

## `language` (type: `array`):

No description

## `creatorCount` (type: `integer`):

Total creators to return (max 20/request)

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

ISO 3166-2 country code

## `cacheKey` (type: `string`):

The API returns this value for you to use in subsequent requests. It improves performance and ensures stable results.

## `nextPageToken` (type: `string`):

Pass this in to paginate results.

## Actor input object example

```json
{
  "category": [
    "all"
  ],
  "gmv": [
    "all"
  ],
  "unitsSold": [
    "any"
  ],
  "followersAge": [
    "all"
  ],
  "commission": "all",
  "content": "any",
  "postRate": "any",
  "agencyStatus": "any",
  "isFastGrowing": "any",
  "language": [
    "all"
  ],
  "creatorCount": 10,
  "region": "US"
}
```

# Actor output Schema

## `overview` (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 = {
    "category": [
        "all"
    ],
    "gmv": [
        "all"
    ],
    "unitsSold": [
        "any"
    ],
    "followersAge": [
        "all"
    ],
    "commission": "all",
    "content": "any",
    "postRate": "any",
    "agencyStatus": "any",
    "isFastGrowing": "any",
    "language": [
        "all"
    ],
    "creatorCount": 10,
    "region": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("lemur/tiktok-shop-creators-search").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 = {
    "category": ["all"],
    "gmv": ["all"],
    "unitsSold": ["any"],
    "followersAge": ["all"],
    "commission": "all",
    "content": "any",
    "postRate": "any",
    "agencyStatus": "any",
    "isFastGrowing": "any",
    "language": ["all"],
    "creatorCount": 10,
    "region": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("lemur/tiktok-shop-creators-search").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 '{
  "category": [
    "all"
  ],
  "gmv": [
    "all"
  ],
  "unitsSold": [
    "any"
  ],
  "followersAge": [
    "all"
  ],
  "commission": "all",
  "content": "any",
  "postRate": "any",
  "agencyStatus": "any",
  "isFastGrowing": "any",
  "language": [
    "all"
  ],
  "creatorCount": 10,
  "region": "US"
}' |
apify call lemur/tiktok-shop-creators-search --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lemur/tiktok-shop-creators-search"
        }
    }
}
```

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/me9tT4xrVQQvz8BCY/builds/Zr5TqaqfT3I73EOjQ/openapi.json