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

📺 Mass YouTube Leads Generator finds high-intent creators & channels fast using smart filters. 🚀 Grow your outreach, boost conversions, and build a targeted pipeline for agencies, marketers & sales teams—automatically.

- **URL**: https://apify.com/solid-scraper/mass-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 🔍

**YouTube Leads Generator - B2B & B2C Email Finder** is an Apify actor that helps you build a prospecting list by scraping YouTube channels from **public web data** and extracting contact emails plus channel details. Whether you’re using it for **YouTube lead generation tool** workflows, **lead gen from YouTube**, or **email finder for YouTube leads**, this actor is designed to solve the time-consuming task of finding relevant channels and contact emails at scale—saving you hours of manual work.

Whether you’re a marketer, business developer, recruiter, or data enthusiast, you can use **YouTube B2B leads** and **YouTube B2C leads** search settings to quickly generate a structured outreach dataset.

***

### Why choose YouTube Leads Generator - B2B & B2C Email Finder?

| Feature | Benefit |
| --- | --- |
| ✅ **YouTube channel leads + email extraction** | Extract emails and channel details in one run for outreach lists and enrichment |
| ✅ **Email-only or full channel search mode** | Collect leads broadly or focus on channels that include email addresses |
| ✅ **Proxy support + resilient scraping** | Improves reliability with built-in resilience for large batches |
| ✅ **Structured dataset output** | Receive clearly labeled fields (emails, channel URL, subscribers, and more) ready for export |
| ✅ **Keyword-based bulk processing** | Use multiple keywords and collect results per keyword up to your selected limit |
| ✅ **Real-time saving to the dataset** | Each scraped lead is pushed to the dataset as soon as it’s available |

***

### Key features

- 📊 **Structured lead output for email finder for YouTube leads:** Each successful lead includes channel metadata and extracted emails in a consistent structure.
- 📧 **B2B & B2C oriented email extraction:** Extracts email addresses from channel descriptions and publicly visible channel content.
- 🎯 **Keyword-driven YouTube to email lead generation:** Search each keyword separately to build niche-specific **YouTube outreach list builder** outputs.
- 🌍 **Country filtering for YouTube lead scraper workflows:** Optionally filter results by a target country (or run worldwide by leaving it empty).
- 🛡️ **Reliability with resilience:** Includes built-in retries and fallback behavior to keep runs productive.
- 💾 **Real-time dataset saving:** Leads are pushed to the dataset as they’re scraped, so progress is preserved during long runs.
- 🔄 **Email-only lead enrichment mode:** When enabled, the actor filters for channels that contain emails, using common email providers (like Gmail, Hotmail, Outlook, Yahoo).
- 🔎 **Complete YouTube channel details:** Output includes channel name, handle, URL, subscribers, videos, joined date, description, avatar, and social links when available.

***

### Input

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

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

#### Input Fields

| Field | Required | Description |
| --- | --- | --- |
| `keywords` | Yes | List of keywords to search for YouTube channels. Each keyword is searched separately (for example: `fitness`, `tech reviewer`, `gaming`). |
| `country` | No | Target country filter for results. Leave empty for worldwide results. Must be one of the supported enum values (e.g., `United States`, `United Kingdom`, `Canada`, etc.). |
| `maxLeadsPerKeyword` | No | Maximum number of leads to collect for each keyword (range: 1–500). Default is `20`. |
| `scrapeLeadsWithEmail` | No | Whether to find leads with email only. If enabled, the actor filters for channels that have emails in their description using common email providers (Gmail, Hotmail, Outlook, Yahoo). If disabled, it finds all channels matching keywords. Default is `false`. |

***

### Output

After execution, the actor saves each lead’s data in JSON format to the dataset (dataset title: **Scraped Leads**).

```json
{
  "keyword": "fitness",
  "channel_name": "Example Channel",
  "channel_handle": "examplehandle",
  "emails": ["contact@example.com"],
  "channel_url": "https://www.youtube.com/@examplehandle/about",
  "subscriber_count": "1.2M subscribers",
  "video_count": "320 videos",
  "joined_date": "Jan 2018",
  "channel_description": "Channel description text...",
  "social_links": {
    "twitter": "https://twitter.com/example",
    "linkedin": "https://linkedin.com/company/example"
  },
  "custom_url": "https://www.youtube.com/@examplehandle",
  "avatar_url": "https://example.com/avatar.jpg"
}
```

#### Output Fields

