{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Email & Contact Scraper", "description": "Find YouTube channels by niche and export creator contacts: e-mail from the channel description when there is one, website, Instagram, TikTok, X and Discord, plus subscribers, views and country. 25 columns to CSV or Excel. At least one public contact on 84-93% of channels.", "version": "0.1", "x-build-id": "6N02Y4NuR17fujM4H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lightmoon~youtube-influencer-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lightmoon-youtube-influencer-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/lightmoon~youtube-influencer-scraper/runs": { "post": { "operationId": "runs-sync-lightmoon-youtube-influencer-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/lightmoon~youtube-influencer-scraper/run-sync": { "post": { "operationId": "run-sync-lightmoon-youtube-influencer-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": "Search phrases", "type": "array", "description": "One niche or topic per line, searched against YouTube's own channel search. Each phrase returns 20 channels per page and pages onward until it runs out or your limit is reached, so a single phrase can fill a whole run. Use the words a creator would put in their own channel name or description — `home coffee roasting` finds more than `coffee`.", "items": { "type": "string" } }, "channelUrls": { "title": "Channels you already know", "type": "array", "description": "One channel per line, if you have a list already. A handle like `@mkbhd`, a full `https://www.youtube.com/@mkbhd` URL, a `/channel/UC...` address or a bare channel id all work. These are fetched directly — no search step — and cost one request each.", "items": { "type": "string" } }, "maxChannels": { "title": "Maximum channels in total", "minimum": 0, "maximum": 2000, "type": "integer", "description": "A ceiling for the whole run, across every phrase and channel. Set 0 for as many as the searches can produce, up to 2000.", "default": 50 }, "withContacts": { "title": "Look up contact details", "type": "boolean", "description": "On: each channel's About tab is read for its public links — website, Instagram, TikTok, X, Facebook, Discord — plus country, join date, view count and video count. Off: you get the search result only — name, handle, URL, subscribers and description — which is far cheaper and far faster. Turn it off to scan a niche wide, then run again with a shortlist.", "default": true }, "minSubscribers": { "title": "Minimum subscribers", "minimum": 0, "type": "integer", "description": "Skip channels smaller than this. Applied before the contact lookup, so filtered-out channels cost nothing.", "default": 0 }, "maxSubscribers": { "title": "Maximum subscribers", "minimum": 0, "type": "integer", "description": "Skip channels larger than this. Leave 0 for no upper limit. Use it with the minimum above to find channels in a sponsorship band — say 5000 to 50000 — instead of the household names.", "default": 0 }, "onlyWithContacts": { "title": "Store only channels with a public contact", "type": "boolean", "description": "Keeps rows where at least one public link or address was found. Channels without one are never charged at contact rates whichever way this is set; turn it on to keep them out of the export as well. Needs the contact lookup above to be on.", "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 } } }, "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 } } } } } } } } } }