# Youtube Leads Generator (`solid-scraper/youtube-leads-generator`) Actor

🚀 Find qualified YouTube leads fast! Target channels, creators, and audiences by niche and keyword for instant prospecting. Ideal for agencies, marketers, and sales teams to boost outreach with high-converting contacts.

- **URL**: https://apify.com/solid-scraper/youtube-leads-generator.md
- **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Leads Generator - B2B & B2C Email Finder (Free 100 Emails) 📺📨

**YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails)** is an Apify actor that helps you **find relevant YouTube channels by keywords** and **extract contact emails plus channel data** for outreach. It’s built for marketers and researchers who need a **YouTube lead generator tool** that turns public web presence into structured leads—ideal for **YouTube email finder** workflows and **email finder for outreach**. Whether you’re running B2B outreach or B2C influencer marketing, this tool helps you build a targeted email list at scale, saving you hours of manual work.

***

### Why choose YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails)?

| Feature | Benefit |
| --- | --- |
| ✅ **Keyword-based YouTube lead discovery** | Find matching YouTube channels using your input keywords |
| ✅ **Optional “emails only” mode** | Use `scrapeLeadsWithEmail` to only keep channels that include an email |
| ✅ **Reliability with retries** | Uses retry logic (max retries) to improve success rates |
| ✅ **Structured dataset output** | Saves channel + email information to a consistent dataset schema |
| ✅ **Scale controls (global + per-keyword limits)** | Prevents runaway runs with `maxLeadsPerKeyword` and free-tier cap |
| ✅ **Built-in proxy support** | Includes proxy support for more reliable scraping |

***

### Key features

- 🔍 **YouTube lead generator tool by keywords**: Search for channels using the `keywords` list to drive your prospecting workflow.
- 📧 **Accurate email extraction from channel pages**: Extracts email addresses from publicly available channel text content.
- 🎯 **B2B and B2C lead collection options**: Collects both consumer-style and custom/B2B-style emails from the scraped text.
- 🧰 **All-in-one channel + contact enrichment**: Produces channel metadata together with `emails` so you can enrich outreach lists immediately.
- 🛡️ **Resilience through retries and fallbacks**: Uses retry logic (including backoff) when requests fail or hit rate limiting.
- 💾 **Real-time saving to dataset**: As soon as a channel is enriched, results are pushed to the dataset during the run.
- 🌐 **Input flexibility for outreach planning**: Use `country` and keyword batching to narrow leads for specific markets.

***

### Input

Provide input via an `input.json` file. Example structure:

```json
{
  "keywords": ["fitness", "tech reviewer", "gaming"],
  "country": "United States",
  "maxLeadsPerKeyword": 20,
  "scrapeLeadsWithEmail": false
}
```

#### Input Fields

| Field | Required | Description |
| --- | --- | --- |
| `keywords` | Yes | List of keywords to search for YouTube channels (for example: `"tech reviewer"`, `"fitness"`, `"gaming"`). |
| `country` | No | Target country for leads. Select one of the allowed country values (defaults to `"United States"`). |
| `maxLeadsPerKeyword` | No | Maximum number of leads to collect for each keyword (defaults to `20`). Note: on the free tier, the run is capped at **100 emails total**. |
| `scrapeLeadsWithEmail` | No | If enabled, the actor returns only channels that have an email address available (email-only filtering). Defaults to `false`. |

***

### Output

The actor saves each enriched channel’s data in JSON format to the dataset.

Example dataset item:

```json
{
  "keyword": "fitness",
  "channel_name": "Example Channel",
  "channel_handle": "examplehandle",
  "emails": ["contact@example.com"],
  "channel_url": "https://www.youtube.com/@examplehandle",
  "subscriber_count": "123K",
  "video_count": "456",
  "joined_date": "Jan 1, 2015",
  "channel_description": "Channel description text...",
  "social_links": {
    "twitter": "https://twitter.com/example"
  },
  "custom_url": "https://www.youtube.com/@examplehandle",
  "avatar_url": "https://example.com/avatar.jpg",
  "success": true,
  "error_message": null
}
```

#### Output Fields

