# TikTok Influencer Keyword Search (`exporter24/tiktok-keyword-search`) Actor

Find TikTok creators by niche and filter them by audience size, content activity, and performance.

- **URL**: https://apify.com/exporter24/tiktok-keyword-search.md
- **Developed by:** [exporter24](https://apify.com/exporter24) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.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.

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 Keyword Search

Find TikTok creators whose content matches the niche you describe.
Each matching creator is saved as one item in the run’s default Dataset. Query and pagination details are saved separately in the `OUTPUT` record.

### How to get useful results

Write a short description of the creator niche, including related topics, formats, and audience interests. Around 100–200 characters gives the search useful context; one broad tag alone is usually too vague.

**Example niche:**

```text
Home workout routines, strength training, beginner fitness tips, gym motivation, weightlifting progress, nutrition advice, and realistic wellness habits.
```

### Input

All filters are optional apart from the required starting point. Use the table to decide what kind of creators should appear.

| Input | What it means | How to use it |
| --- | --- | --- |
| `searchQuery` | Describe the creator niche with related topics and content. | Required; 1–200 characters. Use a detailed description rather than a broad tag. |
| `maxResults` | Maximum number of creator records to save in this run. | 1–200; default `100`. Free plan users can request up to 10. |
| `relevanceThreshold` | Minimum topic relevance score. | 0–1; default `0.3`. Increase it for closer matches; lower it to include broader matches. |
| `minSubscribers`, `maxSubscribers` | Minimum and maximum audience size. On YouTube this means subscribers; on other platforms it means followers. | Enter one or both bounds. Use this to focus on small, mid-size, or large creators. |
| `minVideos`, `maxVideos` | Minimum and maximum number of published posts/videos. | Use this to include creators with enough content or focus on a narrower content volume. |
| `minMedianViews`, `maxMedianViews` | Minimum and maximum typical views per post/video. | Median views help compare regular reach without letting one viral post dominate. |
| `minMedianLikes`, `maxMedianLikes` | Minimum and maximum typical likes per post. | Available where the platform provides this metric. |
| `minEngagementRate`, `maxEngagementRate` | Minimum and maximum engagement rate. | Decimal from 0 to 1; `0.05` means 5%. Use it to focus on creators whose audiences interact with content. |
| `minViewRate`, `maxViewRate` | Minimum and maximum view rate. | Decimal from 0 to 1; `0.05` means 5%. Use it to compare typical views with audience size. |
| `includeCountries` | Keep creators located in the selected countries. | Comma-separated ISO two-letter codes, e.g. `US,AU,CA`. |
| `excludeCountries` | Remove creators located in the selected countries. | Same two-letter country-code format. |
| `maxDaysSinceLastPost` | Keep creators whose latest post is within this many days. | Whole number ≥ 0. Lower values focus on recently active creators. |
| `continuationToken` | Continue a search that returned more pages. | Copy `nextPageToken` from the previous run’s `OUTPUT` record. |

Numeric filters accept non-negative values. For a min/max pair, the maximum must be greater than the minimum. Rate values must be between 0 and 1. Invalid filters are rejected before the search request is sent.

### Example input

```json
{
  "searchQuery": "Home workout routines, strength training, beginner fitness tips, gym motivation, weightlifting progress, nutrition advice, and realistic wellness habits.",
  "maxResults": 30,
  "relevanceThreshold": 0.4
}
```

### Dataset results

The Dataset contains one record for each creator. Fields that the source platform does not provide may be omitted.

| Result field | What it tells you |
| --- | --- |
| `creatorId` | Stable TikTok creator identifier. |
| `creatorName` | Creator display name. |
| `creatorUrl` | Link to open the profile. |
| `followerCount` | Followers for audience-size screening. |
| `postCount` | Published posts/videos for content-volume screening. |
| `medianViews` | Typical views per post/video, measured by the median. |
| `medianLikes` | Typical likes per post, measured by the median. |
| `countryCode` | Creator location code when available. |
| `engagementRate` | Typical audience interaction relative to follower count. |
| `viewRate` | Typical views relative to follower count. |

### Search details and next pages

Open the run’s default Key-value store and read the `OUTPUT` record. It describes this search and tells you whether another run can continue it.

| `OUTPUT` field | Meaning |
| --- | --- |
| `resultCount` | Number of creator records saved by this run. |
| `maxResults` | Result limit used for this run. |
| `pagesFetched` | Number of API pages checked to fill the requested limit. |
| `hasMore` | `true` means more matching creators may be available. |
| `nextPageToken` | Token to paste into `continuationToken` in your next run; `null` means no next page. |
| `searchParameters` | The query and filters used, so you can review or reuse the same search. |
| `resolvedQuery` | Search text or profile identity resolved for the request. |

To continue, keep the same starting URL/query and filters, set `continuationToken` to the previous `nextPageToken`, and run again. Each run has its own result limit and uses one monthly free search.

### Free plan and pricing

- Free plan: up to **10 results per run** and **5 searches per calendar month for this Actor**. Each continuation run counts as another search. The counter resets on the first day of the month (UTC).
- Paid use: **$0.015 per Dataset result**, plus an Actor start event currently priced at $0.005 per GB of allocated memory (minimum one event). The input profile in a Similar Search is excluded before Dataset items are written and does not incur a result-item charge.
- The final Apify run page shows the actual charge. No sorting option is exposed.

### Related tools

- **Find similar creators:** [TikTok Similar Creator Search](https://apify.com/exporter24/tiktok-similar-search) for creators like a profile you know.
- **Understand a creator’s audience:** [TikTok Audience Insights](https://apify.com/exporter24/tiktok-audience-insights).
- **Find one creator’s email:** [TikTok Email Finder](https://apify.com/exporter24/tiktok-email-scraper).
- **Find emails for several profiles:** [TikTok Email Bulk Finder](https://apify.com/exporter24/tiktok-email-bulk-scraper).
- **Other social-profile email tools:** [Youtube Email Scraper](https://apify.com/exporter24/youtube-email-scraper), [Youtube Email Bulk Scraper](https://apify.com/exporter24/youtube-email-bulk-scraper), [Instagram Email Scraper](https://apify.com/exporter24/instagram-email-scraper), [Instagram Email Bulk Scraper](https://apify.com/exporter24/instagram-email-bulk-scraper).
- **Live API workflows:** See the [NanoInfluencer Public API](https://www.nanoinfluencer.ai/public-api/docs) for real-time profile and search requests.

# Actor input Schema

## `searchQuery` (type: `string`):

Describe the niche using related topics, content, and phrases. A detailed description works better than one broad tag.

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

Maximum results per run (1–200). Free plan users can request up to 10 results per run.

## `relevanceThreshold` (type: `number`):

Relevance score from 0 to 1; higher values are more restrictive.

## `minSubscribers` (type: `integer`):

Must be lower than the maximum if a maximum is provided.

## `maxSubscribers` (type: `integer`):

Must be greater than the minimum if a minimum is provided.

## `minVideos` (type: `integer`):

Must be lower than the maximum if a maximum is provided.

## `maxVideos` (type: `integer`):

Must be greater than the minimum if a minimum is provided.

## `minMedianViews` (type: `integer`):

Must be lower than the maximum if a maximum is provided.

## `maxMedianViews` (type: `integer`):

Must be greater than the minimum if a minimum is provided.

## `minMedianLikes` (type: `integer`):

Must be lower than the maximum if a maximum is provided.

## `maxMedianLikes` (type: `integer`):

Must be greater than the minimum if a minimum is provided.

## `minEngagementRate` (type: `number`):

Decimal rate from 0 to 1 (for example, 0.05 is 5%).

## `maxEngagementRate` (type: `number`):

Decimal rate from 0 to 1 (for example, 0.05 is 5%).

## `minViewRate` (type: `number`):

Decimal rate from 0 to 1 (for example, 0.05 is 5%).

## `maxViewRate` (type: `number`):

Decimal rate from 0 to 1 (for example, 0.05 is 5%).

## `maxDaysSinceLastPost` (type: `integer`):

Must be greater than the minimum if a minimum is provided.

## `includeCountries` (type: `string`):

Comma-separated ISO 3166-1 alpha-2 codes, e.g. US,AU,CA.

## `excludeCountries` (type: `string`):

Comma-separated ISO 3166-1 alpha-2 codes, e.g. US,AU,CA.

## `continuationToken` (type: `string`):

Paste OUTPUT.nextPageToken from a previous run to continue the same search.

## Actor input object example

```json
{
  "searchQuery": "Healthy meal prep, high-protein recipes, calorie-smart cooking, macro-friendly meals, strength training nutrition, easy weeknight dinners, and grocery hauls.",
  "maxResults": 100,
  "relevanceThreshold": 0.3
}
```

# Actor output Schema

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

One creator per Dataset item.

## `searchMetadata` (type: `string`):

Includes the query, resultCount, pagesFetched, and nextPageToken when more results are available.

# 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 = {
    "searchQuery": "Healthy meal prep, high-protein recipes, calorie-smart cooking, macro-friendly meals, strength training nutrition, easy weeknight dinners, and grocery hauls."
};

// Run the Actor and wait for it to finish
const run = await client.actor("exporter24/tiktok-keyword-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 = { "searchQuery": "Healthy meal prep, high-protein recipes, calorie-smart cooking, macro-friendly meals, strength training nutrition, easy weeknight dinners, and grocery hauls." }

# Run the Actor and wait for it to finish
run = client.actor("exporter24/tiktok-keyword-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 '{
  "searchQuery": "Healthy meal prep, high-protein recipes, calorie-smart cooking, macro-friendly meals, strength training nutrition, easy weeknight dinners, and grocery hauls."
}' |
apify call exporter24/tiktok-keyword-search --silent --output-dataset

```

## MCP server setup

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