使用 Apify 进行 YouTube 邮箱抓取

从 YouTube 频道中提取邮箱地址及联系信息。支持按关键词搜索，或直接提供频道 URL。适用于网红合作对接、赞助洽谈与潜在客户开发。

Actor：futurizerush/youtube-email-scraper

前提条件

在环境变量中设置 APIFY_API_TOKEN。可在 console.apify.com/account/integrations 获取 Token。

执行流程

Apify 的运行是异步的。每次请求均需经历以下三个步骤：

1. 启动运行 —— 向 Actor API 发送 POST 请求，获取运行 ID（run ID）和数据集 ID（dataset ID）
2. 轮询直至完成 —— 使用 GET 请求查询运行状态，等待状态变为 SUCCEEDED
3. 获取结果 —— 使用 GET 请求拉取数据集条目（返回 JSON 数组）

典型运行耗时：30–120 秒，具体取决于频道数量。

输入参数

模式差异

• directUrls —— 精确抓取指定频道，需提供 channelUrls 参数。
• keywordSearch —— 先通过关键词查找频道，再从中提取联系方式，需提供 searchKeywords 参数。

完整示例（Python）

import requests, os, time

TOKEN = os.environ["APIFY_API_TOKEN"]
BASE = "https://api.apify.com/v2"

# 第一步：启动运行
response = requests.post(
    f"{BASE}/acts/futurizerush~youtube-email-scraper/runs?token={TOKEN}",
    json={
        "inputMode": "keywordSearch",
        "searchKeywords": ["AI automation"],
        "maxChannelsPerKeyword": 10,
        "maxResults": 10,
        "locale": "US",
    },
)
response.raise_for_status()
run = response.json()["data"]
run_id = run["id"]
dataset_id = run["defaultDatasetId"]

# 第二步：轮询直至完成
while True:
    status = requests.get(
        f"{BASE}/actor-runs/{run_id}?token={TOKEN}"
    ).json()["data"]["status"]
    if status == "SUCCEEDED":
        break
    if status in ("FAILED", "ABORTED", "TIMED-OUT"):
        raise RuntimeError(f"Run failed: {status}")
    time.sleep(5)

# 第三步：获取结果（JSON 数组）
items = requests.get(
    f"{BASE}/datasets/{dataset_id}/items?token={TOKEN}"
).json()

# 筛选含邮箱的频道
for channel in items:
    if channel["hasEmails"]:
        print(f"{channel['channelName']} ({channel['subscriberCount']} subs)")
        print(f"  Emails: {', '.join(channel['emails'])}")
        print(f"  URL: {channel['channelUrl']}")

直接传入频道 URL

requests.post(
    f"{BASE}/acts/futurizerush~youtube-email-scraper/runs?token={TOKEN}",
    json={
        "inputMode": "directUrls",
        "channelUrls": [
            "https://www.youtube.com/@mkbhd",
            "https://www.youtube.com/@nateherk",
        ],
    },
)

完整示例（bash）

# 第一步：启动运行
RUN_RESPONSE=$(curl -s -X POST 
  "https://api.apify.com/v2/acts/futurizerush~youtube-email-scraper/runs?token=$APIFY_API_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{"inputMode": "keywordSearch", "searchKeywords": ["AI automation"], "maxChannelsPerKeyword": 10, "maxResults": 10}')

RUN_ID=$(echo "$RUN_RESPONSE" | jq -r '.data.id')
DATASET_ID=$(echo "$RUN_RESPONSE" | jq -r '.data.defaultDatasetId')

# 第二步：轮询直至完成
while true; do
  STATUS=$(curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?token=$APIFY_API_TOKEN" 
    | jq -r '.data.status')
  [ "$STATUS" = "SUCCEEDED" ] && break
  [ "$STATUS" = "FAILED" ] || [ "$STATUS" = "ABORTED" ] && echo "Failed: $STATUS" && exit 1
  sleep 5
done

# 第三步：获取结果
curl -s "https://api.apify.com/v2/datasets/$DATASET_ID/items?token=$APIFY_API_TOKEN" | jq '.'

输出格式

结果数组中的每一项（字段名已基于 2026-04-11 实际 API 返回验证）：

{
  "channelName": "Nate Herk | AI Automation",
  "subscriberCount": "645.0K",
  "channelUrl": "https://www.youtube.com/@nateherk",
  "channelDescription": "Hi, I'm Nate Herk. I'm passionate about...",
  "joinDate": "Nov 17, 2013",
  "viewCount": 405328,
  "videoCount": 383,
  "location": null,
  "contactInfo": {
    "emails": ["sponsorships@nateherk.com"],
    "websites": ["https://nateherk.com/"],
    "socialMedia": {}
  },
  "emails": ["sponsorships@nateherk.com"],
  "websites": ["https://nateherk.com/"],
  "socialMedia": {},
  "emailCount": 1,
  "hasEmails": true,
  "descriptionUrls": [],
  "extractedAt": "2026-04-11T06:07:13.204Z",
  "processingSuccess": true,
  "searchKeyword": "AI automation"
}

注意： 字段名采用 camelCase 命名法。emails 数组为便于使用的扁平化字段；相同数据亦存在于 contactInfo.emails 中。建议使用 hasEmails 字段快速筛选出公开邮箱的频道。

错误处理

使用提示

• 使用 hasEmails: true 快速筛选出公开邮箱的频道。
• subscriberCount 为字符串类型（例如 "645.0K"），而非数值类型。
• contactInfo 包含结构化联系信息；根层级的 emails 和 websites 是为方便访问而提供的扁平化数组。
• 进行网红合作对接时，建议按细分领域关键词搜索，以定位具备邮箱信息的相关频道。
• 输出中的 searchKeyword 字段标明了命中该频道所使用的搜索词（多关键词场景下尤为有用）。
• 无需登录 YouTube 或提供 YouTube API Key。

相关链接

• Actor 页面
• Apify API 文档