# TikTok Creator Search (`devcake/tiktok-creator-apify`) Actor

Find and scrape TikTok creators by niche, keyword, topic, or brand with an influencer search tool. Discover UGC creators and collect public profile data.

- **URL**: https://apify.com/devcake/tiktok-creator-apify.md
- **Developed by:** [devcake](https://apify.com/devcake) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 4 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

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 influencer search by niche, keyword, or name

This **TikTok influencer search tool** helps you discover public TikTok creators by creator name, username, niche, brand, or keyword. Enter up to 10 search terms and collect matching creator profiles in a structured Apify dataset—without a TikTok login, browser, phone, or emulator.

Turn searches such as `fitness coach`, `skincare`, `OpenAI`, or a username into ranked creator profiles. Every row retains the query that found it for easier review and shortlisting.

### ✨ What can this TikTok influencer search tool do?

- 🔍 **Search creators your way:** Use names, usernames, niches, topics, brands, or keywords.
- 📚 **Run multiple searches together:** Submit 1–10 queries in a single run.
- 🎯 **Choose your target size:** Request 20–1,000 creators per query. TikTok may return fewer when fewer matching accounts are available.
- 👤 **Enrich public profiles:** Optionally add bios, bio links, public counters, region, and full profile images.
- 🧹 **Keep results organized:** Duplicate suggestions are removed and every creator includes the originating query and search rank.
- 📤 **Export creator data:** Download JSON, CSV, Excel, XML, or another Apify-supported format.
- ⚙️ **Automate repeat searches:** Run the Actor through Apify Console, the API, client libraries, schedules, or integrations.

### 🚀 How to search for influencers on TikTok

1. Add a clear niche or keyword to **Search queries**, such as `vegan recipes`, `personal finance`, or `gaming creator`.
2. Add more queries to explore several niches, brands, or known creators in one run.
3. Choose a target from 20 to 1,000 creators per query.
4. Turn on **Enrich profiles** when you need public bios, bio links, full counters, region, and larger profile images.
5. Click **Start**, review the ranked results, and export or connect the dataset to your next workflow.

Use specific phrases such as `London fitness coach` or `sustainable fashion creator` for more focused results. A query guides TikTok's suggestions; it is not a location or audience filter.

### 📥 Input

| Field | Required | What it controls |
|---|---:|---|
| `searchQueries` | Yes | 1–10 creator names, usernames, niches, brands, or keywords. |
| `maxCreatorsPerQuery` | No | Target number of creators for each query, from 20 to 1,000. Default: 20. |
| `enrichProfiles` | No | Adds available public profile details. Default: `false`. |

#### Example search

```json
{
  "searchQueries": ["fitness coach", "sustainable fashion"],
  "maxCreatorsPerQuery": 100,
  "enrichProfiles": true
}
```

### 📤 What TikTok profile data is returned?

The Actor saves one row per discovered creator. Some counters can be empty in TikTok's suggestion response; enrichment requests more public profile fields when available.

| Data group | Available fields |
|---|---|
| Search context | Original query and result rank |
| Creator identity | TikTok user ID, secure user ID, username, nickname, profile URL, and avatar |
| Profile details | Bio, bio link, profile image, and region when enrichment succeeds |
| Audience and activity | Followers, following, total likes received, and video count when available |
| Account signals | Verified, business, private, TikTok Shop, seller, and live-status flags |
| Enrichment status | Whether profile enrichment was requested, enriched, partial, or unavailable |

#### Example search output

With `enrichProfiles` set to `false`, each discovery result has the following shape. TikTok may omit counters from its suggestion response, in which case their values are `null`.

```json
{
  "query": "fitness coach",
  "id": "1234567890123456789",
  "sec_uid": "MS4wLjABAAAA-example-secure-user-id",
  "unique_id": "coachmaya",
  "nickname": "Maya | Fitness Coach",
  "url": "https://www.tiktok.com/@coachmaya",
  "avatar": "tos-useast5-avt-0068-tx/example-avatar.jpeg",
  "follower_count": null,
  "video_count": null,
  "verified": false,
  "business": true,
  "private": false,
  "shop": false,
  "live": false,
  "search_rank": 1,
  "profile_enrichment_status": "not_requested",
  "profile_source": null
}
```

#### Example enriched profile output

With `enrichProfiles` set to `true`, a successful profile lookup enriches the same discovery row. The values below are illustrative; fields that are not public or available may be `null`.

```json
{
  "query": "fitness coach",
  "id": "1234567890123456789",
  "sec_uid": "MS4wLjABAAAA-example-secure-user-id",
  "unique_id": "coachmaya",
  "nickname": "Maya | Fitness Coach",
  "url": "https://www.tiktok.com/@coachmaya",
  "avatar": "https://p16-sign-va.tiktokcdn.com/example-avatar.jpeg",
  "avatar_uri": "tos-useast5-avt-0068-tx/example-avatar.jpeg",
  "signature": "Simple strength and mobility tips",
  "bioLink": "https://example.com/coachmaya",
  "follower_count": 125400,
  "following_count": 310,
  "total_likes_received": 2300000,
  "video_count": 412,
  "profile_image_url": "https://p16-sign-va.tiktokcdn.com/example-avatar.jpeg",
  "profile_region": "US",
  "profile_source": "profile-embedded-json",
  "verified": false,
  "business": true,
  "private": false,
  "shop": false,
  "live": false,
  "search_rank": 1,
  "profile_enrichment_status": "enriched"
}
```

### 💡 Popular use cases

#### Find TikTok influencers and micro-influencers

Search topics such as skincare, gaming, food, finance, travel, or fitness to find TikTok influencers, including smaller niche accounts, then export the results for campaign qualification.

#### TikTok creator discovery for brands and agencies

Run several product, competitor, or campaign terms together. Use search rank, account flags, and optional profile details to create a first-pass creator list.

#### TikTok user search by name or username

Run a TikTok user search with a display name, full username, or partial username to find matching public accounts and profile URLs.

#### Collect TikTok profile data

Enable enrichment to add available bios, bio links, counters, region, and full avatar URLs to discovery results.

#### Create a repeatable TikTok user search API workflow

Run searches through Apify's API or schedules, then send the dataset to spreadsheets, databases, dashboards, or other integrations.

### 🔄 A focused alternative to TikTok One and influencer platforms

This Actor is a focused alternative to TikTok One's Creator Marketplace and full influencer suites for public account discovery and structured data—not campaign management.

| Existing option | Best fit | When to choose this Actor |
|---|---|---|
| TikTok app search | Interactive, one-query browsing | Run 1–10 keywords or names together and save ranked public profiles. |
| TikTok One / Creator Marketplace | Official filters, analytics, invitations, and projects | Discover creators by keyword or name without TikTok One access, then export or automate the dataset. |
| HypeAuditor, Modash, or Heepsy | Broader databases, analytics, vetting, outreach, tracking, or payments | Use a focused TikTok workflow billed per result, with API access and optional public-profile enrichment. |

Choose this Actor for batch discovery, API or scheduled runs, and structured exports. Choose a full suite when you need audience demographics, engagement analysis, contact discovery, invitations, messaging, payments, or campaign reporting.

### 💵 Pricing

This Actor uses pay-per-result pricing with no start fee:

| Result | Price |
|---|---:|
| Discovered creator | **$0.005** |
| Successful profile enrichment | **+$0.002** |

For example, 100 regular creator results cost **$0.50**. If all 100 profiles are successfully enriched, the total is **$0.70**. A blocked, private, or unavailable profile still keeps its discovery row but does not incur the enrichment charge.

### 🔗 Related TikTok Actors

Need a different kind of TikTok data? Continue your research with these Actors:

- 🎬 **[TikTok Video & Comments Scraper](https://apify.com/devcake/tiktok-search-video-comments):** Search public TikTok videos by keyword, collect engagement metrics, and optionally extract public comments for trend, product, competitor, and audience research.
- 🛍️ **[TikTok Shop Data Scraper](https://apify.com/devcake/tiktok-shop-data-scraper):** Extract TikTok Shop product data, including prices, reviews, seller information, and categories for e-commerce research and product discovery.

### ⚠️ Important limitations

- The Actor returns **creator accounts**, not videos, comments, hashtags, follower lists, audience demographics, engagement rates, or private contact details.
- Search results come from TikTok's creator suggestions and are not a complete TikTok influencer database.
- The requested result count is a target, not a guarantee. A search stops when TikTok returns no new matching creators.
- The current search environment uses US routing and does not provide country, language, follower-range, engagement, or audience filters.
- Profile enrichment works only when a public profile is available. Unavailable profiles remain in the dataset with an appropriate status.
- Results can change as TikTok updates profiles, recommendations, and platform behavior.

### ❓ Frequently asked questions

#### How to find a TikTok creator?

Enter a creator name, username, niche, brand, or keyword in `searchQueries`, choose a target, and run the Actor. TikTok returns matching creator suggestions in ranked order. Enable enrichment for available bios and public account counters, then export the dataset to qualify the creators.

#### Can I search TikTok users by name?

Yes. The Actor works as a TikTok username search tool for public accounts. Search a full or partial display name or username to return available usernames, nicknames, profile URLs, TikTok IDs, and result ranks without providing TikTok credentials or accessing private account data.

#### Why are some results or profile fields missing?

TikTok may return fewer suggestions than requested or omit counters. The Actor requests additional deduplicated results where possible. Turn on `enrichProfiles` for more public details; private, blocked, or unavailable profiles remain in the dataset with an enrichment status.

#### Can I export the TikTok creator list?

Yes. Download the dataset from Apify Console in JSON, CSV, Excel, XML, or another supported format, or retrieve it through the Apify API.

### 🛡️ Responsible use

This Actor collects publicly available TikTok creator information. Use it lawfully, respect privacy and intellectual-property rights, follow applicable data-protection rules, and review TikTok's terms. Review the included licensing notices before redistributing the Actor image.

# Actor input Schema

## `searchQueries` (type: `array`):

Enter one or more creator names, usernames, niches, or keywords. Each query is searched independently; duplicates are removed.

## `maxCreatorsPerQuery` (type: `integer`):

Choose a target of 20 to 1,000 creators for each query. Large searches use additional deduplicated requests, and TikTok may return fewer creators when fewer matching accounts are available.

## `enrichProfiles` (type: `boolean`):

Fetch every public TikTok profile to add bio, bio link, followers, following, likes, video count, region, and full avatar URL. This uses one extra request per unique creator.

## Actor input object example

```json
{
  "searchQueries": [
    "OpenAI"
  ],
  "maxCreatorsPerQuery": 20,
  "enrichProfiles": false
}
```

# Actor output Schema

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

One normalized TikTok creator per dataset row.

## `summary` (type: `string`):

Counts and TikTok response metadata for every search query.

# 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 = {
    "searchQueries": [
        "OpenAI"
    ],
    "maxCreatorsPerQuery": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("devcake/tiktok-creator-apify").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 = {
    "searchQueries": ["OpenAI"],
    "maxCreatorsPerQuery": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("devcake/tiktok-creator-apify").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 '{
  "searchQueries": [
    "OpenAI"
  ],
  "maxCreatorsPerQuery": 20
}' |
apify call devcake/tiktok-creator-apify --silent --output-dataset

```

## MCP server setup

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

```

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/w4wIbrsG9E9AHKgg8/builds/MjQK2bHVD9h7EkI5c/openapi.json