# Youtube Instant Email Scraper (`endspec/youtube-instant-email-scraper`) Actor

\[Instant response] \[Passes most reCAPTCHA] Extract YouTube email addresses from channel ID or handle.

- **URL**: https://apify.com/endspec/youtube-instant-email-scraper.md
- **Developed by:** [EndSpec](https://apify.com/endspec) (community)
- **Categories:** Lead generation, Social media
- **Stats:** 706 total users, 34 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 1.00 out of 5 stars

## Pricing

from $60.00 / 1,000 channel-parsed-results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

Find email addresses for YouTube channels instantly.

**Passes most reCAPTCHA**

***

### Simple Input-Output Example

#### Input (specify either `id` or `channelHandle`):

```json
{
  "channelHandle": "@mrbeast"
}
```

#### Output:

```json
{
  "status": "success",
  "email": "contact@mrbeastbusiness.com",
  "found": true
}
```

**Important Notes:**

- Actor takes about **15s** to run
- Only **one email** can be inputted at a time
- Actor passes through **most** **reCAPTCHAs**, but **not** all
- Returns success even if no email is found
- Only returns error if the API service breaks
- If either no email is found or the captcha isn't passed, but the parsing is successful, you will **still be charged**
- The API bandwidth is not very high atm, so you sometimes might hit an internal rate limit. If that happens, you will **not** be charged
- If enough interest follows, we'll extend the API to accommodate higher rate limits
- Contact address for any issue / enquiry: contact@endspec.net

If you need more information on your leads (such as websites, socials, link.me platforms, etc.), you can use the **Youtube Emails, Socials and Urls Extractor**: https://apify.com/endspec/youtube-channel-contacts-extractor

### Full Actor Documentation

#### YouTube Channel Email Finder

**Find email addresses for any YouTube channel instantly.** Get the contact email for YouTube creators and channels worldwide.

***

#### Overview

The YouTube Channel Email Finder is an Apify Actor that extracts email addresses from YouTube channels. Whether you're a marketer looking to reach out to creators, a business seeking collaboration opportunities, or a researcher analyzing creator contact information, this actor helps you find email addresses quickly and efficiently.

##### What You Can Do

- **Find Email Addresses**: Discover contact emails for YouTube channels
- **Handle-Based Search**: Use YouTube handles (e.g., @channelname)
- **ID-Based Search**: Use YouTube channel IDs for direct lookup
- **Reliable Results**: Get consistent email extraction from channel data

##### Data Availability

**All data returned by this actor is publicly available information.** We extract email addresses that creators have made publicly accessible on their YouTube channels and associated platforms.

***

#### Actor Input Parameters

The actor accepts the following input parameters:

**id**
• Type: string
• Required: Optional\*
• Description: YouTube channel ID
e.g., `UC_x5XG1OV2P6uZZ5FSM9Ttw`

**channelHandle**
• Type: string
• Required: Optional\*
• Description: YouTube channel handle
e.g., `@theAIsearch`

**Important Notes:**

- **At least one parameter is required** - You must provide either `id` or `channelHandle`
- **Channel handles must start with `@`** - If using `channelHandle`, it must begin with the `@` symbol (e.g., `@mkbhd`, not `mkbhd`)
- **ID takes precedence** - If both `id` and `channelHandle` are provided, only the `id` parameter will be used

***

#### Input Examples

##### Example 1: Using Channel Handle Only

```json
{
  "channelHandle": "@theAIsearch"
}
```

##### Example 2: Using Channel ID Only

```json
{
  "id": "UC_x5XG1OV2P6uZZ5FSM9Ttw"
}
```

##### Example 3: Using Both Parameters (ID takes precedence)

```json
{
  "id": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "channelHandle": "@theAIsearch"
}
```

***

#### Output Schema

The actor returns data in the following format:

**Success Response:**

```json
{
  "status": "success",
  "email": "contact@example.com",
  "found": true
}
```

**Error Response:**

```json
{
  "status": "error",
  "error": "something went wrong with the Actor. You will not be charged"
}
```

**Output Fields:**

**status**
• Type: string
• Description: The status of the operation
• Possible values: `"success"`, `"error"`

**email** (only in success responses)
• Type: string
• Description: The email address found for the channel (empty string if no email found)

**found** (only in success responses)
• Type: boolean
• Description: Whether an email address was found
• Possible values: `true` (email found), `false` (no email found)

**error** (only in error responses)
• Type: string
• Description: Error message when the actor fails

***

#### Output Examples

##### Example 1: Email Found

```json
{
  "status": "success",
  "email": "contact@kingsandgenerals.com",
  "found": true
}
```

##### Example 2: No Email Found (Still Success)

```json
{
  "status": "success",
  "email": "",
  "found": false
}
```

##### Example 3: API Error

```json
{
  "status": "error",
  "error": "something went wrong with the Actor. You will not be charged"
}
```

***

#### Use Cases

##### Marketing & Outreach

- Build contact lists for creator outreach campaigns
- Find email addresses for influencer marketing
- Connect with YouTube creators for collaborations

##### Business Development

- Research potential business partners
- Contact channel owners for sponsorship opportunities
- Build creator networks for cross-promotion

##### Research & Analytics

- Analyze creator contact patterns
- Study channel monetization strategies
- Research creator demographics and contact preferences

***

#### Support

For support and questions:

- **Email**: contact@endspec.net
- **Apify**: Report issues through the Apify platform
- **API Support**: Contact your API provider for API-related issues

***

#### Changelog

**Version 1.0.0**

- Initial release
- Support for channel handles and IDs
- Email extraction that passes most reCAPTCHA
- Comprehensive error handling

# Actor input Schema

## `id` (type: `string`):

YouTube channel ID (e.g., UC\_x5XG1OV2P6uZZ5FSM9Ttw)

## `channelHandle` (type: `string`):

YouTube channel handle (must start with @, e.g., @theAIsearch)

## Actor input object example

```json
{
  "channelHandle": "@mrbeast"
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "id": "",
    "channelHandle": "@mrbeast"
};

// Run the Actor and wait for it to finish
const run = await client.actor("endspec/youtube-instant-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 = {
    "id": "",
    "channelHandle": "@mrbeast",
}

# Run the Actor and wait for it to finish
run = client.actor("endspec/youtube-instant-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 '{
  "id": "",
  "channelHandle": "@mrbeast"
}' |
apify call endspec/youtube-instant-email-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/a38Nz3XOFXX2lZQvT/builds/2RK5aqr6hyTpS2JLw/openapi.json