{ "openapi": "3.0.1", "info": { "title": "YouTube Influencer Scraper", "description": "Find YouTube influencers by niche and export creator contact links: website, Instagram, TikTok, X, Discord, subscribers, views, country. 25 columns to CSV or Excel. Filter by subscriber range to find small channels to sponsor for brand deals and influencer outreach.", "version": "0.1", "x-build-id": "OEEvnwIgWwgrtkBU0" }, "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 } } } } } } } } } }