{ "openapi": "3.0.1", "info": { "title": "Youtube Creator Leads Finder", "description": "YouTube Creator Leads Finder discovers YouTube creators by keyword/niche, filters channels by region and subscriber size, then extracts public contact signals from About pages—emails, websites, and social links—to build outreach-ready lead lists.", "version": "2.0", "x-build-id": "muVqbu2Zj77OEoGkt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/coregent~youtube-creator-leads-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-coregent-youtube-creator-leads-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/coregent~youtube-creator-leads-finder/runs": { "post": { "operationId": "runs-sync-coregent-youtube-creator-leads-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/coregent~youtube-creator-leads-finder/run-sync": { "post": { "operationId": "run-sync-coregent-youtube-creator-leads-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": "Search Keywords", "maxItems": 20, "type": "array", "description": "Keywords or niches to DISCOVER creators you don't know yet. Examples: 'AI tools', 'Shopify dropshipping', 'Fitness workouts'.\n\nMaximum 20 keywords per run. Supply this, Channel Inputs, or both.", "items": { "type": "string" }, "default": [] }, "maxChannels": { "title": "Max Channels per Keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of channels to analyze for each search keyword. Higher values discover more creators but take longer.\n\nDoes not apply to Channel Inputs — those are all processed.", "default": 10 }, "channelInputs": { "title": "Channel Inputs (enrich an existing list)", "maxItems": 500, "type": "array", "description": "Channels you ALREADY have, to enrich with contacts and metrics — no search needed.\n\nFour formats are accepted, and you can mix them freely:\n\n• Handle — @mkbhd\n• Channel URL — https://www.youtube.com/@veritasium\n• Channel ID — UCBJycsmduvYEL83R_U4JriQ\n• Video URL — https://www.youtube.com/watch?v=... (resolved to the uploader's channel)\n\nMaximum 500 per run. Unrecognised entries are reported in the log and skipped.", "items": { "type": "string" }, "default": [] }, "maxTotalChannels": { "title": "Max Channels Total (all sources)", "minimum": 0, "type": "integer", "description": "Hard ceiling on the number of creator leads saved across the entire run, counting both keyword discovery and Channel Inputs. This is your spend cap — without it, a run costs up to (keywords x Max Channels per Keyword) plus every channel input.\n\nSet to 0 for no overall limit.", "default": 100 }, "regionCode": { "title": "Search Region (ranking only)", "enum": [ "US", "GB", "CA", "AU", "IE", "NZ", "IN", "PK", "BD", "PH", "SG", "MY", "ID", "TH", "VN", "JP", "KR", "TW", "HK", "CN", "DE", "AT", "CH", "FR", "BE", "NL", "IT", "ES", "PT", "PL", "CZ", "RO", "HU", "GR", "SE", "NO", "DK", "FI", "RU", "UA", "TR", "IL", "SA", "AE", "EG", "NG", "GH", "KE", "ZA", "MA", "BR", "MX", "AR", "CO", "CL", "PE" ], "type": "string", "description": "Which country's YouTube results to search. This localizes and RANKS the search results for that market.\n\n⚠️ It does NOT guarantee the creators returned are based in that country — a US search regularly returns channels from elsewhere. To filter by where the creator actually is, use 'Creator Country' below.", "default": "US" }, "searchLanguage": { "title": "Search Language", "enum": [ "en", "es", "pt", "fr", "de", "it", "nl", "pl", "cs", "ro", "hu", "el", "sv", "no", "da", "fi", "ru", "uk", "tr", "ar", "he", "hi", "bn", "ur", "id", "ms", "th", "vi", "ja", "ko", "zh" ], "type": "string", "description": "Language for YouTube's search interface and results.\n\nPair this with Search Region when targeting non-English markets — region alone still returns an English-language result set.", "default": "en" }, "minSubscribers": { "title": "Minimum Subscribers", "minimum": 0, "type": "integer", "description": "Only include channels with at least this many subscribers. Set to 0 to include all channels.", "default": 0 }, "maxSubscribers": { "title": "Maximum Subscribers", "minimum": 0, "type": "integer", "description": "Only include channels with at most this many subscribers. Set to 0 for no upper limit.", "default": 0 }, "channelCountry": { "title": "Creator Country (real filter)", "type": "array", "description": "Keep only creators whose channel declares one of these countries. Select several to target a region — for example Germany, Austria and Switzerland.\n\nUnlike Search Region, this IS a real filter: it is applied to the creator's own declared country after extraction. Leave empty to keep all countries.\n\n⚠️ Not every creator sets a country on their channel. While this filter is active, channels with no declared country are skipped — the run log reports how many.", "items": { "type": "string", "enum": [ "US", "GB", "CA", "AU", "IE", "NZ", "IN", "PK", "BD", "PH", "SG", "MY", "ID", "TH", "VN", "JP", "KR", "TW", "HK", "CN", "DE", "AT", "CH", "FR", "BE", "NL", "IT", "ES", "PT", "PL", "CZ", "RO", "HU", "GR", "SE", "NO", "DK", "FI", "RU", "UA", "TR", "IL", "SA", "AE", "EG", "NG", "GH", "KE", "ZA", "MA", "BR", "MX", "AR", "CO", "CL", "PE" ], "enumTitles": [ "United States", "United Kingdom", "Canada", "Australia", "Ireland", "New Zealand", "India", "Pakistan", "Bangladesh", "Philippines", "Singapore", "Malaysia", "Indonesia", "Thailand", "Vietnam", "Japan", "South Korea", "Taiwan", "Hong Kong", "China", "Germany", "Austria", "Switzerland", "France", "Belgium", "Netherlands", "Italy", "Spain", "Portugal", "Poland", "Czechia", "Romania", "Hungary", "Greece", "Sweden", "Norway", "Denmark", "Finland", "Russia", "Ukraine", "Turkey", "Israel", "Saudi Arabia", "United Arab Emirates", "Egypt", "Nigeria", "Ghana", "Kenya", "South Africa", "Morocco", "Brazil", "Mexico", "Argentina", "Colombia", "Chile", "Peru" ] }, "default": [] }, "joinedAfter": { "title": "Joined After", "type": "string", "description": "Keep only channels created on or after this date (YYYY-MM-DD). Useful for finding emerging creators. Leave empty for no lower bound.\n\nChannels with no known creation date are skipped while this filter is active.", "default": "" }, "joinedBefore": { "title": "Joined Before", "type": "string", "description": "Keep only channels created on or before this date (YYYY-MM-DD). Useful for finding established creators. Leave empty for no upper bound.\n\nChannels with no known creation date are skipped while this filter is active.", "default": "" }, "excludeKeywords": { "title": "Exclude Keywords", "type": "array", "description": "Skip creators whose channel name, description or channel keywords contain any of these words. Use this when a search term has more than one meaning — searching 'Gemini' returns astrology and tarot channels alongside AI ones, so adding 'tarot', 'zodiac' and 'horoscope' removes them.\n\nMatched as whole words and case-insensitively, so 'ai' will not match 'said'. Excluded creators are skipped before their contact details are fetched, so they cost you nothing.", "default": [], "items": { "type": "string" } }, "findEmails": { "title": "Find business emails", "type": "boolean", "description": "Look for a business email for every creator, and pay only for the ones found.\n\nWith this on, we keep looking beyond the channel page until an address turns up. Creators who publish no address anywhere cost you nothing extra.\n\n💰 Charges one `email-found` event per email address delivered. A creator publishing three addresses bills three; a creator with none bills nothing.\n\nTurn it off to skip the search entirely — you will still get any address shown on the channel page itself, at no extra charge.", "default": true }, "validateEmails": { "title": "Check emails are deliverable", "type": "boolean", "description": "Check each address found and label it in `emailValidationStatus`, so you can drop the bad ones before you send anything.\n\nAddresses come back marked as deliverable, deliverable-but-a-shared-inbox (info@, sales@), undeliverable, or throwaway. It also decides which address becomes the primary one when a creator publishes several, and contributes up to 25 points of the contactability score — with it off, even a lead with a real business email rarely clears the qualified threshold.\n\n💰 Charges one `email-validated` event per address checked. Nothing is charged when this is off, or for a creator with no address.\n\n⚠️ This confirms the address is well-formed and its domain accepts mail. Proving a specific inbox exists is impossible without sending mail, so treat it as a strong signal rather than a guarantee.", "default": true }, "minQualificationScore": { "title": "Minimum Qualification Score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Contactability score (0-100) at which a lead is marked isQualified: true.\n\nThis is a LABEL, not a filter — leads below the threshold are still returned, just flagged as unqualified, so you can tune the cut-off in your CRM without re-running.\n\nTiers are fixed: Hot 80+, Warm 60-79, Cold 40-59, Unqualified below 40.", "default": 60 }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every delivered lead is POSTed as JSON to this URL in real time — ideal for Zapier, Make, n8n catch-hooks and live CRM inserts.\n\nDelivery is best-effort: a failed or timed-out POST is logged and never fails the run.", "default": "" }, "webhookAuthHeader": { "title": "Webhook Authorization Header", "type": "string", "description": "Optional value sent as the Authorization header on each webhook POST — for example 'Bearer abc123'. Leave empty if your endpoint needs no auth." } } }, "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 } } } } } } } } } }