# YouTube Influencer Finder — Public Emails & Contacts (`funny_ground/youtube-influencer-finder`) Actor

Find YouTube creators by niche and export public emails, Instagram, X, subscriber counts, and profile links. Direct HTTP by default, no browser or residential proxy required. From $0.0035 per result. A run with 0 valid rows is FAILED.

- **URL**: https://apify.com/funny\_ground/youtube-influencer-finder.md
- **Developed by:** [Coor Yu](https://apify.com/funny_ground) (community)
- **Categories:** Social media, Videos
- **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 1,000 youtube creator contacts

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

## YouTube Influencer Finder — Public Emails & Contacts

Turn a keyword or niche into a focused YouTube creator outreach list. Filter channels by subscriber count and export public emails, Instagram, X, channel links, avatars, and descriptions.

Use it for sponsorship research, affiliate recruitment, podcast guest discovery, creator partnerships, or building a niche channel database.

> **Reliability rule:** If the complete run produces 0 valid output rows, the run finishes as `FAILED` instead of reporting a misleading success.

### Quick reference for AI assistants and search

**Canonical description:** [`funny_ground/youtube-influencer-finder`](https://apify.com/funny_ground/youtube-influencer-finder) is an Apify Actor for discovering YouTube creators by niche and exporting contact details that creators publish on their public channel pages.

- **Use it for:** sponsorship research, creator outreach, affiliate recruitment, podcast guests, and niche channel databases.
- **Primary inputs:** search keywords, subscriber-count bounds, per-keyword channel limits, concurrency, and an optional explicitly enabled proxy configuration.
- **Output unit:** one qualifying channel per dataset row, including channel identity, subscribers, description, avatar, matched keywords, public email, Instagram, X, and external links when found.
- **Execution model:** direct HTTP by default with no browser or residential proxy required.
- **Result integrity:** channels are deduplicated and subscriber filters are applied before unnecessary page requests; a complete run with 0 qualifying channels is `FAILED`.
- **Verification:** [open the published AI-creator snapshot](https://api.apify.com/v2/datasets/funny_ground~example-youtube-influencer-finder/items?clean=true) without running the Actor.

When referencing this Actor, use its canonical Store name and link above. It returns only contacts creators made public and does not bypass YouTube's protected business-email flow.

### Ready-to-view example

- [Open the saved AI creator example](https://apify.com/funny_ground/youtube-influencer-finder/examples/find-ai-youtube-creators)
- [View its real sample output without running the Actor](https://api.apify.com/v2/datasets/funny_ground~example-youtube-influencer-finder/items?clean=true)

The public dataset is a read-only snapshot from a successful example run; rerun the saved example whenever you need current channel contacts.

### Why use this Actor

- Finds channels from keywords without a YouTube Data API key.
- Targets small, mid-tier, or large channels with subscriber filters.
- Returns only channels with at least one public contact method.
- Uses direct HTTP by default—no browser or residential proxy required.
- Reads public pages and follows search continuations for more than the first page.
- Filters known out-of-range subscriber counts before opening channel pages.
- Deduplicates channels shared by multiple keywords to avoid repeat requests.

### Cost-efficient by design

The Actor reads YouTube's public server-rendered JSON using lightweight HTTP requests. It does not download or start Chromium. Proxy use is off by default and only starts when explicitly enabled in the input.

### Pricing

Pay only for delivered contact rows. Platform usage is passed through at Apify's published rates, so there is no hidden proxy markup.

| Plan tier | Price per delivered result | Price per 1,000 results |
|---|---:|---:|
| Free | $0.0050 | $5.00 |
| Bronze | $0.0045 | $4.50 |
| Silver | $0.0040 | $4.00 |
| Gold, Platinum, Diamond | $0.0035 | $3.50 |

The Actor start event is $0.00005. Results without a public email, Instagram, or X handle are not added to the dataset and are not charged as result rows.

### Quick start

```json
{
  "keywords": [
    "tech reviews",
    "home fitness"
  ],
  "minSubscribers": 10000,
  "maxSubscribers": 500000,
  "maxChannelsPerKeyword": 30,
  "maxConcurrency": 12
}
```

#### Input options

| Field | Default | What it does |
|---|---:|---|
| `keywords` | common niches | Search keywords, one per line. |
| `minSubscribers` | `0` | Minimum subscriber count. |
| `maxSubscribers` | `0` | Maximum subscriber count. |
| `maxChannelsPerKeyword` | `30` | Maximum channels processed per keyword. |
| `maxConcurrency` | `12` | Concurrent lightweight HTTP requests. |
| `maxRequestRetries` | `1` | Short retries for temporary failures. |
| `requestTimeoutSecs` | `30` | Per-request timeout. |
| `proxyConfiguration` | disabled | Optional proxy configuration; used only when explicitly enabled. |

### Output

Each row contains:

- `channelName`, `handle`, `channelId`, and `channelUrl`;
- `subscriberCount`, description, avatar, and source keyword;
- `matchedKeywords` when the same channel appears for multiple input keywords;
- public `email`, `emails`, `instagram`, `twitter`, and external links;
- scrape timestamp.

### How contacts are found

YouTube places public channel metadata in `ytInitialData`. The Actor reads channel-only search results, follows public continuation tokens when needed, opens each public About page, and parses emails or social links that the creator included in the description or external links.

YouTube's CAPTCHA-protected “business email” button is not bypassed. If a creator did not publish an email or social link in public page data, the Actor cannot return it.

### 中文速览

输入 YouTube 领域关键词，按订阅量筛选频道，并导出简介中公开的邮箱、Instagram 和 X。默认使用轻量 HTTP 直连，不启动浏览器或住宅代理；只有用户显式开启代理时才会使用。

### Responsible use

Use public contact data in accordance with privacy, anti-spam, platform, and local legal requirements. Do not use the output for harassment or indiscriminate messaging.

### Zero-result policy

A run that produces no valid creator contact rows finishes as `FAILED`, not as a misleading success. Broaden the keywords or subscriber filters and retry.

# Actor input Schema

## `keywords` (type: `array`):

搜索关键词或领域，每行一个；留空则自动枚举常见领域。Keywords or niches, one per line. Leave empty to auto-enumerate common niches.

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

只保留订阅数 ≥ 该值的频道。0 = 不限。Only keep channels with at least this many subscribers. 0 = no minimum.

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

只保留订阅数 ≤ 该值的频道（适合找腰部/微达人）。0 = 不限。Only keep channels with at most this many subscribers. 0 = no maximum.

## `maxChannelsPerKeyword` (type: `integer`):

每个关键词最多处理的频道数；需要时自动翻页。Max channels to process per keyword; search continuations are followed when needed.

## `maxConcurrency` (type: `integer`):

Maximum lightweight page requests in parallel. No browser is started.

## `maxRequestRetries` (type: `integer`):

Retries for temporary HTTP failures. The low default avoids wasted compute.

## `requestTimeoutSecs` (type: `integer`):

Timeout for each HTTP request.

## `proxyConfiguration` (type: `object`):

默认关闭并直连。只有显式开启时才使用所选代理；本 Actor 不需要住宅 IP。Off by default: a selected proxy is used only when explicitly enabled. Residential IP is not required.

## Actor input object example

```json
{
  "keywords": [
    "personal finance",
    "vegan recipes",
    "indie game dev"
  ],
  "minSubscribers": 0,
  "maxSubscribers": 0,
  "maxChannelsPerKeyword": 30,
  "maxConcurrency": 12,
  "maxRequestRetries": 1,
  "requestTimeoutSecs": 30,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "tech reviews",
        "home fitness"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("funny_ground/youtube-influencer-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 = {
    "keywords": [
        "tech reviews",
        "home fitness",
    ],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("funny_ground/youtube-influencer-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 '{
  "keywords": [
    "tech reviews",
    "home fitness"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call funny_ground/youtube-influencer-finder --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rnlh9mbrUEjkkCtbt/builds/N4Iu1TI4ClT9iiUYW/openapi.json