# Mass Youtube Channel Email Scraper (`scrapers-hub/mass-youtube-channel-email-scraper`) Actor ๐Ÿ“ง Mass YouTube Channel Email Scraper (mass-youtube-channel-email-scraper) extracts emails from YouTube channel data at scale. ๐Ÿš€ Perfect for B2B lead gen, outreach, partnerships & market research. โšก Fast, targeted, efficient. - **URL**: https://apify.com/scrapers-hub/mass-youtube-channel-email-scraper.md - **Developed by:** [Scrapers Hub](https://apify.com/scrapers-hub) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.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 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 ### YouTube Leads Generator - B2B & B2C Email Finder ๐Ÿ”Ž **YouTube Leads Generator - B2B & B2C Email Finder** helps you generate targeted lead lists from YouTube channels by using your **keywords** and extracting **contact emails** from publicly available sources. Whether you're a marketer, sales operator, recruiter, or data enthusiast building a **YouTube lead generation tool** for outreach, you can quickly turn โ€œinteresting channelsโ€ into a structured dataset of leads. Itโ€™s especially useful if youโ€™re using a **YouTube B2B leads email finder** or a **YouTube email extraction** workflow to save time at scale. --- ### Why choose YouTube Leads Generator - B2B & B2C Email Finder? | Feature | Benefit | |---|---| | โœ… **Keyword-based channel sourcing** | Find relevant YouTube channels by searching each keyword separately | | โœ… **Optional email-only filtering** | When enabled, collects leads only from channels that have emails in their description | | โœ… **Reliability with built-in retries** | Uses retry logic to improve resilience when requests fail | | โœ… **Structured dataset output** | Saves consistent fields (channel metadata + `emails`) into the dataset for easy exports | | โœ… **Scales by controlling limits** | Set `maxLeadsPerKeyword` (1โ€“500) to manage batch size per keyword | | โœ… **Proxy support for more stable runs** | Includes built-in proxy support to help keep large scraping batches running smoothly | --- ### Key features - โœ… **Accurate email extraction**: Extracts email addresses from the channel description and related text content and stores them in `emails` - ๐Ÿ“ง **B2B and B2C email finder modes**: Use `scrapeLeadsWithEmail` to either collect all channels or keep only those with emails - ๐ŸŒ **Country filtering (optional)**: Set `country` to focus results by region (or leave it worldwide by using an empty country in the input) - ๐Ÿ”„ **Retry-first resilience**: Uses multiple attempts (`max_retries = 3`) for more dependable scraping - ๐Ÿ’พ **Real-time dataset saving**: Each successful lead is pushed to the Apify dataset as soon as itโ€™s scraped and enriched - ๐Ÿ“Š **Complete channel profile context**: Captures channel name, handle, URL, description, joined date, and more - ๐ŸŒ **YouTube channel URL normalization**: Accepts YouTube channel formats and normalizes them for consistency - ๐Ÿง  **Keyword-to-lead mapping**: Adds the originating `keyword` to each saved lead record for analysis and reporting --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["fitness", "tech reviewer"], "country": "United States", "maxLeadsPerKeyword": 20, "scrapeLeadsWithEmail": false } ```` #### Input Fields | Field | Required | Description | |---|---:|---| | `keywords` | โœ… | List of keywords to search for YouTube channels. Each keyword is processed separately (for example: `"tech reviewer"`, `"fitness"`, `"gaming"`). | | `country` | โŒ | Target country filter. Use one of the supported country names to narrow results. Leave empty for worldwide results. | | `maxLeadsPerKeyword` | โŒ | Maximum number of leads to collect for each keyword (`1-500`). The default is `20`. | | `scrapeLeadsWithEmail` | โŒ | If enabled, the actor filters to channels that have emails in their description (using common email providers like Gmail, Hotmail, Outlook, Yahoo). If disabled, it collects all matching channels. Default is `false`. | *** ### Output The actor saves each leadโ€™s data in the **YouTube Leads Dataset** (dataset view: **Scraped Leads**). ```json { "keyword": "fitness", "channel_name": "Example Fitness Channel", "channel_handle": "examplefitness", "emails": ["contact@example.com"], "channel_url": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxx", "subscriber_count": "123K", "video_count": "456", "joined_date": "Jan 2020", "channel_description": "Channel description text...", "social_links": { "twitter": "https://twitter.com/example" }, "custom_url": "https://www.youtube.com/@examplefitness", "avatar_url": "https://example.com/avatar.jpg" } ``` #### Output Fields | Field | Type | Description | |---|---|---| | `keyword` | string | The keyword that generated this lead record | | `channel_name` | string | The YouTube channelโ€™s name | | `channel_handle` | string | The channel handle (when available) | | `emails` | array | Array of extracted email addresses for the channel | | `channel_url` | string | Normalized channel URL (base channel URL) | | `subscriber_count` | string | Subscriber count text as found on the channel | | `video_count` | string | Video count text as found on the channel | | `joined_date` | string | Joined date text as found on the channel | | `channel_description` | string | Channel description text | | `social_links` | object | Social links extracted from the channel about section (keys like `twitter`, `instagram`, etc.) | | `custom_url` | string | The channelโ€™s vanity/custom URL (when available) | | `avatar_url` | string | Channel avatar/thumbnail URL | | `success` | boolean | Indicates whether the channel was scraped successfully | | `error_message` | string | Error details when `success` is not `true` | > Export note: You can export dataset results in common formats (e.g., JSON/CSV) directly from the Apify dataset UI after the run. *** ### 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. **Go to the INPUT section**\ Paste your `input.json` values into the input editor. The actor accepts: - `keywords` (required) - `country` - `maxLeadsPerKeyword` - `scrapeLeadsWithEmail` 4. **Choose your lead mode**\ If you want a true **YouTube to email leads** workflow, set `scrapeLeadsWithEmail` to `true`.\ If youโ€™re building a broader **YouTube outreach lead list** and will filter later, keep it `false`. 5. **Set batch size per keyword**\ Use `maxLeadsPerKeyword` to control how many leads to collect for each keyword (up to `500`). 6. **Run the actor**\ Click **Run**. Watch the logs for progress per keyword. If it encounters issues, it uses retry logic to keep the run moving. 7. **Review results in the dataset**\ After completion, open the **YouTube Leads Dataset** view **Scraped Leads**. Each row includes your `keyword`, channel metadata, and the extracted `emails` array (when present). 8. **Export for outreach or analysis**\ Export the dataset results (JSON/CSV) and import into your CRM, outreach automation, or analysis pipeline. No coding required โ€” get accurate leads from YouTube in minutes with **YouTube Leads Generator - B2B & B2C Email Finder**. ๐Ÿš€ *** ### Advanced features & SEO optimization - ๐Ÿ›ก๏ธ **Rate-limit resilience**: Built-in retry logic plus delays helps keep **YouTube email extraction** runs stable for larger batches - ๐Ÿงพ **Input normalization ready**: The actor normalizes channel URLs and produces consistent output, which is ideal for **lead generation from YouTube** pipelines - ๐Ÿ“Œ **Keyword-to-record linking**: Every saved record is tagged with `keyword`, making it easier to analyze which terms produce the best leads - ๐Ÿ’ก **Engineered for YouTube lead generation tool workflows**: Designed to function as a focused **email finder for business contacts** rather than a generic scraper - ๐Ÿ“ก **Compliance-oriented public data focus**: Extracts contact emails from publicly available channel information and related publicly accessible sources *** ### Best use cases - ๐Ÿ“ˆ **Growth marketing teams**: Build a **YouTube marketing lead generation** list by combining channel metrics with extracted emails for faster outreach - ๐Ÿง‘โ€๐Ÿ’ผ **B2B sales prospecting**: Use **YouTube B2B leads email finder** mode to prioritize channels that actually include contact emails - ๐Ÿช **Local businesses & agencies**: Generate a **YouTube outreach lead list** from niche keywords to target relevant creators, agencies, or service providers - ๐ŸŽ“ **Researchers & analysts**: Measure channel distributions and compare **subscriber\_count** / **joined\_date** against the presence of emails - ๐Ÿ‘ฉโ€๐Ÿ’ป **CRM and marketing automation users**: Feed a structured dataset (channel fields + `emails`) into enrichment and workflow systems - โœ‰๏ธ **Recruiters & talent sourcers**: Identify contact emails from professional creators using **find business emails from YouTube channels** - ๐Ÿงฐ **Data pipeline builders**: Use the consistent dataset schema to automate โ€œYouTube channels โ†’ email lead listโ€ production *** ### Technical specifications - **Supported Input Formats** - โœ… `keywords` as an array of search terms - โœ… `country` as one of the provided country names - โœ… `scrapeLeadsWithEmail` to switch between โ€œemail-only leadsโ€ vs โ€œall matching channelsโ€ - **Proxy Support** - โœ… Built-in proxy support is enabled for reliable scraping (with fallback behavior if proxy setup fails) - **Retry Mechanism** - โœ… Retries are used for failed requests (with exponential backoff) - **Dataset Structure** - โœ… Saves results to the **YouTube Leads Dataset** dataset view **Scraped Leads** - โœ… Output includes channel metadata fields plus an `emails` array (when available) - **Rate Limits & Performance** - โœ… Designed for batch runs where each keyword is processed up to `maxLeadsPerKeyword` - **Limitations** - โŒ Channels without publicly available contact emails may not appear in email-only mode (`scrapeLeadsWithEmail: true`) - โŒ Some channels may be marked unsuccessful when the channel page content cannot be fetched or parsed *** ### FAQ #### Do I need an API key or coding to run YouTube Leads Generator - B2B & B2C Email Finder? No. You can run it directly in Apify Console by providing the input values in the `input.json` format, and then export results from the dataset UI. #### What happens if I set `scrapeLeadsWithEmail` to `true`? If `scrapeLeadsWithEmail` is enabled, the actor searches in a way that filters for channels that have emails in their description and will save only leads that include extracted emails. #### What are the supported email formats the actor looks for? The actor extracts email addresses from publicly available text content and recognizes common email providers (including Gmail, Hotmail, Outlook, and Yahoo) when filtering for email-only mode. #### How many leads can I collect per keyword? Use `maxLeadsPerKeyword`. It accepts values from `1` to `500`, and the default is `20`. #### Can I target a specific country? Yes. Use the `country` input field and select one of the supported country names. If you leave it empty, the actor proceeds with worldwide results. #### Is the output ready for CSV/CRM import? Yes. The actor outputs a structured dataset with consistent fields (channel metadata + `emails`). After the run, you can export the dataset to formats supported by Apify. #### Why would a lead record have an error? A lead record may include `success: false` with an `error_message` when the actor could not successfully fetch or parse a channel page. #### Is this actor suitable for B2B and B2C email finding? โœ… Yes. The actor is built for both **B2B & B2C Email Finder** use cases by extracting email addresses from channel-related publicly available content and supporting an email-only lead mode. *** ### Support & feature requests Have questions about **YouTube Leads Generator - B2B & B2C Email Finder** or want to request improvements? ๐Ÿ’ฌ - ๐Ÿ’ก **Feature Requests**: Ideas like additional export formats, more customization around email filtering, or CRM-specific outputs are welcome. - ๐Ÿ“ง **Contact**: Email us at . Your feedback helps shape the roadmap for the **YouTube lead generation tool** experience. ๐Ÿ™Œ *** ### Closing CTA / Final thoughts *If you want a fast, structured way to turn YouTube channels into outreach-ready contact lists, **YouTube Leads Generator - B2B & B2C Email Finder** delivers the dataset you needโ€”without manual copy-paste.* *** ### Disclaimer **This tool only accesses publicly accessible sources**. It does not access private profiles, authenticated data, or password-protected pages. It is the userโ€™s responsibility to comply with applicable laws and platform rules (including GDPR, CCPA, spam regulations, and platform ToS). For any data removal requests, contact . Please use **YouTube Leads Generator - B2B & B2C Email Finder** 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 '' with your token const client = new ApifyClient({ 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("scrapers-hub/mass-youtube-channel-email-scraper").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 '' with your token. client = ApifyClient("") # 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("scrapers-hub/mass-youtube-channel-email-scraper").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 scrapers-hub/mass-youtube-channel-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapers-hub/mass-youtube-channel-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mass Youtube Channel Email Scraper", "description": "๐Ÿ“ง Mass YouTube Channel Email Scraper (mass-youtube-channel-email-scraper) extracts emails from YouTube channel data at scale. ๐Ÿš€ Perfect for B2B lead gen, outreach, partnerships & market research. โšก Fast, targeted, efficient.", "version": "1.0", "x-build-id": "vpZsBnmelLgR1JD3t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers-hub~mass-youtube-channel-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers-hub-mass-youtube-channel-email-scraper", "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/scrapers-hub~mass-youtube-channel-email-scraper/runs": { "post": { "operationId": "runs-sync-scrapers-hub-mass-youtube-channel-email-scraper", "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/scrapers-hub~mass-youtube-channel-email-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers-hub-mass-youtube-channel-email-scraper", "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": [ "keywords" ], "properties": { "keywords": { "title": "Search Keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "List of keywords to search for YouTube channels (e.g., 'tech reviewer', 'fitness', 'gaming'). Each keyword will be searched separately.", "items": { "type": "string" } }, "country": { "title": "Target Country", "enum": [ "United States", "United Kingdom", "Canada", "Australia", "India", "Germany", "France", "Spain", "Italy", "Brazil", "Mexico", "Japan", "South Korea", "China", "Singapore", "United Arab Emirates", "Netherlands", "Sweden", "Norway", "Denmark", "Switzerland", "Belgium", "Austria", "Ireland", "New Zealand", "South Africa" ], "type": "string", "description": "Filter results by country. Leave empty for worldwide results.", "default": "United States" }, "maxLeadsPerKeyword": { "title": "Maximum Leads Per Keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of leads to collect for each keyword (1-500).", "default": 20 }, "scrapeLeadsWithEmail": { "title": "Find Leads with Email Only", "type": "boolean", "description": "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.", "default": false } } }, "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 } } } } } } } } } } ```