{ "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": "26YT0BcDuPC8c0U4r" }, "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 valid or invalid direct input that is written to the dataset counts as one result.", "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 follow the standard result pricing.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum channels per search query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap how many final channels each keyword can return after details are fetched and joined-date filters are applied.", "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 } } }, "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 } } } } } } } } } }