{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Email & Metadata Scraper API", "description": "Extract public email addresses and rich metadata from YouTube channels, including channel details, subscriber counts, descriptions, links, and other available contact information. Built for lead generation, creator outreach, CRM enrichment, and API automation.", "version": "0.1", "x-build-id": "SPB74rqFdDzoLL2k7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lance_api~youtube-channel-email-metadata-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lance_api-youtube-channel-email-metadata-scraper-api", "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/lance_api~youtube-channel-email-metadata-scraper-api/runs": { "post": { "operationId": "runs-sync-lance_api-youtube-channel-email-metadata-scraper-api", "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/lance_api~youtube-channel-email-metadata-scraper-api/run-sync": { "post": { "operationId": "run-sync-lance_api-youtube-channel-email-metadata-scraper-api", "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, handles, IDs, or videos", "maxItems": 200, "type": "array", "description": "YouTube channel URLs, @handles, channel IDs, custom channel URLs, user URLs, or video URLs. Each non-empty direct input is processed independently.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "maxItems": 20, "type": "array", "description": "Keywords used to discover YouTube channels. Each submitted keyword has a $0.05 discovery fee. Returned channels do not incur a separate per-result charge; an additional fee applies only when a returned channel contains a public email.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum channels per search query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of channels each keyword may return after enrichment and joined-date filtering. This is an upper bound, not a minimum target: if a search provider succeeds with fewer channels, the Actor accepts those results and does not call another provider just to fill the remaining quantity.", "default": 20 }, "country": { "title": "Country (keyword search only)", "enum": [ "", "US", "GB", "CA", "AU", "DE", "FR", "ES", "IT", "NL", "BE", "CH", "AT", "SE", "NO", "DK", "FI", "IE", "PT", "PL", "CZ", "RO", "HU", "GR", "TR", "RU", "UA", "IL", "IN", "JP", "KR", "CN", "TW", "TH", "ID", "MY", "PH", "VN", "SG", "BR", "MX", "AR", "CO", "CL", "ZA", "NG", "KE", "EG", "SA", "AE", "NZ" ], "type": "string", "description": "Localize keyword search results. Ignored for direct URL input. This affects search relevance only and does not remove returned channels by country.", "default": "" }, "language": { "title": "Language (keyword search only)", "enum": [ "", "en-US", "es-ES", "fr-FR", "de-DE", "it-IT", "pt-PT", "nl-NL", "ru-RU", "ja-JP", "ko-KR", "zh-CN", "ar", "hi-IN", "bn", "tr-TR", "pl-PL", "uk-UA", "ro-RO", "cs-CZ", "hu-HU", "sv-SE", "no-NO", "da-DK", "fi-FI", "el-GR", "he-IL", "th-TH", "vi-VN", "id-ID", "ms-MY", "fil-PH", "sw", "fa", "ur" ], "type": "string", "description": "Localize keyword search results. Ignored for direct URL input.", "default": "" }, "joinedDateFrom": { "title": "Joined after", "type": "string", "description": "Skip channels created before this date. Leave empty to include all. Use YYYY-MM-DD." }, "joinedDateTo": { "title": "Joined before", "type": "string", "description": "Skip channels created after this date. Leave empty to include all. Use YYYY-MM-DD." } } }, "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 } } } } } } } } } }