{ "openapi": "3.0.1", "info": { "title": "YouTube Email Finder: Creator Business Emails, No Login", "description": "Find YouTube creators' business emails by keyword or channel list, each with its source: About text, video descriptions, link in bio pages, Instagram or TikTok bio, or the creator's website. Plus subscribers, views, country, niche keywords and social links. Pay only for channels with an email.", "version": "0.1", "x-build-id": "IirtQ46bjtjLSgFNR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~youtube-creator-email-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-youtube-creator-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/themineworks~youtube-creator-email-finder/runs": { "post": { "operationId": "runs-sync-themineworks-youtube-creator-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/themineworks~youtube-creator-email-finder/run-sync": { "post": { "operationId": "run-sync-themineworks-youtube-creator-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": { "searchQueries": { "title": "Keywords (find creators)", "type": "array", "description": "Topics to find creators for, one per line, as you would type them in YouTube search. Example: home workout, personal finance, vegan recipes. Each keyword is one YouTube channel search. Up to 50 keywords per run.", "items": { "type": "string" } }, "channels": { "title": "Channels (optional)", "type": "array", "description": "YouTube channels you already know, one per line: @handles (@MelinnaMills), channel links (https://www.youtube.com/@MelinnaMills or /channel/UC...), channel IDs starting with UC, or a video link (the channel that uploaded it is used). Up to 5,000 per run.", "items": { "type": "string" } }, "maxChannelsPerSearch": { "title": "Max channels per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "The most channels to check for each keyword, 1 to 500. YouTube returns 20 channels per results page. Channels that fail your subscriber filter do not count. Example: 100.", "default": 20 }, "minSubscribers": { "title": "Min subscribers (keyword search)", "minimum": 0, "type": "integer", "description": "Skip channels from your keyword searches with fewer subscribers than this, before anything is checked. Example: 10000 for creators with at least 10K subscribers. Leave empty for no minimum. Pasted channels are always checked." }, "maxSubscribers": { "title": "Max subscribers (keyword search)", "minimum": 0, "type": "integer", "description": "Skip channels from your keyword searches with more subscribers than this. Example: 500000 to focus on micro and mid sized creators. Leave empty for no maximum." }, "searchCountry": { "title": "Search country", "type": "string", "description": "Two letter country code YouTube search runs from, for example US, GB, IN, DE or BR. It changes which channels the keyword search ranks first. Default US.", "default": "US" }, "scanVideoDescriptions": { "title": "Read recent video descriptions", "type": "boolean", "description": "Read the descriptions of the channel's 15 newest uploads for an email (many creators put \"business inquiries: ...\" under every video and not on the About tab). On by default.", "default": true }, "scanSocialBios": { "title": "Read linked Instagram and TikTok bios", "type": "boolean", "description": "When the channel links an Instagram or TikTok profile, read that profile's public bio for an email. On by default.", "default": true }, "scanWebsites": { "title": "Read link in bio pages and the creator's website", "type": "boolean", "description": "Open the channel's Linktree, Beacons, Stan and similar link pages and the creator's own website (home page plus up to 2 contact or about pages) for an email. On by default.", "default": true }, "scanAllSources": { "title": "Check every source for every channel", "type": "boolean", "description": "Off (default): the bios, link pages and website are read only when the channel's About text and video descriptions show no email, which is faster. On: every source is read for every channel, to collect every address a creator publishes. Same price per channel either way.", "default": false }, "includeChannelsWithoutEmail": { "title": "Also list channels with no email", "type": "boolean", "description": "On: every checked channel gets a row, the ones without an email too (free, with stats, links and whether YouTube holds a hidden business email). Off: only channels with an email are listed.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is used by default and is included. Change it only if you know you need to.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }