{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Finder With Contact Info Extraction", "description": "YouTube Channel Finder: Discover channels by keyword and extract publicly available contact info, channel names, descriptions, emails, websites, subscriber counts, video metrics, and URLs. Build enriched creator and business lead lists for prospecting, influencer research, and market analysis.", "version": "0.2", "x-build-id": "Bw78a8nxefd1ZJJ4A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~youtube-channel-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-youtube-channel-finder", "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/api-empire~youtube-channel-finder/runs": { "post": { "operationId": "runs-sync-api-empire-youtube-channel-finder", "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/api-empire~youtube-channel-finder/run-sync": { "post": { "operationId": "run-sync-api-empire-youtube-channel-finder", "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": { "keywords": { "title": "🔎 Search keywords", "type": "array", "description": "Search terms to discover YouTube channels (e.g. \"cooking tutorials\", \"tech reviews\"). One keyword per line. Combine with \"Channels per keyword\" below.", "items": { "type": "string" } }, "urls": { "title": "🔗 Direct channel/video URLs", "type": "array", "description": "Skip search and extract contact data directly from these YouTube channel or video URLs.", "items": { "type": "string" } }, "channelCount": { "title": "📊 Channels per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of channels to extract per search keyword. Example: channelCount=20 with 3 keywords -> up to 60 channels total. Default 10, supported range 1-200. Channels are enriched concurrently, so a run of 100+ channels still finishes in a couple of minutes.", "default": 10 }, "searchRegion": { "title": "🌍 Search region", "enum": [ "US", "GB", "CA", "AU", "IN", "DE", "FR", "JP", "BR", "MX", "ES", "IT", "NL", "PL", "RU", "KR", "TW" ], "type": "string", "description": "YouTube search region (country code). Affects which channels appear in search results.", "default": "US" }, "language": { "title": "🗣️ Language", "enum": [ "en", "es", "de", "fr", "pt", "ja", "hi", "zh", "ko", "ar", "ru" ], "type": "string", "description": "Interface and result language code (e.g. en for English).", "default": "en" }, "fromDate": { "title": "📅 Joined after", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only include channels that joined YouTube on or after this date (YYYY-MM-DD). Leave empty for no filter." }, "toDate": { "title": "📅 Joined before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only include channels that joined YouTube on or before this date (YYYY-MM-DD). Leave empty for no filter." }, "requireContactSignal": { "title": "✅ Require a contact signal", "type": "boolean", "description": "When ON, only channels with at least one extracted email (contactEmails) OR at least one categorized social/website link (socialLinks) are saved to the dataset -- everything else is skipped. Default OFF (save every channel found).", "default": false }, "scanVideoDescriptions": { "title": "🎬 Scan latest video descriptions for emails", "type": "boolean", "description": "When ON (default), the actor also reads the descriptions of the channel's 15 most recent videos via YouTube's public RSS feed. Most creators publish their 'for business inquiries' address there rather than in the channel description, so this roughly doubles email coverage at the cost of one small extra request per channel. An address is only kept if it repeats across videos or sits next to a business/contact cue.", "default": true }, "scanLinkedWebsite": { "title": "🌐 Scan the channel's linked website for emails", "type": "boolean", "description": "When ON (default), the actor opens the channel's own linked website (homepage plus up to two contact/about pages) and collects the email addresses published there. Only addresses in a mailto: link, on the site's own domain, or at a well-known mailbox provider are accepted, so third-party and demo addresses are not picked up.", "default": true }, "maxConcurrency": { "title": "⚡ Max concurrent channels", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many channels are fetched in parallel. Higher is faster but more likely to be rate-limited by YouTube. Range 1-20, default 8.", "default": 8 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional. By default the actor runs without a proxy. Enable Apify Proxy here for higher volume or to reduce blocks. If the chosen proxy gets blocked, the actor automatically falls back to Residential proxy and continues." } } }, "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 } } } } } } } } } }