{ "openapi": "3.0.1", "info": { "title": "Youtube Lead Scraper", "description": "Extract high-quality leads directly from YouTube using the YouTube Lead Scraper. Collect channel names, emails, social links, subscriber counts, and video data. Ideal for outreach, influencer discovery, and market research. Export structured lead lists ready for CRM or marketing tools.", "version": "0.1", "x-build-id": "mNgAhsC94RTy6zDGF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~youtube-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-youtube-lead-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/scraper-engine~youtube-lead-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-youtube-lead-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/scraper-engine~youtube-lead-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-youtube-lead-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "๐Ÿ” Keywords", "type": "array", "description": "๐ŸŽฏ The words that power your lead search! Add one or more keywords (e.g. ['cooking channel', 'tech reviewer', 'fitness influencer']) and the actor finds public YouTube channels/videos matching them, then ๐Ÿ“ง extracts any email addresses it finds โ€” often from a channel's \"About\" tab. ๐Ÿ’ก Tip: niche creator keywords tend to outperform broad generic terms.", "items": { "type": "string" } }, "platform": { "title": "๐ŸŒ Platform", "enum": [ "Youtube" ], "type": "string", "description": "๐Ÿ“ฑ The social network to mine for leads. Currently locked to YouTube โ€” more platforms coming soon! ๐Ÿš€", "default": "Youtube" }, "location": { "title": "๐Ÿ“ Location Filter", "type": "string", "description": "๐Ÿ—บ๏ธ Optional geo-targeting! Add a city or region (e.g. 'London' ๐Ÿ‡ฌ๐Ÿ‡ง, 'New York' ๐Ÿ—ฝ, 'Dubai' ๐Ÿ™๏ธ) to narrow leads down to channels/videos mentioning that place. โœจ Leave empty to search the whole globe ๐ŸŒ.", "default": "" }, "emailDomains": { "title": "๐Ÿ“ง Email Domains Filter", "type": "array", "description": "๐ŸŽ›๏ธ Keep only leads whose email is on the domains you care about โ€” type as many as you like! โœ๏ธ Popular picks: ๐Ÿ“ฎ @gmail.com ยท ๐Ÿ“จ @outlook.com ยท ๐Ÿ’Œ @hotmail.com ยท ๐Ÿ’œ @yahoo.com ยท โ˜๏ธ @icloud.com ยท ๐Ÿ“ฌ @aol.com ยท ๐Ÿ”’ @protonmail.com ยท ๐Ÿ“ฅ @live.com ยท ๐Ÿ“ง @gmx.com ยท ๐ŸŸก @yandex.com ยท ๐Ÿ“— @zoho.com. ๐Ÿข Custom/business domains work too โ€” e.g. @yourcompany.com. ๐Ÿ•ณ๏ธ Leave empty to collect leads from ALL domains. ๐Ÿ’ก Adding a domain also sharpens the search ๐ŸŽฏ.", "items": { "type": "string" } }, "maxEmails": { "title": "๐Ÿ“Š Maximum Leads per Keyword", "minimum": 1, "maximum": 5000, "type": "integer", "description": "๐ŸŽš๏ธ How many leads (emails) to collect per keyword before moving on. โšก Higher = more leads but longer runs. Default is 20 โœ… (range 1 โ€“ 5,000).", "default": 20 }, "engine": { "title": "โš™๏ธ Engine", "enum": [ "legacy" ], "type": "string", "description": "๐Ÿ”ง The processing engine. Currently 'legacy' ๐Ÿ›ก๏ธ โ€” a reliable, battle-tested extraction pipeline. More engines on the roadmap! ๐Ÿšง", "default": "legacy" }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy Configuration", "type": "object", "description": "๐ŸŒ Control how the actor connects to Google. ๐Ÿ†“ Leave it empty and the actor auto-selects the GOOGLE_SERP proxy group for reliable, low-block-rate querying. ๐Ÿ”„ On any failed or blocked response it automatically rotates to a fresh proxy URL and retries up to 3ร—. ๐Ÿง  Advanced users can plug in their own proxy groups or external URLs here instead." } } }, "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 } } } } } } } } } }