# Youtube Channel Email Scraper (`contacts-api/youtube-channel-email-scraper`) Actor

Find creator contact details effortlessly with our YouTube Channel Email Scraper. Extract verified emails from YouTube channels for outreach, lead generation, and marketing with high accuracy, speed, and scalability.

- **URL**: https://apify.com/contacts-api/youtube-channel-email-scraper.md
- **Developed by:** [Lead Heaven](https://apify.com/contacts-api) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 57 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$9.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 Channel Email Scraper 🚀

**YouTube Channel Email Scraper** is a powerful lead generation tool that allows you to extract **email addresses**, **social media links**, and **channel statistics** from YouTube channels. It supports all YouTube URL formats (handles, channel IDs, user URLs) and automatically filters for public contact information.

---

#### Why Choose YouTube Channel Email Scraper?

| Feature                           | Benefit                                        |
| --------------------------------- | ---------------------------------------------- |
| 🎯 **Universal Support**           | Works with @handles, /c/ URLs, and Channel IDs |
| 📧 **Email Discovery**             | Extract public emails from "About" pages       |
| 🔗 **Social Links**                | Get Instagram, Twitter, Facebook, and more     |
| ⚡ **Fast & Efficient**            | Bulk scrape multiple channels in parallel      |
| 🔒 **Free Tier**                   | Free users limited to 100 emails/run           |

---

### 🔑 Key Features

*   ✅ **Email Extraction**: Intelligent parsing of "About" pages for business emails.
*   ✅ **Social Media parsing**: Automatically detects and extracts linktree, instagram, etc.
*   ✅ **Rich Data**: Subscriber counts, video counts, join dates, and descriptions.
*   ✅ **Safe & Reliable**: Built-in retry logic and proxy support.

---

### 📝 Input

The scraper accepts a list of YouTube channel URLs.

#### Example Input
```json
{
  "startUrls": [
    { "url": "https://www.youtube.com/@mkbhd" },
    { "url": "https://www.youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ" }
  ],
  "extractSocialLinks": true
}
````

| Field | Description |
| :--- | :--- |
| `startUrls` | List of YouTube channel URLs to scrape. |
| `extractSocialLinks` | If `true`, extracts links to other social platforms. |

***

### 📦 Output

You get a structured dataset with the following fields:

| Field | Description |
| :--- | :--- |
| `channel_name` | Name of the YouTube channel |
| `channel_handle` | The @handle of the channel |
| `channel_url` | Full URL to the channel |
| `business_email` | **Primary email found** |
| `emails` | List of all emails found on the page |
| `subscriber_count` | Number of subscribers |
| `social_links` | Dictionary of social media links (Twitter, Instagram, etc) |
| `channel_description` | Full text of the "About" section |

#### Example Output

```json
{
  "channel_name": "Marques Brownlee",
  "channel_handle": "mkbhd",
  "channel_url": "https://www.youtube.com/@mkbhd",
  "business_email": "marques@mkbhd.com",
  "emails": ["marques@mkbhd.com"],
  "subscriber_count": "18M subscribers",
  "social_links": {
    "twitter": "https://twitter.com/MKBHD",
    "instagram": "https://instagram.com/mkbhd"
  },
  "channel_description": "Quality Tech Videos | YouTuber | Geek | Consumer Electronics..."
}
```

***

### 🚀 How to Use

1. **Enter URLs**: Paste a list of YouTube channels (URLs or handles).
2. **Run Scraper**: Start the actor.
3. **Download**: Export your leads to Excel, CSV, or JSON.

***

### 🛠️ Support

We’re here to help! If you have questions or feedback, feel free to contact us:

- 📩 **Email**: <leadheavencontact@gmail.com>

***

#### Disclaimer

This scraper collects data from publicly available YouTube channel "About" pages. It does not access private account data. Users are responsible for complying with YouTube's Terms of Service and applicable data privacy laws.

# Actor input Schema

## `startUrls` (type: `array`):

List YouTube channels using any format: @handle, username, channel ID (UCxxxxxx), or full URLs (/@channel, /c/, /user/, /channel/). The actor will automatically detect and process all formats.

## `extractSocialLinks` (type: `boolean`):

Extract additional social media links from channel about page (Twitter, Instagram, Facebook, etc.).

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.youtube.com/@mkbhd"
    },
    {
      "url": "https://www.youtube.com/@veritasium"
    }
  ],
  "extractSocialLinks": true
}
```

# 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 = {
    "startUrls": [
        {
            "url": "https://www.youtube.com/@mkbhd"
        },
        {
            "url": "https://www.youtube.com/@veritasium"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("contacts-api/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": [
        { "url": "https://www.youtube.com/@mkbhd" },
        { "url": "https://www.youtube.com/@veritasium" },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("contacts-api/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 '{
  "startUrls": [
    {
      "url": "https://www.youtube.com/@mkbhd"
    },
    {
      "url": "https://www.youtube.com/@veritasium"
    }
  ]
}' |
apify call contacts-api/youtube-channel-email-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Youtube Channel Email Scraper",
        "description": "Find creator contact details effortlessly with our YouTube Channel Email Scraper. Extract verified emails from YouTube channels for outreach, lead generation, and marketing with high accuracy, speed, and scalability.",
        "version": "1.0",
        "x-build-id": "QumdYFxVBhSIYduSF"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/contacts-api~youtube-channel-email-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-contacts-api-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/contacts-api~youtube-channel-email-scraper/runs": {
            "post": {
                "operationId": "runs-sync-contacts-api-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/contacts-api~youtube-channel-email-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-contacts-api-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": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "YouTube Channel URLs or Handles",
                        "type": "array",
                        "description": "List YouTube channels using any format: @handle, username, channel ID (UCxxxxxx), or full URLs (/@channel, /c/, /user/, /channel/). The actor will automatically detect and process all formats.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "extractSocialLinks": {
                        "title": "Extract Social Media Links",
                        "type": "boolean",
                        "description": "Extract additional social media links from channel about page (Twitter, Instagram, Facebook, etc.).",
                        "default": true
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
