{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Business Email Finder", "description": "Turn a list of YouTube channels - or a single topic keyword - into business email addresses. Every row shows where the address came from, with verified addresses kept separate from pattern guesses. Channels with no address still return a row, and you are never billed for those.", "version": "0.1", "x-build-id": "ztCzcNDgraoChuDjh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/garnet_puppet~youtube-channel-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-garnet_puppet-youtube-channel-email-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/garnet_puppet~youtube-channel-email-finder/runs": { "post": { "operationId": "runs-sync-garnet_puppet-youtube-channel-email-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/garnet_puppet~youtube-channel-email-finder/run-sync": { "post": { "operationId": "run-sync-garnet_puppet-youtube-channel-email-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": { "urls": { "title": "Channels", "type": "array", "description": "Channel URLs, @handles, or channel IDs. Video and playlist URLs resolve to their channel.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "Find channels by keyword instead of pasting a list. See \"Max channels per keyword\" below for how many each keyword contributes.", "items": { "type": "string" } }, "maxChannelsPerSearch": { "title": "Max channels per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on how many channels each keyword contributes. Default 50." }, "includeLinkedSite": { "title": "Check the channel's website", "type": "boolean", "description": "Visit the website linked on the channel and look for a contact address. We read robots.txt first and skip any site that disallows it." }, "includeVideoDescriptions": { "title": "Check recent video descriptions", "type": "boolean", "description": "Read the descriptions of the channel's 15 most recent videos. One request per channel." }, "allowGuessed": { "title": "Include pattern guesses", "type": "boolean", "description": "When a channel has its own website but no address is published, try contact@ and keep it only if the domain accepts mail (MX record). These are labelled 'guessed' and billed at the lower rate." }, "deepScan": { "title": "Deep scan (community posts)", "type": "boolean", "description": "Last resort for channels where nothing else was found. Reads community posts. Slower, and it resolves roughly 1 in 39 otherwise-empty channels." }, "incremental": { "title": "Skip channels already resolved", "type": "boolean", "description": "Remembers channels whose email was already found and skips them on later runs, so you are never billed twice for the same channel. Channels with no email found are always retried." }, "previewOnly": { "title": "Free preview", "type": "boolean", "description": "Resolve the channel list and report how many would be billed, without charging anything and without scraping emails." } } }, "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 } } } } } } } } } }