{ "openapi": "3.0.1", "info": { "title": "YouTube Influencer Scraper — Emails & Engagement", "description": "Find YouTube influencers by niche and scrape their business emails without an API key. Engagement rate, subscribers & socials. Export channel data to CSV/JSON.", "version": "1.0", "x-build-id": "DriNvhWb3nQORjgNB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~youtube-influencer-discovery-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-youtube-influencer-discovery-scraper", "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/logiover~youtube-influencer-discovery-scraper/runs": { "post": { "operationId": "runs-sync-logiover-youtube-influencer-discovery-scraper", "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/logiover~youtube-influencer-discovery-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-youtube-influencer-discovery-scraper", "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": { "searchQueries": { "title": "Niche keywords (discovery)", "type": "array", "description": "Free-text keywords/niches to discover creators in. Each runs a YouTube channel search. Examples: ['personal finance', 'home workout', 'tech reviews']. Leave empty to use the Niche preset below.", "default": [], "items": { "type": "string" } }, "niche": { "title": "Niche preset (used if no keywords given)", "enum": [ "tech reviews", "personal finance", "home workout", "gaming", "beauty and makeup", "cooking recipes", "travel vlog", "real estate investing", "digital marketing", "productivity", "podcast", "music production", "photography", "car reviews", "health and wellness", "software tutorials", "crypto and web3", "fashion", "education", "comedy" ], "type": "string", "description": "Pick a popular niche to discover creators in. Used only when 'Niche keywords' above is empty. With everything empty the actor discovers Tech Review creators by default.", "default": "tech reviews" }, "channels": { "title": "Channels (direct enrich)", "type": "array", "description": "Optional: enrich specific channels directly. @handles, channel URLs, or UC… IDs. Combined with any discovery results.", "default": [], "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "US", "GB", "CA", "AU", "DE", "FR", "ES", "IT", "NL", "BR", "MX", "IN", "JP", "KR", "TR", "RU", "ID", "PH", "NG", "ZA" ], "type": "string", "description": "Country context for the YouTube search results (affects which creators surface).", "default": "US" }, "language": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "nl", "ru", "tr", "ar", "hi", "id", "ja", "ko", "zh" ], "type": "string", "description": "Interface/content language for the YouTube search (hl parameter).", "default": "en" }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "subscribers_desc", "subscribers_asc", "engagement_desc", "avgViews_desc" ], "type": "string", "description": "How to order the saved creators.", "default": "relevance" }, "maxChannelsPerQuery": { "title": "Max channels per query", "minimum": 1, "type": "integer", "description": "How many channels to discover per search keyword.", "default": 30 }, "recentVideosForStats": { "title": "Recent videos sampled for stats", "minimum": 1, "type": "integer", "description": "How many recent videos to average for avg views & engagement rate.", "default": 12 }, "minSubscribers": { "title": "Min subscribers", "minimum": 0, "type": "integer", "description": "Only keep channels with at least this many subscribers. 0 = no minimum.", "default": 0 }, "maxSubscribers": { "title": "Max subscribers", "minimum": 0, "type": "integer", "description": "Only keep channels up to this many subscribers (great for finding micro-influencers). 0 = no maximum.", "default": 0 }, "requireEmail": { "title": "Only channels with an email", "type": "boolean", "description": "Keep only channels that expose a contact email in their description.", "default": false }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Global cap on channels saved. Keeps empty-input runs fast & cheap. Raise it to pull more.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy settings. Defaults to automatic proxy. If it fails, the actor falls back to a direct connection.", "default": { "useApifyProxy": 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 } } } } } } } } } }