{
"openapi": "3.0.1",
"info": {
"title": "YouTube Channel Email Scraper 📧 (creator contacts & links)",
"description": "Find YouTube creators in your niche and get their business email, Instagram, TikTok, website and links, with subscribers, views, country and join date. Filter by audience size and country. No API key, no login.",
"version": "0.1",
"x-build-id": "hkahrkpraqfteQX8Z"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~youtube-channel-email-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-youtube-channel-email-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/tagadanar~youtube-channel-email-scraper/runs": {
"post": {
"operationId": "runs-sync-tagadanar-youtube-channel-email-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/tagadanar~youtube-channel-email-scraper/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-youtube-channel-email-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",
"properties": {
"keywords": {
"title": "Niche keywords",
"type": "array",
"description": "What your creators talk about, one per line, e.g. home espresso, fitness coach, indie game dev. Each keyword runs YouTube's own channel search and goes deep (up to ~500 channels per keyword). Several keywords are searched in turn and duplicates are removed.",
"items": {
"type": "string"
}
},
"channels": {
"title": "Channels to enrich (optional)",
"type": "array",
"description": "Already have a list? Paste channel URLs (https://www.youtube.com/@LanceHedrick, /channel/UC…, /c/…, /user/…), @handles or UC… channel IDs, one per line. They are enriched first, then the keywords are searched.",
"items": {
"type": "string"
}
},
"maxChannels": {
"title": "Max channels",
"minimum": 1,
"maximum": 2000,
"type": "integer",
"description": "Stop after this many channels are delivered (after your filters). You are only charged for channels delivered.",
"default": 50
},
"minSubscribers": {
"title": "Min subscribers",
"minimum": 0,
"type": "integer",
"description": "Skip channels below this audience size. Leave empty for no minimum."
},
"maxSubscribers": {
"title": "Max subscribers",
"minimum": 0,
"type": "integer",
"description": "Skip channels above this audience size — handy for micro-influencer campaigns. Leave empty for no maximum."
},
"country": {
"title": "Country",
"type": "string",
"description": "Only channels whose About page shows this country. Two-letter code or English name (US, United Kingdom, IN); several separated by commas. Channels that show no country are skipped when this is set. Leave empty for any country."
},
"onlyWithEmail": {
"title": "Only channels with an email",
"type": "boolean",
"description": "Deliver (and charge) only channels where a business email was found. Channels without one are skipped and never charged.",
"default": false
},
"minEmailConfidence": {
"title": "Minimum email confidence",
"enum": [
"high",
"medium",
"low"
],
"type": "string",
"description": "Every email is graded high (written in the channel description, a mailto on the creator's link-in-bio page, at the domain of the creator's own website, or containing the channel's name), medium (a free-mail address on the creator's site, plausible but unconfirmed) or low (probably someone else's: the web designer's or another company's domain, a gambling/spam-looking domain, or a free-mail address on a site not named after the channel). Addresses below this level are never used as the primary email and never charged; they are still listed in lowConfidenceEmails with the reason in emailDetails. Only channels with an email counts emails at or above this level.",
"default": "medium"
},
"checkLinkedWebsites": {
"title": "Also look on their website and link-in-bio page",
"type": "boolean",
"description": "When the channel description has no email, open the creator's own website (homepage, then its contact page) or their link-in-bio page (Linktree, Beacons, Stan…) and pick up the email published there. Finds more emails; makes the run slower.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}