# TikTok Shop Creator Finder (`om_kh/tiktok-shop-creator-finder`) Actor

Find TikTok Shop creators worth an affiliate invite: shop activity, engagement, category fit and public contact — with the source URL behind every field.

- **URL**: https://apify.com/om_kh/tiktok-shop-creator-finder.md
- **Developed by:** [Khandji Omar](https://apify.com/om_kh) (community)
- **Categories:** E-commerce, Lead generation, MCP servers
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 qualified creators

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

## TikTok Shop Creator Finder — Affiliates Worth Inviting

> **You paste a niche or a username list. You get creators actually running**
> **TikTok Shop content —** engagement, category fit, and a public business
> contact where one exists, every field with its own source.

### Free tier — 3 results free on every run

The free results waive this Actor's own fee; the source Actor (clockworks/tiktok-scraper) still bills its own price for every row it returns.

**The first 3 results of every run are free**, on every run you ever make — not a one-off trial. One guard: the free allowance never covers more than half of a run, so the offer stays sustainable.

### Concentration risk, written plainly

The target market for this niche is heavily concentrated: a handful of large
accounts drive most of the volume. This is a real, useful product, but not a
broad one — know that going in.

### Honest about what "shop activity" means

Sales volume and GMV are never delivered unless publicly observable, and
they are not, on TikTok's public profile pages. This Actor reports exactly
one real, verified signal: whether a creator's recent videos are flagged as
TikTok Shop content. `affiliate_signal` is `observed` or `unknown` — never a
guessed sales figure, and `products_promoted` stays empty rather than
inventing product detail TikTok does not expose publicly.

### 5 advantages

1. **One bad handle never kills your batch.**
2. **Never billed on a failed lookup.**
3. **Score with reasons, not a black box** — `qualification_score` ships
   with `score_reasons[]`.
4. **No fabricated sales data.** `shop_active` is a real observed signal,
   never an estimate.
5. **Hard cost cap you control.** Set `maxTotalChargeUsd`.

### Output

A real row from this Actor's latest run on Apify (2026-10-23; long texts are cut and people's names hidden here, your dataset has them in full):

```json
{
  "status": "ok",
  "username": "(hidden here)",
  "profile_url": "https://www.tiktok.com/@dailynchannel",
  "nickname": "(hidden here)",
  "follower_band": "macro",
  "median_recent_views": 1670,
  "engagement_rate": 0.0347,
  "posting_cadence_days": 5.2,
  "last_video_at": "2026-10-23T19:18:19Z",
  "shop_active": true,
  "affiliate_signal": "observed",
  "public_contact": {
    "email": "(hidden here)",
    "kind": "business_email",
    "source": "https://www.tiktok.com/@dailynchannel",
    "verification_level": "published"
  },
  "qualification_score": 71,
  "score_reasons": [
    "median recent views 1,670 (1 pts)",
    "engagement rate 3.47% (20 pts)"
  ]
}
```

### Pricing

