# YouTube Creator Search by Similar Channel (`exporter24/youtube-similar-search`) Actor

Find YouTube creators similar to a profile you know, with filters for audience size, activity, and performance.

- **URL**: https://apify.com/exporter24/youtube-similar-search.md
- **Developed by:** [exporter24](https://apify.com/exporter24) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 25.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

## YouTube Influencer Similar Search

Find YouTube creators similar to a profile you already know.
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

Start with a public creator profile URL. The Actor resolves the profile and searches for creators with similar content or audience characteristics. The source profile itself is removed from results.

### 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 |
| --- | --- | --- |
| `channelUrl` | Paste a public YouTube creator profile URL whose similar creators you want to discover. | Required. Example: `https://www.youtube.com/@theAIsearch`. |
| `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 similarity 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
{
  "channelUrl": "https://www.youtube.com/@theAIsearch",
  "maxResults": 30,
  "minSubscribers": 10000,
  "maxSubscribers": 500000
}
```

### 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 |
| --- | --- |
| `channelId` | Stable YouTube channel identifier. |
| `channelName` | Channel name viewers recognize. |
| `channelUrl` | Link to open the channel. |
| `subscriberCount` | Subscriber count for audience-size screening. |
| `medianViews` | Typical views per video, measured by the median. |
| `countryCode` | Creator location code when available. |
| `engagementRate` | Typical audience interaction relative to channel size. |
| `viewRate` | Typical views relative to subscriber 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. |
| `resolvedChannelId` | Resolved identity for the source profile. |

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

- **Search by topic:** [YouTube Keyword Search](https://apify.com/exporter24/youtube-keyword-search) when you have a niche or campaign brief.
- **Understand a creator’s audience:** [YouTube Audience Insights](https://apify.com/exporter24/youtube-audience-insights).
- **Find one creator’s email:** [YouTube Email Finder](https://apify.com/exporter24/youtube-email-scraper).
- **Find emails for several profiles:** [YouTube Email Bulk Finder](https://apify.com/exporter24/youtube-email-bulk-scraper).
- **Other social-profile email tools:** [Tiktok Email Scraper](https://apify.com/exporter24/tiktok-email-scraper), [Tiktok Email Bulk Scraper](https://apify.com/exporter24/tiktok-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

## `channelUrl` (type: `string`):

URL of the YouTube channel to find similar creators for. Handles and legacy channel URLs are resolved automatically.

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

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

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

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

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

Must be 0 or greater and below maxSubscribers if provided.

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

Must be greater than minSubscribers (or 0 if omitted).

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

Must be 0 or greater and below maxVideos if provided.

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

Must be greater than minVideos (or 0 if omitted).

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

Must be 0 or greater and below maxMedianViews if provided.

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

Must be greater than minMedianViews (or 0 if omitted).

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

Must be 0 or greater and below maxMedianLikes if provided.

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

Must be greater than minMedianLikes (or 0 if omitted).

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

Decimal rate from 0 to 1 (for example, 0.05 is 5%); must be below the maximum, if provided.

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

Decimal rate from 0 to 1 (for example, 0.05 is 5%); must be greater than the minimum (or 0 if omitted).

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

Decimal rate from 0 to 1 (for example, 0.05 is 5%); must be below the maximum, if provided.

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

Decimal rate from 0 to 1 (for example, 0.05 is 5%); must be greater than the minimum (or 0 if omitted).

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

ISO 3166-1 alpha-2 codes, comma-separated, e.g. US,AU,CA. Numeric codes are also accepted.

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

ISO 3166-1 alpha-2 codes, comma-separated, e.g. US,AU,CA. Numeric codes are also accepted.

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

Whole number of days, 0 or greater.

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

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

## Actor input object example

```json
{
  "channelUrl": "https://www.youtube.com/@JeffNippard",
  "maxResults": 100,
  "relevanceThreshold": 0.3
}
```

# Actor output Schema

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

YouTube creator results, one creator per Dataset item.

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

Includes the source URL, resolved channel ID, query, resultCount and 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 = {
    "channelUrl": "https://www.youtube.com/@JeffNippard"
};

// Run the Actor and wait for it to finish
const run = await client.actor("exporter24/youtube-similar-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 = { "channelUrl": "https://www.youtube.com/@JeffNippard" }

# Run the Actor and wait for it to finish
run = client.actor("exporter24/youtube-similar-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 '{
  "channelUrl": "https://www.youtube.com/@JeffNippard"
}' |
apify call exporter24/youtube-similar-search --silent --output-dataset

```

## MCP server setup

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