# Youtube Leads Generator (`contacts-api/youtube-leads-generator`) Actor Build targeted creator and business lists using our YouTube Leads Generator. Extract channel emails and data for outreach, partnerships, and lead generation—reliable and efficient. - **URL**: https://apify.com/contacts-api/youtube-leads-generator.md - **Developed by:** [Lead Heaven](https://apify.com/contacts-api) (community) - **Categories:** Lead generation, Social media, Automation - **Stats:** 54 total users, 4 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 - Email Scraper & Influencer Finder **The Ultimate YouTube Lead Generator for B2B Sales, Influencer Marketing, and Outreach.** Extract verified emails, subscriber counts, social links, and channel data from YouTube at scale. Ideal for connecting with creators, brands, and potential partners. --- ### ✨ Key Features * **📧 Email Scraper**: Automatically find public email addresses from channel descriptions and social links. * **🏗️ Niche Targeting**: Search by keywords (e.g., "tech reviewer", "gaming channel", "beauty guru"). * **🌍 Location Filtering**: Target channels in specific countries (USA, UK, India, Germany, etc.). * **📊 Channel Metrics**: Get Subscriber Count, Video Count, View Count, and Joined Date. * **🔗 Social Links**: Extract links to Instagram, Twitter, Facebook, and websites. * **⚡ Fast & Reliable**: Built on Apify's high-performance infrastructure. * **🆓 Free Tier Available**: EXTRACT 100 EMAILS FOR FREE per run! Start building your list today. --- ### �️ How It Works This actor uses a smart **two-step process** to find the most relevant leads: 1. **Discovery**: It uses advanced Google Search operators to find YouTube channels matching your specific keywords and location. This allows for finding channels that might be buried in YouTube's native search. 2. **Enrichment**: It visits each channel's "About" page to verify the data and extract **public email addresses** hidden in the description or business inquiries section (where accessible publicly). --- ### �📝 Input Parameters | Parameter | Type | Default | Description | | :--- | :--- | :--- | :--- | | **`keywords`** | `array` | `["tech reviewer", "fitness"]` | List of keywords to search for channels. | | **`country`** | `string` | `"United States"` | Target country for the search. | | **`maxLeadsPerKeyword`** | `integer` | `20` | Max leads to collect per keyword. **(Free users capped at 100 total)** | | **`scrapeLeadsWithEmail`** | `boolean` | `false` | If true, prioritizes channels that likely contain email addresses. | --- ### 📦 Output Data Format The actor outputs clean, structured JSON data ready for outreach. #### JSON Example ```json { "keyword": "tech reviewer", "channel_name": "Marques Brownlee", "channel_handle": "@mkbhd", "emails": ["marques@mkbhd.com"], "channel_url": "https://www.youtube.com/@mkbhd", "subscriber_count": "18.5M", "video_count": "1,600", "channel_description": "Quality Tech Videos | YouTuber | Geek | Consumer Electronics...", "social_links": { "twitter": "https://twitter.com/mkbhd", "instagram": "https://instagram.com/mkbhd" } } ```` *** ### � Best Practices - **Use Category Keywords**: Keywords like "Review", "Unboxing", "Tutorial" help find specific types of creator content. - **Niche Down**: Instead of just "Gaming", try "Minecraft Mod Reviews" or "Indie Game Developer" for better targeting. - **Check Socials**: If an email isn't directly available, the scraped social links (Instagram/Twitter) often provide another contact method. *** ### �🚀 Use Cases - **Influencer Marketing**: Find YouTubers with high engagement for sponsorships. - **B2B Sales**: Reach out to businesses with YouTube channels. - **Affiliate Marketing**: Recruit partners to review your products. - **Content Collaboration**: Connect with creators for collabs. *** ### ❓ FAQ **Q: Why do some channels not have emails?** A: We scrape emails that are publicly listed in the channel description. We can't access emails behind the "View Email Address" captcha button without higher costs/complexity, so we focus on readily available contact info. **Q: Is this safe for my Google account?** A: Yes! This scraper uses Apify's residential proxies and does not require your Google/YouTube login credentials. **Q: What is the Free Tier limit?** A: You can scrape up to 100 emails per run for free. For unlimited access, upgrade to a paid Apify plan. *** ### 💎 Pricing & Limits - **Free Users**: Capped at **100 emails per run**. - **Premium Users**: **Unlimited** emails (subject to Apify platform rates). Upgrade to an Apify paid plan for heavy-duty scraping! *** ### 📞 Support & Feedback We value your feedback! If you have feature requests, bug reports, or need custom scraping solutions, please contact us: **📧 Email:** *** #### Keywords *youtube lead generator, email scraper, youtube scraper, influencer finder, b2b leads, youtuber emails, channel scraper, social media scraper* # 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 '' 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("contacts-api/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 '' 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("contacts-api/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 contacts-api/youtube-leads-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=contacts-api/youtube-leads-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Youtube Leads Generator", "description": "Build targeted creator and business lists using our YouTube Leads Generator. Extract channel emails and data for outreach, partnerships, and lead generation—reliable and efficient.", "version": "1.0", "x-build-id": "N0yaHYHPNlu9f5yxj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/contacts-api~youtube-leads-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-contacts-api-youtube-leads-generator", "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/contacts-api~youtube-leads-generator/runs": { "post": { "operationId": "runs-sync-contacts-api-youtube-leads-generator", "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/contacts-api~youtube-leads-generator/run-sync": { "post": { "operationId": "run-sync-contacts-api-youtube-leads-generator", "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').", "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": "Select the target country for leads.", "default": "United States" }, "maxLeadsPerKeyword": { "title": "Max Leads Per Keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of leads to collect for each keyword. Free users are capped at 100 emails total per run.", "default": 20 }, "scrapeLeadsWithEmail": { "title": "Only Scrape Leads With Email", "type": "boolean", "description": "If enabled, only returns channels that have an email address in their description.", "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 } } } } } } } } } } ```