YouTube Email Scraper

Find email addresses that are literally present in public YouTube channel descriptions or public channel-link metadata. The actor does not reveal hidden contact addresses, click contact-reveal controls, call private endpoints, or bypass access controls.

Input

Field	Default	Description
channelUrls	—	Public channel URLs, @handles, /channel/UC… IDs, /user/… URLs.
searchQuery	—	Optional public YouTube channel search query. It can be combined with channelUrls.
emailDomain	—	Optional exact domain filter, for example gmail.com.
maxItems	20	Maximum channels to scan, from 1 to 100.
includeDiagnostics	true	Emit exact four-field diagnostics for blocked pages or channels with no public email.
enableProxyFallback	true	Try standard account-authorized Apify Proxy after direct access fails.
maxRetries	2	Bounded retries per route, from 0 to 3.
requestDelayMs	250	Delay between channel pages.
requestTimeoutSecs	60	Public-page timeout.
proxyConfiguration	—	Standard Apify Proxy or credential-free HTTP/SOCKS configuration.

Output

When a public email is found, the dataset includes the primary and complete matching email list, email source, channel ID/name/handle/canonical URL, description and length, displayed and parsed subscriber/video counts, public country/joined date, avatar, public external links, input/search provenance, explicit metadata source and extraction method, and timestamp.

When no address is exposed, the actor emits a NO_PUBLIC_EMAIL_FOUND diagnostic (if diagnostics are enabled) and still completes successfully when the public page itself was read. This distinction prevents an unavailable public contact from being mistaken for a scraper failure.

Diagnostics contain exactly url, error, errorCode, and scrapedAt. OUTPUT summarizes discovery, scanning, findings, failures, blocks, proxy state, and duration.

Verification

npm test
npx apify validate-schema .actor/input_schema.json
npx apify run --purge --input-file qa-inputs/youtube-email-scraper/local-validation.json
npm run validate-dataset
npx apify actors call <ACTOR_ID> --build latest --input-file qa-inputs/youtube-email-scraper/cloud-validation.json --timeout 300 --json