| Field | Type | Description |
| --- | --- | --- |
| `keyword` | string | The keyword that was used to generate this lead. |
| `channel_name` | string | YouTube channel name. |
| `channel_handle` | string | Channel handle (when available). |
| `emails` | array | List of extracted email addresses found in the channel’s publicly available text content. |
| `channel_url` | string | Normalized YouTube channel URL. |
| `subscriber_count` | string | Subscriber count as text (if available). |
| `video_count` | string | Video count as text (if available). |
| `joined_date` | string | Channel joined date as text (if available). |
| `channel_description` | string | Channel description text (if available). |
| `social_links` | object | Social links found from the channel’s external links (e.g., `twitter`, `instagram`, `linkedin`, etc., when detected). |
| `custom_url` | string | Channel custom URL (when available). |
| `avatar_url` | string | URL to the channel avatar image (when available). |
| `success` | boolean | Indicates whether the channel scrape/enrichment succeeded. |
| `error_message` | string | Error details when scraping/enrichment fails. |

After the run, you can export your dataset (JSON and CSV are typically supported by Apify dataset tools) to plug results into outreach tools or spreadsheets.

***

### How to use YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails) (via Apify Console)

1. **Open Apify Console**\
   Log in at [console.apify.com](https://console.apify.com) and go to the **Actors** section.

2. **Find the actor**\
   Search for **YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails)**.

3. **Configure input in the INPUT panel**\
   Use the form (or paste JSON) and set at least `keywords`. Optionally choose `country`, set `maxLeadsPerKeyword`, and toggle `scrapeLeadsWithEmail`.

4. **Set your lead limits (important)**\
   On the free tier, the actor is capped at **100 emails total per run**. You can still use `maxLeadsPerKeyword` to control how many leads you try to gather per keyword.

5. **(Optional) Watch proxy behavior and logs**\
   During execution, monitor logs to see progress, filtering decisions, and any retry-related messages.

6. **Run the actor**\
   Click **Run**. The actor processes each keyword and enriches channels as it finds them.

7. **Open the OUTPUT dataset**\
   When the run finishes, open the dataset titled **Scraped Leads** to review the table of channel leads.

8. **Export results for outreach**\
   Export your dataset to JSON/CSV from the Apify dataset UI and use it for your email finder for outreach campaigns.

No coding required—get accurate leads from **YouTube email finder** style data in minutes.

***

### Advanced features & SEO optimization

- 🧪 **Engineered for YouTube marketing lead generation**: The actor is designed to help you find leads from YouTube and extract emails alongside channel metrics.
- 🔒 **Email-only filtering for cleaner outreach lists**: Turn on `scrapeLeadsWithEmail` when you want channels that include an email address.
- 🌍 **Country-focused prospecting**: Use `country` to tailor your YouTube prospecting leads for a specific market.
- 🕒 **Resilience under real-world conditions**: Includes retries and fallbacks to improve success when requests fail or rate limits occur.
- 📋 **Batching-friendly discovery**: Multiple `keywords` are processed, with controls to cap output.

***

### Best use cases

- 📈 **Marketing team lead generation**: Build a targeted YouTube contact email scraper list for influencer marketing and partnerships.
- 💼 **B2B sales prospecting**: Find B2B YouTube leads with channel metadata and emails to speed up outreach workflows.
- 🧑‍💻 **Content and creator research**: Identify channels in a niche, then enrich your dataset with emails and social links.
- ✉️ **Cold email campaign preparation**: Use the YouTube email finder output to generate a free email finder 100 sized seed list for testing.
- 🧠 **Data analysis & segmentation**: Combine `subscriber_count`, `video_count`, and `joined_date` with extracted emails to segment audiences by channel maturity.
- 🏷️ **B2C affiliate and sponsorship sourcing**: Gather YouTube prospecting leads for sponsorship outreach using keyword-based discovery.
- 🔄 **CRM enrichment pipeline**: Feed the structured dataset output (emails + channel data) into your CRM or marketing automation tools.

***

### Technical specifications

- **Supported Input Formats**
  - ✅ `keywords` as an array (required)
  - ✅ `country` as one of the enumerated country strings
  - ✅ `maxLeadsPerKeyword` as an integer (1–500)
  - ✅ `scrapeLeadsWithEmail` as a boolean

- **Proxy Support**
  - ✅ Built-in proxy support for more reliable scraping
  - ❌ Proxy configuration fields are not exposed as custom input fields in the actor schema

- **Retry Mechanism**
  - ✅ Retries are used (with exponential backoff) to handle failures and rate limiting
  - ❌ Exact retry timing strategy is not user-configurable via inputs

- **Dataset Structure**
  - ✅ Saves to the **dataset** configured as **“Scraped Leads”**
  - ✅ Includes channel + email fields such as `channel_name`, `channel_url`, `emails`, and `avatar_url`