- **Source Actor charge:** this Actor runs [clockworks/tiktok-scraper](https://apify.com/clockworks/tiktok-scraper) inside your run, and Apify bills that run to your account at clockworks/tiktok-scraper's own price (about $3.7 per 1,000 results, read on 2026-10-23), on top of this Actor's price. Each call to it is capped at $0.50.
  Pay per event, base FREE-tier prices: **$0.03** per qualified creator delivered, **$0.002** per observed shop activity signal.
  Paid Store plans pay less on every event — the largest plans reach $0.0011 on the cheapest event; the Pricing tab on this Actor's Store page is
  always the authority. **No event is ever charged on an item that returns an `error`** —
  a batch of 200 with one bad input bills 199.

### Use it from an AI agent (MCP and x402)

Connect Claude Desktop, Cursor, VS Code or any MCP client to Apify's MCP server
at `https://mcp.apify.com` and add this Actor, `om_kh/tiktok-shop-creator-finder`, as a tool — the
agent passes the same JSON as the run input and gets the dataset back.

AI agents that pay with **x402** can run it too, without an Apify account: the
Actor charges only per result delivered, so an agent pays exactly for what it gets.

### Related Actors

- [TikTok Creator Search Scraper](https://apify.com/om_kh/tiktok-creator-search-scraper) — the same creator engine without the Shop-activity filter
- [Taobao Tmall Product Scraper](https://apify.com/om_kh/taobao-tmall-product-scraper) — verify the products a Shop creator promotes

### Support

Found a bug or have a feature request? Use the **Issues** tab on this
Actor's Apify Store page, or message the author (`om_kh`) directly.

### Example input

```json
{
  "keywords": [
    "tiktokmademebuyit"
  ]
}
```

### How to use it in 3 steps

1. Click **Try for free**; the form opens with a ready example in **Niche keywords**.
2. Optional: change the other fields; every one has a description and a sensible default.
3. Click **Start** and download the results as JSON, CSV or Excel, or read them from the API.

### Compared with lemur/tiktok-shop-creators

Read on the Store on 2026-10-26 (75 users in 30 days). Where it does better, this section says so.

- **Its price model:** $0.005 per run start plus the platform usage of the run, whatever it finds; this Actor charges per qualified creator ($0.03) and per shop signal, and nothing for creators that do not qualify.
- **Only here:** a category-fit and engagement reading per creator, and the public business contact with its source when one exists.
- **Where it does better:** it starts from TikTok Shop's own creator pages, this Actor starts from a niche or a username list and checks shop activity in the creators' posts.

### Use cases

- **Find affiliates** for a TikTok Shop brand in a niche (beauty, fitness, home...).
- **Qualify a creator list** you already have before sending invitations.
- **Agency prospecting:** creators already selling, with a public contact when they publish one.

### FAQ

**What counts as "shop activity"?** Posts that link or tag TikTok Shop products, as read in the creator's recent videos; the README section above explains the limits.

**Do I pay for creators that do not qualify?** No, only qualified creators and shop signals are charged.

**Do I need a TikTok account?** No.

**Can I cap the cost?** Yes, set `maxTotalChargeUsd`.

### Your feedback

Did this Actor save you time? A short review on the **Reviews** tab helps other people find it, and every review is read. Something missing or broken? Open an issue on the **Issues** tab: it is answered and fixed fast.

# Actor input Schema

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

Niches or hashtags to search for shop-active creators in, e.g. 'tiktokmademebuyit' or 'skincare'. Shopping hashtags return the most shop-active creators.

## `usernames` (type: `array`):

Creators you already have. Full URL, @handle, or bare handle all work.

## `categories` (type: `array`):

Keep only creators whose recent hashtags overlap with these categories, e.g. 'beauty', 'fitness'.

## `hasShopActivity` (type: `boolean`):

Only deliver creators with at least one recent video flagged as TikTok Shop content.

## `minFollowers` (type: `integer`):

Skip creators below this follower count.

## `minMedianRecentViews` (type: `integer`):

Skip creators whose recent videos median below this view count. Filtering happens before billing.

## `maxResults` (type: `integer`):

Stop after this many qualified creators.

## `monitorEnabled` (type: `boolean`):

On later runs with the same Monitor ID, deliver only creators not seen before.

## `monitorId` (type: `string`):

Groups runs into one monitored target. Leave blank for a one-off run.

## `maxTotalChargeUsd` (type: `number`):

Hard ceiling on what this run can bill you.

## Actor input object example

```json
{
  "keywords": [
    "tiktokmademebuyit"
  ],
  "hasShopActivity": true,
  "minMedianRecentViews": 0,
  "maxResults": 100,
  "monitorEnabled": false
}
```

# Actor output Schema

## `report` (type: `string`):

A visual summary of delivery, charges, and source issues.

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

Qualified creators in a sortable table. No JSON knowledge required.

## `csv` (type: `string`):

Results ready for spreadsheets, CRMs, and analytics tools.

## `excel` (type: `string`):

Results as an Excel workbook for non-technical teams.

## `runSummary` (type: `string`):

Machine-readable delivery, billing, and source diagnostics.

# 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": [
        "tiktokmademebuyit"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("om_kh/tiktok-shop-creator-finder").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": ["tiktokmademebuyit"] }

# Run the Actor and wait for it to finish
run = client.actor("om_kh/tiktok-shop-creator-finder").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": [
    "tiktokmademebuyit"
  ]
}' |
apify call om_kh/tiktok-shop-creator-finder --silent --output-dataset

```

## MCP server setup

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

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/yJYLMmZlc8ysilhZ0/builds/GhnWgufk2sExKH4cG/openapi.json