{ "openapi": "3.0.1", "info": { "title": "YouTube Influencer Finder & API: Creators, Views & Emails", "description": "Find YouTube influencers by niche keyword: the creators behind the videos YouTube shows for it, with average views of their latest videos, engagement rate, upload rhythm, sponsors and public emails. Filter by subscribers, views, engagement, activity and country. No login or API key.", "version": "0.1", "x-build-id": "iZLEnITedD5SuSOo9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~youtube-influencer-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-youtube-influencer-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/s_actors~youtube-influencer-finder/runs": { "post": { "operationId": "runs-sync-s_actors-youtube-influencer-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/s_actors~youtube-influencer-finder/run-sync": { "post": { "operationId": "run-sync-s_actors-youtube-influencer-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": { "searchQueries": { "title": "🔎 Niche keywords", "type": "array", "description": "Topics your creators make videos about, one per line (\"vegan recipes\", \"home workout\", \"budget travel\"). The Actor finds the channels behind the videos YouTube shows for each keyword and measures every channel.", "items": { "type": "string" } }, "maxChannelsPerSearch": { "title": "🔢 Creators per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many creators that pass your filters to return for each keyword.", "default": 50 }, "discoveryMode": { "title": "🧭 Find creators by", "enum": [ "videos", "channels", "both" ], "type": "string", "description": "Videos: the creators of the videos YouTube finds for the keyword, so you get people who actually make this content now. Channels: YouTube's channel search, which matches channel names and descriptions.", "default": "videos" }, "uploadedWithin": { "title": "📅 Videos uploaded within", "enum": [ "today", "week", "month", "year", "any" ], "type": "string", "description": "Find creators through videos uploaded in this period (Videos mode). Shorter = more active creators, fewer results.", "default": "year" }, "searchLanguage": { "title": "🗣️ Search language", "type": "string", "description": "Language code of the YouTube search: de, fr, es, pt, hi... Write the keywords in this language too (\"vegane rezepte\" with de) to find local creators.", "default": "en" }, "searchCountry": { "title": "🌐 Search region", "type": "string", "description": "Region code of the YouTube search (US, GB, DE, IN...). YouTube weighs language more than region: to keep only creators from a country, use the Countries filter.", "default": "US" }, "channels": { "title": "📺 Or analyze these channels", "type": "array", "description": "Optional: channel links (youtube.com/@handle, /channel/UC...), @handles, channel IDs or video links, one per line, to vet creators you already have.", "items": { "type": "string" } }, "minSubscribers": { "title": "👥 Min subscribers", "minimum": 0, "type": "integer", "description": "Skip smaller channels, for example 10000." }, "maxSubscribers": { "title": "👥 Max subscribers", "minimum": 0, "type": "integer", "description": "Skip bigger channels, for example 100000 for micro-influencers." }, "minAvgViews": { "title": "👀 Min average views", "minimum": 0, "type": "integer", "description": "Average views of the latest videos, for example 5000. Real reach: subscriber counts hide inactive audiences." }, "minEngagementRate": { "title": "❤️ Min engagement rate, %", "type": "string", "description": "(Likes + comments) / views of the latest videos, median, in percent: for example 2. Typical YouTube values are 1-5%." }, "activeWithinDays": { "title": "⏱️ Uploaded in the last N days", "minimum": 1, "type": "integer", "description": "Skip creators whose newest long video is older, for example 30." }, "countries": { "title": "🌍 Countries", "type": "array", "description": "Only creators with this country on their About page: codes (US, GB, DE, IN) or English names. Channels without a country are skipped when this is set.", "items": { "type": "string" } }, "onlyWithEmail": { "title": "📧 Only creators with an email", "type": "boolean", "description": "Leave out creators where no public email was found.", "default": false }, "recentVideos": { "title": "📊 Latest videos for average views", "minimum": 3, "maximum": 30, "type": "integer", "description": "How many of the latest long videos give the average and median views and the upload rhythm (one page, no extra cost).", "default": 10 }, "videosToScan": { "title": "🎬 Latest videos to open", "minimum": 0, "maximum": 10, "type": "integer", "description": "Opened one by one for exact likes and comments (engagement rate), sponsors and emails in their descriptions. 0 = no engagement and sponsor data.", "default": 5 }, "scanWebsites": { "title": "🌐 Look for emails on websites", "type": "boolean", "description": "Open the channel's website and link-in-bio page (Linktree, Beacons, Stan...) and its contact page, and collect the emails there.", "default": true }, "checkMailServer": { "title": "✅ Check email domains (MX)", "type": "boolean", "description": "Check that each email's domain receives mail. An address whose domain does not is never the main email.", "default": true }, "onlyNewChannels": { "title": "🔔 Only new creators", "type": "boolean", "description": "Creators returned by earlier runs with the same Monitor name are skipped for free. Schedule a keyword weekly to get only newly found creators.", "default": false }, "monitorName": { "title": "🏷️ Monitor name", "type": "string", "description": "Name of the memory used by Only new creators. Use a different name for each list.", "default": "default" }, "maxConcurrency": { "title": "⚡ Parallel requests", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many requests to YouTube run at the same time.", "default": 10 }, "proxyConfiguration": { "title": "🛡️ Proxy", "type": "object", "description": "Requests to YouTube go direct first and switch to Apify datacenter proxies when YouTube refuses them. Websites are opened direct.", "default": { "useApifyProxy": true } }, "debugLog": { "title": "🐞 Debug log", "type": "boolean", "description": "Log every failed attempt and proxy switch.", "default": false } } }, "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 } } } } } } } } } }