{ "openapi": "3.0.1", "info": { "title": "YouTube Creator Contact Finder", "description": "Extract YouTube creator/channel business contact info (public emails + links + channel metrics) for influencer/brand outreach.", "version": "0.0", "x-build-id": "J3j6Diw12p4e8nyXd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~youtube-creator-contact-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-youtube-creator-contact-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/nexgendata~youtube-creator-contact-finder/runs": { "post": { "operationId": "runs-sync-nexgendata-youtube-creator-contact-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/nexgendata~youtube-creator-contact-finder/run-sync": { "post": { "operationId": "run-sync-nexgendata-youtube-creator-contact-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": { "channels": { "title": "YouTube channels (handles, URLs, or channel IDs)", "type": "array", "description": "Optional. A list of YouTube channels to enrich directly. Accepts @handles (e.g. @mkbhd), full channel URLs (https://www.youtube.com/@mkbhd or /channel/UC...), or raw channel IDs (UC...). The actor reads each channel's public page + About tab for business contact info: emails in the public description, the creator's listed website/socials, and channel metrics. Provide this and/or searchKeywords.", "items": { "type": "string" } }, "searchKeywords": { "title": "Discover channels by niche / topic (keyword search)", "type": "array", "description": "Optional discovery mode. Provide niche or topic phrases (e.g. \"home barista\", \"indie game dev\", \"vegan meal prep\") and the actor SEARCHES YouTube for channels matching each one, collects up to maxCreators unique channels, then runs them through the same email-enrichment pipeline. Combine with channels to mix discovered creators with explicit handles (deduped). Leave blank to only enrich the channels you list.", "items": { "type": "string" } }, "maxCreators": { "title": "Maximum creators to discover (hard cap)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard limit on how many channels keyword discovery will collect and scan in total (explicit channels count toward this cap when discovery is on). The actor stops the moment this is hit so a broad search can never explode cost. Server-clamped to 500.", "default": 20 }, "maxChannels": { "title": "Maximum channels to scan (hard cap, explicit-list mode)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard limit on how many of the explicitly listed channels are fetched when you are NOT using keyword discovery. The actor stops the moment this is hit so compute stays predictable. Server-clamped to 500. (When searchKeywords is set, maxCreators is the governing cap instead.)", "default": 50 }, "followChannelLinks": { "title": "Resolve channel website links for emails", "type": "boolean", "description": "When a channel has no email in its public description but lists a website (not a pure social link), resolve that page and extract emails from it. This is the main yield path, since channels rarely put a raw email in the description. Leave on unless you only want description emails.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy used for searching YouTube, fetching channel pages and resolving website links. Datacenter is the default and cheapest — YouTube serves the embedded channel JSON to datacenter requests reliably; residential is used automatically only if a datacenter fetch is blocked.", "default": { "useApifyProxy": true } }, "notionConnector": { "title": "Deliver to Notion (optional)", "type": "string", "description": "Optional. Connect your Notion workspace and the channels + emails are also written as a Notion page in the same run — the Actor never sees your Notion credentials. Authorize a Notion MCP connector in Apify Console → Settings → API & Integrations, then select it here." }, "notionParentId": { "title": "Notion parent page ID (optional)", "type": "string", "description": "Optional. The Notion page ID to create the page under. If blank, Notion creates a private page at workspace root." } } }, "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 } } } } } } } } } }