| Field | Type | Description |
| --- | --- | --- |
| `keyword` | string | The keyword that produced this lead (one lead per scraped channel per keyword run). |
| `channel_name` | string | Channel title/name. |
| `channel_handle` | string | Channel handle (e.g., vanity handle). |
| `emails` | array | Extracted email addresses found from publicly available channel content. |
| `channel_url` | string | Normalized channel URL. |
| `subscriber_count` | string | Subscriber count text (as extracted from the channel data). |
| `video_count` | string | Video count text (as extracted from the channel data). |
| `joined_date` | string | Channel joined date text. |
| `channel_description` | string | Channel description text. |
| `social_links` | object | Social links found from the channel’s external links (only supported platforms are mapped into this object). |
| `custom_url` | string | Custom URL value from the channel metadata. |
| `avatar_url` | string | URL to the channel avatar image. |

> Note: The dataset is stored with the transformation/display fields listed above (matching the dataset schema). The actor may also log failures, but only successfully saved channel leads appear as dataset rows.

***

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

1. **Open Apify Console**\
   Log in at https://console.apify.com and go to the **Actors** tab.

2. **Find the actor**\
   Search for **YouTube Leads Generator - B2B & B2C Email Finder** and open the actor page.

3. **Enter your input**\
   In the **INPUT** section, provide your JSON matching the fields:\
   `keywords` (required), and optionally `country`, `maxLeadsPerKeyword`, `scrapeLeadsWithEmail`.

4. **Set your lead strategy (email-only vs full)**\
   If you want **prospecting email database** results focused on outreach-ready contacts, enable `scrapeLeadsWithEmail`. If you want a broader **YouTube lead scraper** list, disable it.

5. **Choose your batch size per keyword**\
   Use `maxLeadsPerKeyword` (1–500) to control how many leads to collect for each keyword.

6. **Run the actor**\
   Click **Run**. Watch the live logs to see progress per keyword and how many leads are being collected.

7. **Review the dataset output**\
   When the run completes, open the **OUTPUT** tab and open the dataset **Scraped Leads** to view your leads in a table.

8. **Export your results**\
   Export to JSON/CSV from the dataset UI and plug it directly into your CRM, outreach workflow, or analysis pipeline.

No coding required — get accurate results in minutes.

***

### Advanced features & SEO optimization

- ⚙️ **Engineered for lead gen from YouTube:** Built specifically as a **YouTube lead generation tool** for generating **YouTube outreach list builder** datasets with emails and channel metadata.
- 🧭 **Input normalization with URL handling:** Produces normalized channel URLs in the dataset to keep your **YouTube prospecting email list** clean.
- 🔄 **Retry & fallback resilience:** Includes retries and fallback behavior to help long runs finish with more usable leads.
- 📌 **Channel completeness in one row:** Subscriber/video/joined date, description, avatar, and mapped social links are included alongside extracted emails for faster enrichment.
- 📧 **Email provider filtering mode:** The email-only mode uses common email providers (like Gmail, Hotmail, Outlook, Yahoo) to focus on channels more likely to include emails.

***

### Best use cases

- 📈 **Sales teams building YouTube B2B leads:** Generate a prospecting list of relevant channels and emails for targeted outreach campaigns.
- 🎯 **Marketers creating a YouTube B2C leads pipeline:** Collect contact emails plus channel details to personalize campaigns by niche.
- 🧾 **Data analysts enriching datasets:** Combine YouTube channel metrics (subscribers, videos, joined date) with extracted emails for analysis-ready tables.
- 🧑‍💼 **Recruiters sourcing talent/contact points:** Use channel-level descriptions and emails to speed up early outreach research.
- 🛠️ **CRM automation and lead enrichment toolchains:** Push structured leads into your pipeline with consistent fields for downstream automation.
- 🔎 **Research workflows for find business emails from YouTube:** Build a curated dataset for studying how creators and businesses publish contact information.
- ✉️ **Cold outreach list building:** Turn YouTube keyword research directly into an email finder for YouTube leads you can act on.

***

### Technical specifications

- **Supported Input Formats**
  - ✅ JSON input via `keywords` (array of strings)
  - ✅ Optional country filter via `country` (enum values listed in the input schema)
  - ✅ Optional lead limits via `maxLeadsPerKeyword` (1–500)
  - ✅ Optional email-only mode via `scrapeLeadsWithEmail` (boolean)

- **Proxy Support**
  - ✅ Built-in proxy support for reliable scraping
  - ✅ Uses resilient request handling to improve completion rates on larger batches

