{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Email Scraper - Emails, Socials & Leads API", "description": "Find verified business emails, phone numbers, social profiles (Instagram, TikTok, X, LinkedIn), Linktree links & websites for YouTube channels by URL, @handle or niche keyword. No login needed; works with Apify MCP, Clay, n8n & Make.", "version": "1.0", "x-build-id": "SWUYhwWVBtcRDepca" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/church_of_loujess~youtube-channel-email-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-church_of_loujess-youtube-channel-email-leads-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/church_of_loujess~youtube-channel-email-leads-scraper/runs": { "post": { "operationId": "runs-sync-church_of_loujess-youtube-channel-email-leads-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/church_of_loujess~youtube-channel-email-leads-scraper/run-sync": { "post": { "operationId": "run-sync-church_of_loujess-youtube-channel-email-leads-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": { "channelUrls": { "title": "YouTube Channel URLs, @Handles, or Video URLs", "type": "array", "description": "Use this field when providing specific YouTube channel URLs, @handles (e.g. '@fireship', 'https://www.youtube.com/@mkbhd'), channel IDs ('UC...'), or video URLs. Can be combined with searchQueries.", "default": [ "https://www.youtube.com/@Fireship" ], "items": { "type": "string" } }, "searchQueries": { "title": "Search by Niche or Keyword (Auto-Discover Channels)", "type": "array", "description": "Use this field when searching for YouTube creators, influencers, or B2B channels by niche or topic (e.g. 'AI automation agency', 'SaaS marketing', 'crypto podcast'). Automatically discovers matching channels and extracts their emails and socials.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Single Search Keyword (Drop-in Alias)", "type": "string", "description": "Optional single search keyword (drop-in compatibility for legacy YouTube email scrapers)." }, "channelHandle": { "title": "Single Channel Handle or URL (Drop-in Alias)", "type": "string", "description": "Optional single YouTube @handle or URL (drop-in compatibility for legacy YouTube email scrapers)." }, "id": { "title": "Single YouTube Channel ID (Drop-in Alias)", "type": "string", "description": "Optional single YouTube Channel ID starting with UC (drop-in compatibility for legacy YouTube email scrapers)." }, "maxResults": { "title": "Max Channels per Search Query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of unique YouTube channels to discover and enrich per search query.", "default": 10 }, "scanRecentVideos": { "title": "Scan Recent Video Descriptions for Sponsor/Inquiry Emails", "minimum": 0, "maximum": 15, "type": "integer", "description": "Number of recent videos per channel to inspect for business inquiry emails, sponsor links, and Linktree URLs that creators place in video descriptions.", "default": 4 }, "crawlExternalLinks": { "title": "Crawl Linked Websites & Linktree/Beacons Pages for Emails", "type": "boolean", "description": "When enabled, automatically follows external websites, Linktree, Beacons, Solo.to, and /contact or /about pages linked from the channel or video descriptions to extract verified emails and social handles.", "default": true }, "onlyWithEmails": { "title": "Only Return Channels with Verified Emails", "type": "boolean", "description": "If enabled, filters out channels that do not have at least one discovered email address.", "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 } } } } } } } } } }