# Find Similar YouTube Channels by Content, Not Keywords (`dataovercoffee/youtube-channel-lookalike-finder`) Actor

🔍 Similar creators + engagement stats from 200M+ channels. Skip the scraping 🏎️💨

- **URL**: https://apify.com/dataovercoffee/youtube-channel-lookalike-finder.md
- **Developed by:** [Data Over Coffee](https://apify.com/dataovercoffee) (community)
- **Categories:** Lead generation, Social media, Videos
- **Stats:** 12 total users, 8 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$120.00 / 1,000 channels

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### 🔍 Find Similar YouTube Channels by Content, Not Keywords

Think of it as a search engine for creators. Give it a channel you like, it searches **200M+ creators** and returns the ones that publish similar content - matched by what they actually make, not what category they're in. Ranked, filtered, and ready to export.

### 🧠 How It Works

1. **We analyze every channel on YouTube.** We maintain one of the largest public creator indexes available - 200M+ channels and growing.
2. **You give us a channel.** Paste one or more YouTube channel IDs as seeds.
3. **We find the closest matches** across 200M+ channels based on what they actually publish.
4. **We score and rank them** based on how closely their content matches your seed.
5. **We apply your filters** - subscribers, avg views, country, email availability, whatever you set.
6. **You get the results.** Ranked list with full metadata, ready to export. Usually takes a few minutes.

**We don't cut corners.** Every search runs against the full index. No curated subsets, no top-creator shortlists. A 500-subscriber cooking channel in rural Japan is searchable the same as MrBeast. Whether you're looking for creators under 10k subs, over 100k, or anywhere in between — any range, any filter, full coverage.

### 💡 Use Cases

| Who | Problem | How |
|---|---|---|
| Brand marketer | Sponsored one creator, need 200 more like them | Seed the channel, get lookalikes with engagement data |
| Agency manager | Creator dropped out, need a replacement fast | Seed the dropped creator, filter by `has_email` flag |
| Marketing director | Agency pitched 15 creators, are they the best? | Seed a few pitched channels, see who else exists |
| International marketer | Need the Brazilian equivalent of a US creator | Seed US channels, filter by country |
| Affiliate manager | Need partners who drive sales, not impressions | Seed top earners, sort by avg views per video |
| Ecommerce brand | Need 50 micro-creators under 20k subs for UGC | Seed known micro-creators, filter max subs |

### ⚡ How To Use It

![Actor inputs walkthrough](https://apify-data-over-coffee.s3.us-east-1.amazonaws.com/doc_youtube_related_inputs.gif)

1. Paste `seed_channel_ids` (1-10 YouTube channel IDs).
2. Set `limit` (default 100, max 25,000).
3. Optional: filter by subscribers, avg views, country, email availability, etc.
4. Run, download results (CSV/JSON/Excel).

**Where do I get a channel ID?** YouTube channel -> three dots -> "Share channel" -> copy the URL. The ID is the `UC...` part. Or use [YouTube Channel Finder](https://apify.com/dataovercoffee/youtube-channel-finder) to find channels by keyword first.

### 💰 Pricing

- **$0.12 per channel** — pay per result
- Up to **25,000 results** per search
- Apify free tier includes **$5 of usage**

### 🔗 Full Outreach Pipeline

Seed a channel, get lookalikes, extract emails, start outreach. One pipeline, no manual filtering, no spreadsheet cleanup.

1. Pick a seed channel (or find one with [YouTube Channel Finder](https://apify.com/dataovercoffee/youtube-channel-finder))
2. Run this actor with `only_has_email` — get up to 25,000 email-ready lookalikes
3. Run [YouTube Channel Business Email Scraper](https://apify.com/dataovercoffee/youtube-channel-business-email-scraper) on results to get actual addresses
4. Export to Google Sheets, CSV, JSON, or Excel via Apify integrations

### 🏆 Tips

- **Multiple seeds = sharper results.** One seed is broad. Three seeds is a niche.
- **Keep all seeds in the same niche.** Multi-seed finds channels similar to *all* seeds at once. If your seeds span multiple niches, run a separate search per niche.
- **Filter by avg views, not subs.** Millions of subscribers means nothing if nobody watches.
- **Videos vs shorts.** Filter `min_avg_views_videos` and `min_avg_views_shorts` separately.
- **Email flag for outreach.** `only_has_email` = only channels with a public email. Run them through the [Email Scraper](https://apify.com/dataovercoffee/youtube-channel-business-email-scraper) for actual addresses.
- **Dedup across runs.** Paste up to 500K channel IDs into `exclude_channel_ids`.

### ❓ FAQ

#### What's the difference between this and YouTube's "related channels"?

YouTube removed that feature for most creators. This searches 200M+ channels with engagement data, filters, and up to 25,000 results.

#### How do I find YouTube channels similar to a competitor?

Paste your competitor's channel IDs as seeds. The results are channels similar to what they work with. Add your own top creators as seeds too and the overlap gets even more specific.

#### Does it return email addresses?

It flags which channels have a public email (`HasPublicEmail`). To get actual addresses, run those channels through [YouTube Channel Business Email Scraper](https://apify.com/dataovercoffee/youtube-channel-business-email-scraper).

#### How do I find YouTubers for sponsorship?

Add seed channels, set filters (subs, engagement, country, `only_has_email`), run, export. Best matches are at the top.

#### What's the best way to find YouTube influencers in a specific niche?

Use multiple seeds. One seed gives you broad results. Three seeds that all represent your niche give you the intersection - channels similar to all of them. The more seeds, the tighter the niche.

#### I got fewer results than my limit. Is something wrong?

No. We filter out inactive, spammy, and low-quality channels before returning results. If your filters are tight or the niche is small, there may not be enough channels that pass. The warning is normal — it means the filter is working, not that something broke.

If you need more, take your best results, use them as seeds for a new run, and keep going until you have as many creators as you need. Paste all previous results into `exclude_channel_ids` so you don't get charged for duplicates.

#### Need help?

Open an issue on the [actor page](https://apify.com/dataovercoffee/youtube-channel-lookalike-finder/issues) with your Run ID.

# Actor input Schema

## `seed_channel_ids` (type: `array`):

YouTube channel IDs to find lookalikes for. Provide 1-10 channel IDs (e.g., UCX6OQ3DkcsbYNE6H8uQQuVA). The more seeds you provide, the better the results.
## `limit` (type: `integer`):

Maximum number of lookalike channels to return.
## `min_subscribers` (type: `integer`):

Only include channels with at least this many subscribers.
## `max_subscribers` (type: `integer`):

Only include channels with at most this many subscribers.
## `min_avg_views_videos` (type: `integer`):

Minimum average view count across the channel's recent videos.
## `max_avg_views_videos` (type: `integer`):

Maximum average view count across the channel's recent videos.
## `min_avg_views_shorts` (type: `integer`):

Minimum average view count across the channel's recent shorts.
## `max_avg_views_shorts` (type: `integer`):

Maximum average view count across the channel's recent shorts.
## `min_total_views` (type: `integer`):

Only include channels with at least this many total views.
## `max_total_views` (type: `integer`):

Only include channels with at most this many total views.
## `min_total_videos` (type: `integer`):

Only include channels with at least this many published videos.
## `max_total_videos` (type: `integer`):

Only include channels with at most this many published videos.
## `countries` (type: `array`):

Only include channels from these countries.
## `exclude_countries` (type: `array`):

Exclude channels from these countries.
## `only_verified` (type: `boolean`):

Only include channels that have YouTube's verified badge.
## `only_has_email` (type: `boolean`):

Only include channels that have a public business email on their about page. Great for influencer outreach.
## `only_family_friendly` (type: `boolean`):

Only include channels marked as family-friendly by YouTube.
## `exclude_channel_ids` (type: `array`):

List of YouTube channel IDs to exclude from results. Use this to avoid getting channels you already have from previous runs. Maximum 500,000.

## Actor input object example

```json
{
  "seed_channel_ids": [
    "UCX6OQ3DkcsbYNE6H8uQQuVA"
  ],
  "limit": 100,
  "only_verified": false,
  "only_has_email": false,
  "only_family_friendly": false
}
````

# Actor output Schema

## `lookalikes` (type: `string`):

Dataset containing YouTube channels similar to the seed channels, ranked by lookalike score with full metadata.

# 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 = {
    "seed_channel_ids": [
        "UCX6OQ3DkcsbYNE6H8uQQuVA"
    ],
    "limit": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataovercoffee/youtube-channel-lookalike-finder").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 = {
    "seed_channel_ids": ["UCX6OQ3DkcsbYNE6H8uQQuVA"],
    "limit": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("dataovercoffee/youtube-channel-lookalike-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "seed_channel_ids": [
    "UCX6OQ3DkcsbYNE6H8uQQuVA"
  ],
  "limit": 100
}' |
apify call dataovercoffee/youtube-channel-lookalike-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=dataovercoffee/youtube-channel-lookalike-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Find Similar YouTube Channels by Content, Not Keywords",
        "description": "🔍 Similar creators + engagement stats from 200M+ channels. Skip the scraping 🏎️💨",
        "version": "1.0",
        "x-build-id": "9ryvwkcafNEAGvk3s"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/dataovercoffee~youtube-channel-lookalike-finder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-dataovercoffee-youtube-channel-lookalike-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/dataovercoffee~youtube-channel-lookalike-finder/runs": {
            "post": {
                "operationId": "runs-sync-dataovercoffee-youtube-channel-lookalike-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/dataovercoffee~youtube-channel-lookalike-finder/run-sync": {
            "post": {
                "operationId": "run-sync-dataovercoffee-youtube-channel-lookalike-finder",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "seed_channel_ids"
                ],
                "properties": {
                    "seed_channel_ids": {
                        "title": "Seed Channel IDs",
                        "minItems": 1,
                        "maxItems": 10,
                        "type": "array",
                        "description": "YouTube channel IDs to find lookalikes for. Provide 1-10 channel IDs (e.g., UCX6OQ3DkcsbYNE6H8uQQuVA). The more seeds you provide, the better the results.",
                        "default": [
                            "UCX6OQ3DkcsbYNE6H8uQQuVA"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "limit": {
                        "title": "Max Results",
                        "minimum": 1,
                        "maximum": 25000,
                        "type": "integer",
                        "description": "Maximum number of lookalike channels to return.",
                        "default": 100
                    },
                    "min_subscribers": {
                        "title": "Min Subscribers",
                        "type": "integer",
                        "description": "Only include channels with at least this many subscribers."
                    },
                    "max_subscribers": {
                        "title": "Max Subscribers",
                        "type": "integer",
                        "description": "Only include channels with at most this many subscribers."
                    },
                    "min_avg_views_videos": {
                        "title": "Min Avg Views (Videos)",
                        "type": "integer",
                        "description": "Minimum average view count across the channel's recent videos."
                    },
                    "max_avg_views_videos": {
                        "title": "Max Avg Views (Videos)",
                        "type": "integer",
                        "description": "Maximum average view count across the channel's recent videos."
                    },
                    "min_avg_views_shorts": {
                        "title": "Min Avg Views (Shorts)",
                        "type": "integer",
                        "description": "Minimum average view count across the channel's recent shorts."
                    },
                    "max_avg_views_shorts": {
                        "title": "Max Avg Views (Shorts)",
                        "type": "integer",
                        "description": "Maximum average view count across the channel's recent shorts."
                    },
                    "min_total_views": {
                        "title": "Min Total Views",
                        "type": "integer",
                        "description": "Only include channels with at least this many total views."
                    },
                    "max_total_views": {
                        "title": "Max Total Views",
                        "type": "integer",
                        "description": "Only include channels with at most this many total views."
                    },
                    "min_total_videos": {
                        "title": "Min Total Videos",
                        "type": "integer",
                        "description": "Only include channels with at least this many published videos."
                    },
                    "max_total_videos": {
                        "title": "Max Total Videos",
                        "type": "integer",
                        "description": "Only include channels with at most this many published videos."
                    },
                    "countries": {
                        "title": "Include Countries",
                        "type": "array",
                        "description": "Only include channels from these countries.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Afghanistan",
                                "Albania",
                                "Algeria",
                                "American Samoa",
                                "Andorra",
                                "Angola",
                                "Anguilla",
                                "Antarctica",
                                "Antigua & Barbuda",
                                "Argentina",
                                "Armenia",
                                "Aruba",
                                "Australia",
                                "Austria",
                                "Azerbaijan",
                                "Bahamas",
                                "Bahrain",
                                "Bangladesh",
                                "Barbados",
                                "Belarus",
                                "Belgium",
                                "Benin",
                                "Bermuda",
                                "Bhutan",
                                "Bolivia",
                                "Bosnia & Herzegovina",
                                "Botswana",
                                "Brazil",
                                "British Indian Ocean Territory",
                                "British Virgin Islands",
                                "Brunei",
                                "Bulgaria",
                                "Burkina Faso",
                                "Cambodia",
                                "Cameroon",
                                "Canada",
                                "Cayman Islands",
                                "Chile",
                                "China",
                                "Colombia",
                                "Congo - Brazzaville",
                                "Congo - Kinshasa",
                                "Costa Rica",
                                "Côte d'Ivoire",
                                "Croatia",
                                "Cuba",
                                "Cyprus",
                                "Czechia",
                                "Denmark",
                                "Dominican Republic",
                                "Ecuador",
                                "Egypt",
                                "El Salvador",
                                "Estonia",
                                "Eswatini",
                                "Ethiopia",
                                "Falkland Islands (Islas Malvinas)",
                                "Faroe Islands",
                                "Fiji",
                                "Finland",
                                "France",
                                "French Guiana",
                                "French Polynesia",
                                "Gabon",
                                "Georgia",
                                "Germany",
                                "Ghana",
                                "Gibraltar",
                                "Greece",
                                "Greenland",
                                "Guadeloupe",
                                "Guam",
                                "Guatemala",
                                "Guernsey",
                                "Guyana",
                                "Haiti",
                                "Honduras",
                                "Hong Kong",
                                "Hungary",
                                "Iceland",
                                "India",
                                "Indonesia",
                                "Iran",
                                "Iraq",
                                "Ireland",
                                "Isle of Man",
                                "Israel",
                                "Italy",
                                "Jamaica",
                                "Japan",
                                "Jersey",
                                "Jordan",
                                "Kazakhstan",
                                "Kenya",
                                "Kiribati",
                                "Kuwait",
                                "Kyrgyzstan",
                                "Laos",
                                "Latvia",
                                "Lebanon",
                                "Libya",
                                "Liechtenstein",
                                "Lithuania",
                                "Luxembourg",
                                "Macao",
                                "Madagascar",
                                "Malawi",
                                "Malaysia",
                                "Malta",
                                "Marshall Islands",
                                "Martinique",
                                "Mauritius",
                                "Mayotte",
                                "Mexico",
                                "Moldova",
                                "Monaco",
                                "Mongolia",
                                "Montenegro",
                                "Morocco",
                                "Mozambique",
                                "Myanmar (Burma)",
                                "Namibia",
                                "Nepal",
                                "Netherlands",
                                "New Caledonia",
                                "New Zealand",
                                "Nicaragua",
                                "Nigeria",
                                "Norfolk Island",
                                "North Korea",
                                "North Macedonia",
                                "Norway",
                                "Oman",
                                "Pakistan",
                                "Palau",
                                "Panama",
                                "Papua New Guinea",
                                "Paraguay",
                                "Peru",
                                "Philippines",
                                "Poland",
                                "Portugal",
                                "Puerto Rico",
                                "Qatar",
                                "Réunion",
                                "Romania",
                                "Russia",
                                "Rwanda",
                                "São Tomé & Príncipe",
                                "Saudi Arabia",
                                "Senegal",
                                "Serbia",
                                "Seychelles",
                                "Sierra Leone",
                                "Singapore",
                                "Slovakia",
                                "Slovenia",
                                "Somalia",
                                "South Africa",
                                "South Georgia & South Sandwich Islands",
                                "South Korea",
                                "Spain",
                                "Sri Lanka",
                                "St Helena",
                                "St Kitts & Nevis",
                                "St Lucia",
                                "St Pierre & Miquelon",
                                "St Vincent & the Grenadines",
                                "Svalbard & Jan Mayen",
                                "Sweden",
                                "Switzerland",
                                "Syria",
                                "Taiwan",
                                "Tajikistan",
                                "Tanzania",
                                "Thailand",
                                "Timor-Leste",
                                "Trinidad & Tobago",
                                "Tunisia",
                                "Türkiye",
                                "Turks & Caicos Islands",
                                "Tuvalu",
                                "Uganda",
                                "Ukraine",
                                "United Arab Emirates",
                                "United Kingdom",
                                "United States",
                                "Uruguay",
                                "US Outlying Islands",
                                "US Virgin Islands",
                                "Uzbekistan",
                                "Vanuatu",
                                "Vatican City",
                                "Venezuela",
                                "Vietnam",
                                "Wallis & Futuna",
                                "Yemen",
                                "Zambia",
                                "Zimbabwe"
                            ]
                        }
                    },
                    "exclude_countries": {
                        "title": "Exclude Countries",
                        "type": "array",
                        "description": "Exclude channels from these countries.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "Afghanistan",
                                "Albania",
                                "Algeria",
                                "American Samoa",
                                "Andorra",
                                "Angola",
                                "Anguilla",
                                "Antarctica",
                                "Antigua & Barbuda",
                                "Argentina",
                                "Armenia",
                                "Aruba",
                                "Australia",
                                "Austria",
                                "Azerbaijan",
                                "Bahamas",
                                "Bahrain",
                                "Bangladesh",
                                "Barbados",
                                "Belarus",
                                "Belgium",
                                "Benin",
                                "Bermuda",
                                "Bhutan",
                                "Bolivia",
                                "Bosnia & Herzegovina",
                                "Botswana",
                                "Brazil",
                                "British Indian Ocean Territory",
                                "British Virgin Islands",
                                "Brunei",
                                "Bulgaria",
                                "Burkina Faso",
                                "Cambodia",
                                "Cameroon",
                                "Canada",
                                "Cayman Islands",
                                "Chile",
                                "China",
                                "Colombia",
                                "Congo - Brazzaville",
                                "Congo - Kinshasa",
                                "Costa Rica",
                                "Côte d'Ivoire",
                                "Croatia",
                                "Cuba",
                                "Cyprus",
                                "Czechia",
                                "Denmark",
                                "Dominican Republic",
                                "Ecuador",
                                "Egypt",
                                "El Salvador",
                                "Estonia",
                                "Eswatini",
                                "Ethiopia",
                                "Falkland Islands (Islas Malvinas)",
                                "Faroe Islands",
                                "Fiji",
                                "Finland",
                                "France",
                                "French Guiana",
                                "French Polynesia",
                                "Gabon",
                                "Georgia",
                                "Germany",
                                "Ghana",
                                "Gibraltar",
                                "Greece",
                                "Greenland",
                                "Guadeloupe",
                                "Guam",
                                "Guatemala",
                                "Guernsey",
                                "Guyana",
                                "Haiti",
                                "Honduras",
                                "Hong Kong",
                                "Hungary",
                                "Iceland",
                                "India",
                                "Indonesia",
                                "Iran",
                                "Iraq",
                                "Ireland",
                                "Isle of Man",
                                "Israel",
                                "Italy",
                                "Jamaica",
                                "Japan",
                                "Jersey",
                                "Jordan",
                                "Kazakhstan",
                                "Kenya",
                                "Kiribati",
                                "Kuwait",
                                "Kyrgyzstan",
                                "Laos",
                                "Latvia",
                                "Lebanon",
                                "Libya",
                                "Liechtenstein",
                                "Lithuania",
                                "Luxembourg",
                                "Macao",
                                "Madagascar",
                                "Malawi",
                                "Malaysia",
                                "Malta",
                                "Marshall Islands",
                                "Martinique",
                                "Mauritius",
                                "Mayotte",
                                "Mexico",
                                "Moldova",
                                "Monaco",
                                "Mongolia",
                                "Montenegro",
                                "Morocco",
                                "Mozambique",
                                "Myanmar (Burma)",
                                "Namibia",
                                "Nepal",
                                "Netherlands",
                                "New Caledonia",
                                "New Zealand",
                                "Nicaragua",
                                "Nigeria",
                                "Norfolk Island",
                                "North Korea",
                                "North Macedonia",
                                "Norway",
                                "Oman",
                                "Pakistan",
                                "Palau",
                                "Panama",
                                "Papua New Guinea",
                                "Paraguay",
                                "Peru",
                                "Philippines",
                                "Poland",
                                "Portugal",
                                "Puerto Rico",
                                "Qatar",
                                "Réunion",
                                "Romania",
                                "Russia",
                                "Rwanda",
                                "São Tomé & Príncipe",
                                "Saudi Arabia",
                                "Senegal",
                                "Serbia",
                                "Seychelles",
                                "Sierra Leone",
                                "Singapore",
                                "Slovakia",
                                "Slovenia",
                                "Somalia",
                                "South Africa",
                                "South Georgia & South Sandwich Islands",
                                "South Korea",
                                "Spain",
                                "Sri Lanka",
                                "St Helena",
                                "St Kitts & Nevis",
                                "St Lucia",
                                "St Pierre & Miquelon",
                                "St Vincent & the Grenadines",
                                "Svalbard & Jan Mayen",
                                "Sweden",
                                "Switzerland",
                                "Syria",
                                "Taiwan",
                                "Tajikistan",
                                "Tanzania",
                                "Thailand",
                                "Timor-Leste",
                                "Trinidad & Tobago",
                                "Tunisia",
                                "Türkiye",
                                "Turks & Caicos Islands",
                                "Tuvalu",
                                "Uganda",
                                "Ukraine",
                                "United Arab Emirates",
                                "United Kingdom",
                                "United States",
                                "Uruguay",
                                "US Outlying Islands",
                                "US Virgin Islands",
                                "Uzbekistan",
                                "Vanuatu",
                                "Vatican City",
                                "Venezuela",
                                "Vietnam",
                                "Wallis & Futuna",
                                "Yemen",
                                "Zambia",
                                "Zimbabwe"
                            ]
                        }
                    },
                    "only_verified": {
                        "title": "Verified Only",
                        "type": "boolean",
                        "description": "Only include channels that have YouTube's verified badge.",
                        "default": false
                    },
                    "only_has_email": {
                        "title": "Has Public Email Only",
                        "type": "boolean",
                        "description": "Only include channels that have a public business email on their about page. Great for influencer outreach.",
                        "default": false
                    },
                    "only_family_friendly": {
                        "title": "Family Friendly Only",
                        "type": "boolean",
                        "description": "Only include channels marked as family-friendly by YouTube.",
                        "default": false
                    },
                    "exclude_channel_ids": {
                        "title": "Exclude Channel IDs",
                        "maxItems": 500000,
                        "type": "array",
                        "description": "List of YouTube channel IDs to exclude from results. Use this to avoid getting channels you already have from previous runs. Maximum 500,000.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