- **Retry Mechanism**
  - ✅ Includes retries (implemented with retry logic for fetching and scraping)

- **Dataset Structure**
  - ✅ Dataset title: **YouTube Leads Dataset** (displayed dataset: **Scraped Leads**)
  - ✅ Fields saved per lead include: `keyword`, `channel_name`, `channel_handle`, `emails`, `channel_url`, `subscriber_count`, `video_count`, `joined_date`, `channel_description`, `social_links`, `custom_url`, `avatar_url`

- **Rate Limits & Performance**
  - ✅ Designed for batch runs with built-in delays and resilience
  - Performance varies based on target availability and scraping conditions

- **Limitations**
  - ❌ If channels don’t publish emails publicly, email-only mode won’t save them
  - ❌ Channels with restricted or consent-gated pages may fail to extract contact details

***

### FAQ

#### Do I need an API key or coding to run this actor?

✅ No. You can run **YouTube Leads Generator - B2B & B2C Email Finder** directly from Apify Console by providing the JSON input. It outputs a ready-to-export dataset with extracted emails and channel information.

#### What does `scrapeLeadsWithEmail` do?

✅ If `scrapeLeadsWithEmail` is enabled, the actor focuses on channels that have emails in their description using common email providers (like Gmail, Hotmail, Outlook, Yahoo). If disabled, it finds all channels matching your keywords.

#### Can I target a specific country for YouTube B2B leads or YouTube B2C leads?

✅ Yes. Use the `country` field to filter results. If you leave it empty, the actor will run worldwide.

#### How many leads can I collect per keyword?

✅ You control this with `maxLeadsPerKeyword` (integer from 1 to 500). The actor collects up to that many leads per keyword.

#### What gets saved in the dataset?

✅ The dataset rows include fields like `keyword`, `channel_name`, `channel_handle`, `emails`, `channel_url`, `subscriber_count`, `video_count`, `joined_date`, `channel_description`, `social_links`, `custom_url`, and `avatar_url`.

#### Does the actor save leads in real time?

✅ Yes. Leads are pushed to the dataset as they are successfully scraped, so you can monitor progress and avoid losing results during long runs.

#### Is the data collected from publicly available sources?

✅ Yes. The actor scrapes data from publicly available sources and extracts contact emails and channel details that are present in that public content.

#### Can you help with troubleshooting or feature requests?

✅ Yes. Share feedback and feature ideas for **YouTube Leads Generator - B2B & B2C Email Finder** by emailing <dataforleads@gmail.com>. Your input helps shape improvements to this YouTube lead generation tool.

***

### Support & feature requests

Want to improve **YouTube Leads Generator - B2B & B2C Email Finder** or request enhancements for your YouTube outreach list builder workflow?

- 💡 **Feature Requests:** Examples include adding more export options, expanding matching logic, or improving field coverage in the dataset for YouTube to email lead generation use cases.
- 📧 **Contact:** Send your request to <dataforleads@gmail.com>.

Feedback directly influences the roadmap for this actor.

***

**Ready to scale your YouTube lead generation?* This SEO-optimized **YouTube Leads Generator - B2B & B2C Email Finder** helps you turn keywords into structured email-ready lead data fast.*

***

### Disclaimer

This tool only accesses **publicly accessible sources**. It does not access private profiles, authenticated data, or password-protected pages. It is your responsibility to comply with applicable laws and regulations (including GDPR and CCPA where relevant), as well as platform terms of service and spam/anti-abuse rules.

For data removal requests, contact <dataforleads@gmail.com>. Use this actor responsibly, ethically, and for legitimate purposes only.

# Actor input Schema

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

List of keywords to search for YouTube channels (e.g., 'tech reviewer', 'fitness', 'gaming'). Each keyword will be searched separately.

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

Filter results by country. Leave empty for worldwide results.

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

Maximum number of leads to collect for each keyword (1-500).

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

If enabled, will search for channels that have emails in their description (using common email providers like Gmail, Hotmail, Outlook, Yahoo). If disabled, will find all channels matching keywords.

## 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/mass-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/mass-youtube-leads-generator").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 '{
  "keywords": [
    "fitness"
  ],
  "country": "United States",
  "maxLeadsPerKeyword": 20
}' |
apify call solid-scraper/mass-youtube-leads-generator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,solid-scraper/mass-youtube-leads-generator"
        }
    }
}

```

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/nZvIsqGw6AANGmuRx/builds/dgRAqR07F1nEisejq/openapi.json