# TikTok User Search 🔍 (`deepmine/tiktok-user-search`) Actor

Find TikTok accounts by keyword, as TikTok's Users search shows them: username, name, followers, total likes, bio, verified badge, avatar and profile link, with each account's rank. Keywords in, clean JSON out. No login.

- **URL**: https://apify.com/deepmine/tiktok-user-search.md
- **Developed by:** [DeepMine](https://apify.com/deepmine) (community)
- **Categories:** Social media, Videos
- **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 User Search API

Find **TikTok accounts by keyword**, the way TikTok's "Users" search tab shows them, as clean rows: username, display name, follower count, total likes, bio, verified badge, avatar, profile link and each account's **rank** in the results.

Type a niche, a name or a brand. No TikTok account, no cookies, no login.

| Account | 👤 Name | 📝 Bio | 👥 Followers | ❤️ Likes | 🔍 Keyword | 🏅 Rank |
|---|---|---|---:|---:|---|---:|
| [@trevorbell\_](https://www.tiktok.com/@trevorbell_) | Trevor Bell | Fitness Coach 🔹 Helping Men drop 10–15lbs 🔹Tap the… | 5,000,000 | 74,151,775 | fitness coach | 6 |
| [@rahulsfitness](https://www.tiktok.com/@rahulsfitness) | Online Fitness Coach | Helping Women Burn Fat Without Spending Hours In T… | 149,400 | 1,061,165 | fitness coach | 8 |
| [@bubble](https://www.tiktok.com/@bubble) | Bubble Skincare | Built by dermatologists. 🇺🇸Ulta, Walmart, Target,… | 4,100,000 | 25,806,095 | skincare | 2 |

<sub>Collected 2026-09-27 with `{"keywords": ["fitness coach", "skincare"], "maxUsersPerKeyword": 15}`. 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 (100 accounts) costs about $0.16.

### Why this one

- **Up to ~250 accounts per keyword.** 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).
- **Lead-list ready.** Follower count, total likes and the full bio come with every account: find contact hints in bios and open profiles with one click.
- **Follower range filter.** Set `minFollowers` / `maxFollowers` (say 10k to 500k) to keep only micro or mid-size creators. Accounts outside the range are skipped and cost nothing.
- **Many keywords per run**, each with its own limit and summary. Rows come keyword by keyword, in your order.
- **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, so you don't have to.
- **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.

### Input

| Field | What it does | Default |
|---|---|---|
| `keywords` | Search terms, one per line: `fitness coach`, `real estate agent`, `nail artist`. | `fitness coach` |
| `maxUsersPerKeyword` | Accounts per keyword, up to 1,000 (TikTok shows up to about 250). With a follower range, it counts the accounts you keep. | 100 |
| `minFollowers` | Keep only accounts with at least this many followers. `0` = no minimum. | 0 |
| `maxFollowers` | Keep only accounts with at most this many followers. `0` = no maximum. | 0 |
| `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": ["fitness coach", "real estate agent"],
  "maxUsersPerKeyword": 200
}
```

With a follower range:

```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 accounts, or none. Add more keywords to get more accounts. `rank` stays the account'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 account, keyword by keyword in your order, each keyword's accounts 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 search 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...",
  "name": "Bubble Skincare",
  "bio": "Built by dermatologists.\n🇺🇸Ulta, Walmart, Target, CVS, Amazon\n🇬🇧Boots, ASOS 🇨🇦Shoppers Drug Mart 🇦🇺Priceline, Woolworths 🖤Sephora ME",
  "bioSnippet": "Built by dermatologists. 🇺🇸Ulta, Walmart, Target,…",
  "username": "bubble",
  "profileUrl": "https://www.tiktok.com/@bubble",
  "verified": true,
  "followers": 4100000,
  "likes": 25806095,
  "rank": 2,
  "keyword": "skincare",
  "userId": "6686777110134309894",
  "secUid": "MS4wLjABAAAAFWOchAcsCCCbzd_y7DnpY8XB_5aIgPEoCgVvwXuRVIrZi25OEtLVsJNoRBqa49f4",
  "scrapedAt": "2026-09-27T19:07:59Z"
}
```

Notes:

- `rank` is the account'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. 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 (4.1M shows as `4100000`).
- **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": 491,
  "answeringIps": 1,
  "outage": false,
  "inputs": [
    {"input": "fitness coach", "status": "ok", "results": 245, "stopReason": "end", "keyword": "fitness coach"},
    {"input": "nail artist", "status": "ok", "results": 246, "stopReason": "end", "keyword": "nail artist"}
  ]
}
```

With a follower range, each keyword also carries `filteredOut`: the accounts TikTok showed that were outside the 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; accounts 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 keyword takes a few seconds. Several keywords in one run are cheaper and faster than one run per keyword.

### Pricing

Pay per result, no start fee and no minimum. Example: 1,000 accounts 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. Keywords 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.

**Why do results repeat 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.

**The same account under two keywords?** It gets a row under each keyword, 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`):

Search terms, one per line, e.g. a niche, a name or a brand. Example: fitness coach

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

Accounts to get per keyword, in TikTok's order. TikTok shows logged-out visitors up to about 250 accounts per search. You pay per account.

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

Keep only accounts 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 accounts in range, and you pay only for those.

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

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

## `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": [
    "fitness coach"
  ],
  "maxUsersPerKeyword": 100,
  "minFollowers": 0,
  "maxFollowers": 0,
  "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": [
        "fitness coach"
    ],
    "maxUsersPerKeyword": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("deepmine/tiktok-user-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": ["fitness coach"],
    "maxUsersPerKeyword": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("deepmine/tiktok-user-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": [
    "fitness coach"
  ],
  "maxUsersPerKeyword": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call deepmine/tiktok-user-search --silent --output-dataset

```

## MCP server setup

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