{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper & Channel Email Finder", "description": "YouTube Shorts and channel video scraper with creator emails. Get views, likes, comments, tags and exact dates from channels, Shorts and keyword search, plus channel emails and social links. No API key or quota. $1.50 per 1,000 videos.", "version": "1.0", "x-build-id": "vX12XFx8TSHW0j2n4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrape-lads~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrape-lads-youtube-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/scrape-lads~youtube-scraper/runs": { "post": { "operationId": "runs-sync-scrape-lads-youtube-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/scrape-lads~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-scrape-lads-youtube-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": { "channels": { "title": "Channels", "type": "array", "description": "YouTube channels as @handle, channel URL (/@name, /channel/UC..., /c/name, /user/name), or channel ID (UC...).", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on YouTube, one per line. Each query is a separate source.", "items": { "type": "string" } }, "videoUrls": { "title": "Video or Short URLs", "type": "array", "description": "Single videos to scrape: watch URLs, youtu.be links, /shorts/ URLs, or 11-character video IDs. Always fetched with full details.", "items": { "type": "string" } }, "contentType": { "title": "Content type", "enum": [ "both", "videos", "shorts" ], "type": "string", "description": "Regular videos, Shorts, or both. For channels, \"both\" reads the Videos and Shorts tabs, each up to the per-source limit.", "default": "both" }, "maxResultsPerSource": { "title": "Max results per source", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum videos per channel tab, per search query.", "default": 50 }, "maxResults": { "title": "Max results in total", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard cap on video rows for the whole run. The run also stops at your maximum cost per run.", "default": 1000 }, "includeVideoDetails": { "title": "Include full video details", "type": "boolean", "description": "Fetch each video's likes, comments count, tags, full description, category, exact publish date, and channel subscribers. Charged as an extra small event per row. Turn off for list data only (title, views, duration, relative date).", "default": true }, "sortBy": { "title": "Channel sort order", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Order of a channel's videos and Shorts.", "default": "latest" }, "searchSortBy": { "title": "Search sort order", "enum": [ "relevance", "views", "rating" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "newerThanDays": { "title": "Only videos newer than (days)", "minimum": 0, "maximum": 36500, "type": "integer", "description": "Keep only videos published in the last N days. 0 keeps everything. On a channel sorted by latest, paging stops at the first older video.", "default": 0 }, "includeChannelContacts": { "title": "Add channel contact rows", "type": "boolean", "description": "Add one free \"channel\" row per channel with its About data: emails found in the description or website, Instagram, TikTok, X, Facebook, LinkedIn, Twitch, Discord links, website, country, join date, total views, and whether a business email exists.", "default": false }, "fetchChannelWebsite": { "title": "Read the channel website for emails", "type": "boolean", "description": "When contact rows are on and the description has no email, open the website or link hub listed on the channel and read the emails and social links published there.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel requests to YouTube. The default suits most runs.", "default": 10 } } }, "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 } } } } } } } } } }