{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Finder: Influencer Category (Nano/Micro/Macro)", "description": "YouTube Channel Finder locates and returns detailed channel profiles from YouTube by username, keyword, or URL. Returns channel ID, title, description, subscriber counts, uploads, thumbnails, links, and stats. Perfect for discovery, competitive research, influencer outreach, and automated workflows", "version": "0.0", "x-build-id": "eBZspoPuSiVzeCCCU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~youtube-channel-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-youtube-channel-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/simpleapi~youtube-channel-finder/runs": { "post": { "operationId": "runs-sync-simpleapi-youtube-channel-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/simpleapi~youtube-channel-finder/run-sync": { "post": { "operationId": "run-sync-simpleapi-youtube-channel-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": "🔎 Search Keywords", "type": "array", "description": "Keywords to search YouTube for channels (e.g. \"fitness coach\", \"tech reviews\"). One per line. Combine with \"Channels per Keyword\" to control how many results per term. Default: [\"fitness coach\"].", "items": { "type": "string" } }, "urls": { "title": "🔗 Direct Channel / Video URLs", "type": "array", "description": "Paste specific YouTube channel or video URLs to analyze directly (skips search). Each is scored the same way as search results: numeric subscriber count, influencer tier, and reach metrics.", "items": { "type": "string" } }, "minSubscribers": { "title": "🎯 Minimum Subscribers", "minimum": 0, "type": "integer", "description": "Only keep channels with at least this many REAL numeric subscribers (parsed from text like \"1.2M subscribers\" -> 1200000). 0 = no minimum. A channel whose subscriber count could not be parsed is excluded while this filter is active (never guessed).", "default": 0 }, "maxSubscribers": { "title": "🎯 Maximum Subscribers", "minimum": 0, "type": "integer", "description": "Only keep channels with at most this many real numeric subscribers. 0 = no maximum. Combine with Minimum Subscribers to target one tier, e.g. 10000-100000 for micro-influencers.", "default": 0 }, "channelCount": { "title": "📺 Channels per Keyword", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of channels to fetch per search keyword. Hard-capped at 50 by the engine (values above 50 are clamped to 50, matching this schema — never silently ignored).", "default": 10 }, "searchRegion": { "title": "🌍 Search Region", "enum": [ "US", "GB", "CA", "AU", "IN", "DE", "FR", "JP", "BR", "MX", "ES", "IT", "NL", "PL", "RU", "KR", "TW" ], "type": "string", "description": "YouTube search region (country code). Affects which channels appear in search results.", "default": "US" }, "language": { "title": "🗣️ Language", "enum": [ "en", "es", "de", "fr", "pt", "ja", "hi", "zh", "ko", "ar", "ru" ], "type": "string", "description": "Interface and result language code (e.g. en for English).", "default": "en" }, "fromDate": { "title": "📅 Joined After", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only include channels that joined YouTube on or after this date (YYYY-MM-DD). Leave empty for no filter." }, "toDate": { "title": "📅 Joined Before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only include channels that joined YouTube on or before this date (YYYY-MM-DD). Leave empty for no filter." }, "aiNicheClassification": { "title": "🤖 Enable AI Niche Classification", "type": "boolean", "description": "Optional, OFF by default. Uses an LLM to classify each channel's content niche (gaming, beauty & fashion, finance, tech, etc.) from its description. Requires an API key below. On failure or missing key, niche is left null — never guessed.", "default": false }, "aiModel": { "title": "🤖 AI Model / Provider", "enum": [ "claude-haiku-4-5", "claude-sonnet-5", "claude-opus-4-8", "claude-fable-5", "gpt-4o-mini", "gpt-4o", "gpt-4.1-mini", "gpt-4.1", "o3-mini", "o1", "gemini-2.0-flash-lite", "gemini-2.0-flash", "gemini-1.5-pro", "gemini-2.5-flash", "gemini-2.5-pro", "grok-2-latest", "grok-3-mini", "grok-3", "grok-beta", "deepseek-chat", "deepseek-reasoner", "sonar", "sonar-pro", "sonar-reasoning", "mistral-small-latest", "mistral-large-latest" ], "type": "string", "description": "Provider auto-detected from the name: claude-*=Anthropic, gpt-*/o1/o3=OpenAI, gemini-*=Google, grok-*=xAI, deepseek-*=DeepSeek, sonar*=Perplexity, mistral-*=Mistral. Cheaper mini/flash/haiku/lite models are recommended for classification.", "default": "claude-haiku-4-5" }, "aiApiKey": { "title": "🔑 AI API Key", "type": "string", "description": "API key for the selected AI provider. Falls back to the matching env var (e.g. ANTHROPIC_API_KEY) if left empty. Only used when AI Niche Classification is enabled above." }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Optional. By default the actor runs without a proxy. Enable Apify Proxy here for higher volume or to reduce blocks. If the chosen proxy gets blocked, the actor automatically falls back to Residential proxy and continues." } } }, "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 } } } } } } } } } }