{ "openapi": "3.0.1", "info": { "title": "YouTube Influencer & Channel Discovery — Emails & Stats", "description": "Discover YouTube channels and creators by keyword, niche, subscriber count, and content type (Channels, Videos, Shorts). Automatically enriches channel profiles with subscriber counts, descriptions, business emails, and unwrapped social links.", "version": "1.1", "x-build-id": "LHTTqUNk0G0TQ2Es0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/skcho~youtube-channel-discovery/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-skcho-youtube-channel-discovery", "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/skcho~youtube-channel-discovery/runs": { "post": { "operationId": "runs-sync-skcho-youtube-channel-discovery", "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/skcho~youtube-channel-discovery/run-sync": { "post": { "operationId": "run-sync-skcho-youtube-channel-discovery", "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", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries (Keywords or Hashtags)", "minItems": 1, "maxItems": 100, "type": "array", "description": "Keywords or hashtags to search on YouTube. One per line. Examples: AI tools, home workout, #mealprep", "default": [ "AI tools", "home workout" ], "items": { "type": "string" } }, "contentType": { "title": "Discovery Strategy (Content Type)", "enum": [ "video", "channel", "playlist" ], "type": "string", "description": "Search 'Channel' results directly, or search 'Video' results and extract the active creators behind them.", "default": "channel" }, "uploadDate": { "title": "Upload Date Filter", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Filter by recent video upload window (works best with Content Type = Video to find active creators).", "default": "any" }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "upload_date", "view_count", "rating" ], "type": "string", "description": "Sort search results by specific criteria", "default": "relevance" }, "maxResultsPerQuery": { "title": "Max Channels Per Keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "50 channels = $0.035–$0.05. Up to 1,000 per keyword. Channels found under multiple keywords are deduplicated and billed once.", "default": 50 }, "useYoutubeApi": { "title": "Enrich with Subscribers, Views, Description & Emails", "type": "boolean", "description": "Adds subscriber count, total video & view counts, full description, and extracted business emails & social links. No API key needed.", "default": true }, "youtubeApiKey": { "title": "Own YouTube API Key (Optional)", "type": "string", "description": "Optional: Provide your own YouTube Data API v3 key if you prefer to run enrichment on your own quota. Leave empty to use the built-in enrichment." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for YouTube requests. Leave empty to connect directly (recommended default). Note: Apify datacenter proxies are blocked by YouTube search — only use with Residential proxies." } } }, "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 } } } } } } } } } }