{ "openapi": "3.0.1", "info": { "title": "YouTube Creator Finder - Search by Niche, Get Contacts", "description": "Find YouTube creators by niche, filter them by subscriber count and country, and get their profile, links and public contact email - each one validated with a plain-English send recommendation.", "version": "0.1", "x-build-id": "qZyp0PAsoqA7XUCee" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/salomon.labs~youtube-creator-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-salomon.labs-youtube-creator-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/salomon.labs~youtube-creator-finder/runs": { "post": { "operationId": "runs-sync-salomon.labs-youtube-creator-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/salomon.labs~youtube-creator-finder/run-sync": { "post": { "operationId": "run-sync-salomon.labs-youtube-creator-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": { "searchKeywords": { "title": "Niches to search", "type": "array", "description": "What kind of creators you want, in the words you would type into YouTube. One niche per line, e.g. 'sourdough baking' or 'home workout fitness'. Leave empty if you are supplying channel URLs below.", "items": { "type": "string" } }, "channelUrls": { "title": "Or paste specific channels", "type": "array", "description": "Channel handles (@name), full channel URLs, or channel IDs (UC...). Use this when you already have a list. These are always processed, and are not affected by the subscriber filters below.", "items": { "type": "string" } }, "minSubscribers": { "title": "Minimum subscribers", "minimum": 0, "type": "integer", "description": "Skip creators below this size. Outreach shortlists are built in bands: very small channels rarely move product.", "default": 5000 }, "maxSubscribers": { "title": "Maximum subscribers", "minimum": 0, "type": "integer", "description": "Skip creators above this size. Mega-channels usually ignore cold approaches and route everything through an agency.", "default": 500000 }, "maxCreators": { "title": "Maximum creators to return", "minimum": 1, "maximum": 1000, "type": "integer", "description": "A hard ceiling on how many creator profiles this run produces, and therefore on what it costs. Channels are filtered by size BEFORE this limit applies, so you spend the budget on creators that match.", "default": 25 }, "maxChannelsPerKeyword": { "title": "How deep to search each niche", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many channels to pull from YouTube per keyword before filtering. Searching is cheap; raise it if a narrow subscriber band is leaving you with too few matches.", "default": 40 }, "scanCreatorWebsites": { "title": "Follow the creator's own website", "type": "boolean", "description": "When a creator publishes no address on YouTube, look for one on their own site's contact page. Only sites that appear to belong to the creator are followed - sponsor and affiliate links are ignored on purpose. Turning this off makes runs faster and finds fewer contacts.", "default": true }, "validateEmails": { "title": "Validate every email found", "type": "boolean", "description": "Check each address for syntax, a live domain, a working mail route, disposable and role-inbox status, and return a plain-English send recommendation. Leave on unless you only want raw strings.", "default": true } } }, "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 } } } } } } } } } }