{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Email Scraper - Creator Emails & Socials", "description": "Scrape public emails of YouTube creators from handles, channel links, ids or keywords: email + source, validation, phones, Instagram/TikTok/X/website links, subscribers, views, country. Reads the description, latest videos, pinned comment and creator sites. $0.90 per 1,000 channels with an email.", "version": "0.1", "x-build-id": "en9yKGgQcc4B0z4tj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/topapi~youtube-channel-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-topapi-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/topapi~youtube-channel-email-scraper/runs": { "post": { "operationId": "runs-sync-topapi-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/topapi~youtube-channel-email-scraper/run-sync": { "post": { "operationId": "run-sync-topapi-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", "properties": { "urls": { "title": "YouTube channels", "type": "array", "description": "One per line: @handle (@mkbhd), channel link (https://www.youtube.com/@veritasium, /channel/UC…, /c/…, /user/…), channel id (UCBJycsmduvYEL83R_U4JriQ) or a video / Shorts link (its channel is read).", "items": { "type": "string" } }, "searchQueries": { "title": "Find channels by keyword", "type": "array", "description": "Topics to find creators for, e.g. \"sourdough baking\", \"budget travel\". Runs YouTube's channel search; searching is free, you pay only for delivered channels.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Channels per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Rows to deliver per keyword (channels with an email, plus channels without one if you turn that on). YouTube lists about 200-300 channels per keyword.", "default": 20 }, "startUrls": { "title": "Channel list file", "type": "array", "description": "Optional: a link to a CSV or text file of channels (one handle, link or id per line or cell), or more channel links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Search country", "enum": [ "US", "GB", "CA", "AU", "NZ", "IE", "IN", "PK", "PH", "SG", "MY", "ID", "TH", "VN", "JP", "KR", "TW", "HK", "DE", "AT", "CH", "FR", "BE", "NL", "IT", "ES", "PT", "PL", "CZ", "RO", "HU", "GR", "SE", "NO", "DK", "FI", "RU", "UA", "TR", "IL", "SA", "AE", "EG", "NG", "KE", "ZA", "MA", "BR", "MX", "AR", "CO", "CL", "PE" ], "type": "string", "description": "The YouTube country the keyword search runs in. YouTube shows different creators for the same words in different countries.", "default": "US" }, "language": { "title": "Search language", "enum": [ "en", "es", "pt", "fr", "de", "it", "nl", "pl", "cs", "ro", "hu", "el", "sv", "no", "da", "fi", "ru", "uk", "tr", "ar", "he", "hi", "bn", "ur", "id", "ms", "th", "vi", "ja", "ko", "zh", "tl" ], "type": "string", "description": "The language of the keyword search. Pair it with the country: Germany + Arabic finds the Arabic-speaking creators YouTube shows in Germany.", "default": "en" }, "includeVideoResultChannels": { "title": "Also take channels from video results", "type": "boolean", "description": "Besides YouTube's channel results, add the channels behind the videos the keyword finds. Finds more active creators when the channel list runs short.", "default": false }, "minSubscribers": { "title": "Min subscribers", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Skip channels below this size, e.g. 5000. Checked before anything is fetched when YouTube's search shows the count. 0 = no minimum." }, "maxSubscribers": { "title": "Max subscribers", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Skip channels above this size, e.g. 500000 for micro-influencers. 0 = no maximum." }, "channelCountry": { "title": "Channel country", "type": "array", "description": "Keep only channels whose About panel names one of these countries, e.g. \"United States\", \"DE\". Channels that show no country are skipped when this is set.", "items": { "type": "string" } }, "joinedDateFrom": { "title": "Joined after", "type": "string", "description": "Only channels created on or after this date: 2020-01-31, or relative like \"2 years\"." }, "joinedDateTo": { "title": "Joined before", "type": "string", "description": "Only channels created on or before this date: 2024-12-31, or relative like \"6 months\"." }, "activeWithinDays": { "title": "Uploaded within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only channels whose newest upload is at most this many days old, e.g. 30. Reads the channel's latest uploads (free)." }, "minAverageViews": { "title": "Min average views", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Only channels whose latest ~30 uploads average at least this many views." }, "minVideos": { "title": "Min videos", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only channels with at least this many public videos." }, "excludeKeywords": { "title": "Exclude words", "type": "array", "description": "Skip channels whose name, handle or description contains any of these words, e.g. \"news\", \"official\".", "items": { "type": "string" } }, "filtersApplyToUrls": { "title": "Apply filters to listed channels too", "type": "boolean", "description": "Off: the channels you list are always read. On: they must pass the filters above as well.", "default": false }, "scanVideoDescriptions": { "title": "Latest video descriptions", "minimum": 0, "maximum": 15, "type": "integer", "description": "How many of the newest video descriptions to read for an email. 0 = off.", "default": 3 }, "scanPinnedComment": { "title": "Pinned comment", "type": "boolean", "description": "Read the pinned comment of the newest video.", "default": true }, "scanLinkedWebsites": { "title": "Linked websites", "type": "boolean", "description": "Open the creator's own websites from the About panel (home page, then contact / business / about pages) and their link-in-bio page. Sponsor and affiliate links are skipped.", "default": true }, "maxWebsitePages": { "title": "Pages per website", "minimum": 1, "maximum": 8, "type": "integer", "description": "Most pages read on each website, home page included.", "default": 3 }, "maxWebsitesPerChannel": { "title": "Websites per channel", "minimum": 1, "maximum": 5, "type": "integer", "description": "Most of the channel's own websites to open.", "default": 2 }, "scanEvenIfEmailFound": { "title": "Check every place", "type": "boolean", "description": "Read the videos, pinned comment and websites even when the description already has an email, so the emails list is complete. Slower.", "default": false }, "validateEmails": { "title": "Validate emails", "type": "boolean", "description": "Check each email's domain for a working mail server and flag disposable and no-reply addresses: valid, risky, invalid, disposable. Included in the price.", "default": true }, "includeChannelsWithoutEmail": { "title": "Also return channels without an email", "type": "boolean", "description": "Off: you get, and pay for, only channels with an email. On: channels without one are returned too ($0.45 per 1,000) with stats, links, socials and the hidden-email flag.", "default": false }, "includeRecentActivity": { "title": "Recent activity", "type": "boolean", "description": "Add the newest upload's age and date, uploads in the last 30 days, and the average and median views of the latest ~30 uploads. Free.", "default": false }, "monitorMode": { "title": "Only new channels", "type": "boolean", "description": "Skip channels an earlier run with the same memory name already checked. A repeat run over the same keywords costs nothing until new creators appear.", "default": false }, "monitorStoreName": { "title": "Memory name", "type": "string", "description": "Name of the key-value store that remembers checked channels. Use one name per list you build.", "default": "youtube-channel-email-monitor" }, "monitorRecheckEmails": { "title": "Re-check known channels", "type": "boolean", "description": "In monitor mode, also re-read channels seen before and deliver them again when their emails changed (or a channel without one now publishes one).", "default": false }, "maxResults": { "title": "Max channels in total", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Most rows the whole run delivers, across all channels and keywords. 0 = no limit.", "default": 0 }, "maxChannelsCheckedPerQuery": { "title": "Max channels checked per keyword", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop a keyword after checking this many channels even if it has not reached its row count (most channels publish no email). Default: 10 x the rows asked, at least 200." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The actor reads YouTube directly and moves to Apify datacenter, then residential proxies by itself if YouTube refuses a route." }, "maxConcurrency": { "title": "Channels in parallel", "minimum": 1, "maximum": 25, "type": "integer", "description": "Channels processed at once.", "default": 12 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }