# TikTok Influencer Search: Find Creators by Niche (`deepmine/tiktok-influencer-search`) Actor

Find TikTok influencers by niche keyword (fitness coach, skincare, nail artist) and filter by follower range: username, name, followers, total likes, bio, verified badge and profile link, in TikTok's own order. Up to about 250 accounts per keyword. No login.

- **URL**: https://apify.com/deepmine/tiktok-influencer-search.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 accounts

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 Influencer Search: Find Creators by Niche

Type a niche and get the **TikTok creators** TikTok's Users search shows for it, kept to the **follower range** you set: username, name, followers, total likes, bio, verified badge and profile link.

| Creator | 👤 Name | 📝 Bio | 👥 Followers | ❤️ Likes | 🔍 Niche | 🏅 Rank |
|---|---|---|---:|---:|---|---:|
| [@paulaschoice](https://www.tiktok.com/@paulaschoice) | Paula's Choice | Skincare that keeps its promises. Shop PaulasChoic… | 188,900 | 1,353,884 | skincare | 7 |
| [@dermalogica](https://www.tiktok.com/@dermalogica) | dermalogica | skin: we treat it all Shop at Sephora + Ulta Beaut… | 168,900 | 1,703,547 | skincare | 8 |
| [@nailvesta\_official](https://www.tiktok.com/@nailvesta_official) | NailVesta | 💅100% Handmade Nails - Salon Quality 💕Every girl d… | 120,200 | 370,285 | nail artist | 4 |

<sub>Collected 2026-09-28 with skincare and nail artist, 10,000 to 500,000 followers, up to 50 per niche: 86 creators in range, 114 outside it skipped and not charged. Every row also has the full bio, avatar, verified badge, user ID and secUid.</sub>

**$1.60 per 1,000 accounts** on the Starter plan ($2.00 Free, $1.20 Scale, $1.00 Business). The prefilled run (up to 200 creators) costs about $0.32.

### Why this one

- **Follower range filter.** Set `minFollowers` / `maxFollowers` (say 10k to 500k) to keep only micro and mid-size influencers. Creators outside the range are skipped and cost nothing.
- **Lead-list ready.** Followers, total likes and the full bio in every row; many creators put contact details or a shop link in their bio, and the profile is one click away.
- **Up to ~250 accounts per niche.** The Actor pages through everything TikTok's Users search shows logged-out visitors (245 for "fitness coach", 254 for "skincare", 255 for "nail artist" on 2026-09-27) and keeps the ones in range.
- **Many niches per run**, each with its own limit and summary. Rows come niche by niche, in your order, each in TikTok's order with its **rank**.
- **Handles TikTok's picky search.** TikTok answers this search on only some IPs. The Actor tries fresh IPs until one answers, then keeps using it for the whole run.
- **Fails loudly, never silently.** Every run saves a per-keyword summary (`OUTPUT`). If TikTok refuses a keyword on every retry, the run is marked failed instead of quietly returning less.

No TikTok account, login or cookies.

### Input

| Field | What it does | Default |
|---|---|---|
| `keywords` | Niches, one per line: `skincare`, `nail artist`, `real estate agent`, `fitness coach`. | `skincare`, `nail artist` |
| `minFollowers` | Keep only creators with at least this many followers. `0` = no minimum. | 0 (the form starts at 10,000) |
| `maxFollowers` | Keep only creators with at most this many followers. `0` = no maximum. | 0 (the form starts at 500,000) |
| `maxUsersPerKeyword` | Creators to keep per niche, up to 1,000 (TikTok shows up to about 250). With a follower range, only creators in range count. | 100 |
| `proxyConfiguration` | Apify Proxy. Keep datacenter (the default): the Actor finds IPs TikTok answers on by itself; residential doesn't help here. | Apify datacenter |

Example:

```json
{
  "keywords": ["skincare", "nail artist"],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "maxUsersPerKeyword": 250
}
```

**A follower range returns fewer rows.** TikTok shows about 250 accounts per keyword, and the range can't add more: the Actor pages through all of them and keeps the ones in range, so a narrow range may give a few dozen creators, or none. Add more niches to get more creators. `rank` stays the creator's position in TikTok's full results. An account whose follower count TikTok doesn't send is left out of a range, since it can't be shown to be in it.

### Output

One row per creator, niche by niche in your order, each niche's creators in TikTok's order. Two table views in the Console:

- **📊 Overview**: 🖼️ Photo, 🏷️ Username, 👤 Name, 📝 Bio, 🔗 TikTok, ✔️ Verified, 👥 Followers, ❤️ Likes, 🔍 Keyword, 🏅 Rank
- **📈 Stats**: 🏷️ Username, 🔗 TikTok, ✔️ Verified, 👥 Followers, ❤️ Likes, 🔍 Keyword, 🏅 Rank

#### Output fields

Every row has these keys, in this order. A value TikTok didn't send is `null` (never an empty string or a made-up 0).

- `avatar`: profile picture.
- `name`: display name.
- `bio`: the full bio, line breaks kept.
- `bioSnippet`: the bio's first 50 characters on one line, for tables.
- `username`: TikTok username, without @.
- `profileUrl`: the profile on TikTok.
- `verified`: TikTok's verified badge.
- `followers`: followers (TikTok rounds large counts in search results).
- `likes`: total likes on all their videos.
- `rank`: position in TikTok's results for the keyword.
- `keyword`: the niche keyword (your input).
- `userId`: TikTok's user ID.
- `secUid`: TikTok's secUid, the ID its own web API uses.
- `scrapedAt`: when it was collected (UTC).

Example row:

```json
{
  "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/85673e0bc2420528b1cb5a21966ad609~tplv-tiktokx-cropcenter:100:100.webp?...",
  "name": "Paula's Choice",
  "bio": "Skincare that keeps its promises.\nShop PaulasChoice.com",
  "bioSnippet": "Skincare that keeps its promises. Shop PaulasChoic…",
  "username": "paulaschoice",
  "profileUrl": "https://www.tiktok.com/@paulaschoice",
  "verified": true,
  "followers": 188900,
  "likes": 1353884,
  "rank": 7,
  "keyword": "skincare",
  "userId": "6794212752015705093",
  "secUid": "MS4wLjABAAAAvUq171LsRcV510QQZJEKzm6ba6CFFvnSXXA-e7lLAdm3Maw8vM-eC5pOw5sjEhfR",
  "scrapedAt": "2026-09-28T00:28:06Z"
}
```

Notes:

- `rank` is the creator's position in TikTok's results; with a follower range, accounts left out keep their place, so gaps are normal.
- TikTok's search shows only these profile fields and no emails. For following count, video count, bio link and join date, run the usernames through our TikTok Profile & Videos API with `maxVideosPerProfile: 0`.
- TikTok rounds large follower counts in search (188.9K shows as `188900`).
- **Image links expire.** `avatar` is signed by TikTok and stops working about 2 days after the run. Download the images you need soon after the run.

#### Run summary (`OUTPUT`)

```json
{
  "results": 86,
  "answeringIps": 1,
  "outage": false,
  "inputs": [
    {"input": "skincare", "status": "ok", "results": 50, "stopReason": "max_results", "keyword": "skincare", "filteredOut": 36},
    {"input": "nail artist", "status": "ok", "results": 36, "stopReason": "end", "keyword": "nail artist", "filteredOut": 78}
  ]
}
```

`filteredOut`: the accounts TikTok showed for that niche that were outside your follower range (skipped, not charged).

`status` per keyword: `ok`, `no_results` (TikTok shows nothing, or hides results for that term), `invalid`, `blocked` (no IP TikTok answered on after many tries; the run fails so you notice), `stopped` (your spending limit). `stopReason`: `max_results`, or `end` when TikTok showed no more accounts.

If TikTok answers user search on none of the IPs the Actor tries (a TikTok outage, for example), the run stops early after about 160 tries instead of retrying every keyword, fails with a clear message and sets `"outage": true` in `OUTPUT`. Keywords it couldn't collect cost nothing; creators already delivered stay in your dataset. Try again later.

### How long does a run take?

Finding an IP TikTok answers on usually takes 10 to 60 seconds (it varies through the day). After that, each niche takes a few seconds. Several niches in one run are cheaper and faster than one run per niche.

### Pricing

Pay per result, no start fee and no minimum. Example: 1,000 creators cost $1.60 on the Starter plan.

| Your Apify plan | Per 1,000 accounts |
|---|---|
| Free | $2.00 |
| Starter | $1.60 |
| Scale | $1.20 |
| Business | $1.00 |

You pay only for rows that reach your dataset. Niches with no results, invalid inputs and accounts outside your follower range cost nothing. When your spending limit is reached, the run stops.

### FAQ

**Do I need a TikTok account?** No. The Actor reads only what TikTok shows logged-out visitors.

**Does it find emails?** No. TikTok search doesn't show emails; some creators put contact details in their bio, which is in every row.

**Why do results stop after ~250?** TikTok stops showing new accounts for a search at about that point; the Actor ends the search there instead of paying you for repeats. Use more niche keywords (`skincare routine`, `skincare for men`) to reach more creators.

**The same creator under two niches?** They get a row under each niche, each with its own `rank`.

**Can I find creators by what they post, not by their name?** Use our TikTok Video Search API: every video row carries its creator and follower count.

### Feedback

Missing a field, or a result that doesn't look right? Open an issue on the **Issues** tab and we'll look into it. If the data helps you, a short review on this page helps other people find it.

# Actor input Schema

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

Niche keywords, one per line, as you'd type them in TikTok's Users search: skincare, nail artist, real estate agent, fitness coach.

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

Keep only creators with at least this many followers (0 = no minimum). TikTok shows about 250 accounts per keyword, so a follower range returns fewer rows: only the creators in range, and you pay only for those.

## `maxFollowers` (type: `integer`):

Keep only creators with at most this many followers (0 = no maximum). 10000 to 500000 keeps micro and mid-size creators. TikTok rounds large counts (3.6M = 3,600,000).

## `maxUsersPerKeyword` (type: `integer`):

Creators to keep per keyword, in TikTok's order; with a follower range, only creators in range count. TikTok shows logged-out visitors up to about 250 accounts per search. You pay per creator.

## `proxyConfiguration` (type: `object`):

TikTok is reached through Apify Proxy. TikTok answers this search on only some IPs; the Actor tries fresh datacenter IPs until one answers. Residential proxies don't help here.

## Actor input object example

```json
{
  "keywords": [
    "skincare",
    "nail artist"
  ],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "maxUsersPerKeyword": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "keywords": [
        "skincare",
        "nail artist"
    ],
    "minFollowers": 10000,
    "maxFollowers": 500000,
    "maxUsersPerKeyword": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/tiktok-influencer-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 = {
    "keywords": [
        "skincare",
        "nail artist",
    ],
    "minFollowers": 10000,
    "maxFollowers": 500000,
    "maxUsersPerKeyword": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("deepmine/tiktok-influencer-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 '{
  "keywords": [
    "skincare",
    "nail artist"
  ],
  "minFollowers": 10000,
  "maxFollowers": 500000,
  "maxUsersPerKeyword": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call deepmine/tiktok-influencer-search --silent --output-dataset

```

## MCP server setup

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