- **Rate Limits & Performance**
  - ✅ Includes optional delays (`request_delay` is used internally) to improve stability
  - ✅ Global cap on the free tier: **100 emails per run**
  - ❌ No guaranteed throughput number is provided in the actor inputs

- **Limitations**
  - ❌ Channels without publicly available email text may be filtered out when `scrapeLeadsWithEmail` is enabled
  - ❌ Leads found but failing to enrich successfully will not produce usable email/contact fields (`success` and `error_message` reflect this)

***

### FAQ

#### How many emails can I get on the free tier?

✅ On the free tier, the actor is capped at **100 emails total per run**, even if you set higher `maxLeadsPerKeyword`.

#### Do I need to provide keywords?

✅ Yes. `keywords` is the only required input field. Provide at least one keyword to start YouTube prospecting leads discovery.

#### Can I return only channels that have an email?

✅ Yes. Enable `scrapeLeadsWithEmail` to keep only channels that have an email address available in their publicly available text content.

#### What data types are included in the output?

✅ The dataset includes channel metadata (like `channel_name`, `subscriber_count`, `video_count`, `joined_date`, `channel_description`, `avatar_url`) and contact data (`emails`), plus `social_links` and `channel_url`.

#### Is this tool good for both B2B and B2C outreach?

✅ Yes. The extracted emails can include both consumer-style and custom/B2B-style email addresses found in channel text, making it useful for both B2B YouTube leads and B2C YouTube leads workflows.

#### Can I use this from Python or as an API integration?

✅ The actor is designed to run in Apify environments. You can integrate it through Apify’s standard run capabilities, and then consume the **Scraped Leads** dataset output in your pipeline.

#### What happens if a channel cannot be scraped?

❌ When scraping/enrichment fails, the dataset item will reflect it via `success: false` and `error_message` (while successful items contain the extracted fields like `emails`).

#### Is it legal/safe to use extracted emails for outreach?

✅ The actor only accesses **publicly available sources**, but you are responsible for complying with applicable laws and platform rules (including GDPR/CCPA, spam regulations, and site terms).

***

### Support & feature requests

If you’re using **YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails)** and have feedback, I’d love to hear it. 💬

- 💡 **Feature Requests**: Want enhancements like easier CSV export options, additional filters, or custom output formatting? Share what you need and how you’d use it for YouTube lead generator tool workflows.
- 📧 **Contact**: For support, reach out at <dataforleads@gmail.com>.

Your feedback helps shape the roadmap for this YouTube email finder and outreach data generator.

***

### *YouTube Leads Generator - B2B & B2C Email Finder (Free 100 Emails)* — Final thoughts

*If you want the most comprehensive and SEO-optimized YouTube marketing lead generation workflow, this is a great starting point.* Load your keywords, run the actor, and export your structured leads to move faster with outreach.

***

### Disclaimer

**This actor accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected pages.

You are responsible for ensuring your use complies with applicable laws and regulations (including GDPR, CCPA, spam regulations) and with each platform’s terms of service. Always use extracted data responsibly, ethically, and for legitimate purposes.

For data removal requests, contact <dataforleads@gmail.com>.

# Actor input Schema

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

List of keywords to search for YouTube channels (e.g., 'tech reviewer', 'fitness', 'gaming').

## `country` (type: `string`):

Select the target country for leads.

## `maxLeadsPerKeyword` (type: `integer`):

Maximum number of leads to collect for each keyword. Free users are capped at 100 emails total per run.

## `scrapeLeadsWithEmail` (type: `boolean`):

If enabled, only returns channels that have an email address in their description.

## Actor input object example

```json
{
  "keywords": [
    "fitness"
  ],
  "country": "United States",
  "maxLeadsPerKeyword": 20,
  "scrapeLeadsWithEmail": 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": [
        "fitness"
    ],
    "country": "United States",
    "maxLeadsPerKeyword": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("solid-scraper/youtube-leads-generator").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": ["fitness"],
    "country": "United States",
    "maxLeadsPerKeyword": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("solid-scraper/youtube-leads-generator").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": [
    "fitness"
  ],
  "country": "United States",
  "maxLeadsPerKeyword": 20
}' |
apify call solid-scraper/youtube-leads-generator --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/USfzDzO4Ne71rCblo/builds/0JPtplfIrjdsxLjer/openapi.json
