{ "openapi": "3.0.1", "info": { "title": "YouTube Creator Lead Finder - Views, Niche, Email", "description": "Find YouTube creators by niche or keyword: subscribers, median recent views, language, posting cadence and public business contact, each backed by its source URL. Export to JSON, CSV or Excel, or call it as an API. No login needed. For influencer marketing and creator outreach lists.", "version": "0.1", "x-build-id": "18beG3j8icbXodpO1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/om_kh~youtube-creator-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-om_kh-youtube-creator-lead-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/om_kh~youtube-creator-lead-finder/runs": { "post": { "operationId": "runs-sync-om_kh-youtube-creator-lead-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/om_kh~youtube-creator-lead-finder/run-sync": { "post": { "operationId": "run-sync-om_kh-youtube-creator-lead-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": { "keywords": { "title": "Niche keywords", "type": "array", "description": "Niches to search for creators in, e.g. 'home coffee roasting'. Discovers channel candidates via public search.", "items": { "type": "string" } }, "channelUrls": { "title": "Channel URLs", "type": "array", "description": "Channels you already have. Full URL, @handle, or bare handle all work.", "items": { "type": "string" } }, "minSubscribers": { "title": "Minimum subscribers", "minimum": 0, "type": "integer", "description": "Skip channels below this subscriber count." }, "maxSubscribers": { "title": "Maximum subscribers", "minimum": 0, "type": "integer", "description": "Skip channels above this subscriber count." }, "minMedianRecentViews": { "title": "Minimum median recent views", "minimum": 0, "type": "integer", "description": "Skip channels whose recent videos median below this view count. Filtering happens before billing.", "default": 0 }, "languages": { "title": "Language filter (ISO 639-1)", "type": "array", "description": "Keep only channels in these languages, e.g. en, fr, es. Applied best-effort against the channel's declared language.", "items": { "type": "string" } }, "activeWithinDays": { "title": "Active within (days)", "minimum": 1, "type": "integer", "description": "Exclude channels with no video published in this many days.", "default": 90 }, "requireContact": { "title": "Require public business contact", "type": "boolean", "description": "Off (default): deliver every qualified channel, contact or not -- 'contact-verified' is billed only when one is actually found. On: only deliver channels where a public business contact was found (most real YouTube channels do not publish one -- this used to default to true and silently filtered out nearly every result, see P0-5).", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many qualified creators.", "default": 100 }, "monitorEnabled": { "title": "Enable monitoring", "type": "boolean", "description": "On later runs with the same Monitor ID, deliver only creators not seen before.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Groups runs into one monitored target. Leave blank for a one-off run." }, "maxTotalChargeUsd": { "title": "Maximum charge (USD)", "minimum": 0, "type": "number", "description": "Hard ceiling on what this run can bill you. The run stops delivering paid rows once it is reached." } } }, "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 } } } } } } } } } }