{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper", "description": "[💰 $1.5 / 1K] Extract YouTube Shorts from any channel, search, or URL — titles, view counts, likes, comment counts, hashtags, durations, thumbnails, and full channel details. Filter by upload date, sort by newest, popular, or oldest, and localize across 40+ countries.", "version": "1.0", "x-build-id": "TVTT7A3dMak7F20WP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~youtube-shorts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-youtube-shorts-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/solidcode~youtube-shorts-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-youtube-shorts-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/solidcode~youtube-shorts-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-youtube-shorts-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": "Channel usernames or links whose Shorts tab you want to scrape. Enter a username with or without the '@' (e.g. 'nasa', '@mkbhd') or paste a channel URL (e.g. https://www.youtube.com/@NASA). Each channel is scraped independently.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Keywords to search on YouTube (e.g. 'satisfying recipes', 'gym motivation'). Only Shorts are returned. Each query runs independently. Leave empty if you only want to scrape channels or URLs.", "items": { "type": "string" } }, "startUrls": { "title": "YouTube URLs", "type": "array", "description": "Paste YouTube URLs directly. Accepts channel URLs (/@handle, /channel/UC..., /c/..., /user/...), individual Shorts URLs (/shorts/...), and hashtag URLs (/hashtag/...). Mix any of these in one list.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum Shorts per Source", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of Shorts to fetch per channel, search query, or hashtag (up to 100,000). Set to 0 to fetch every available Short; extremely large channels are still collected up to a high internal safety ceiling (roughly 15,000 Shorts per source). Individual Shorts URLs always return exactly one result regardless of this setting.", "default": 30 }, "oldestPostDate": { "title": "Oldest Post Date", "type": "string", "description": "Only include Shorts uploaded on or after this date. Accepts an exact date (e.g. '2024-01-01') or a relative window (e.g. '7 days', '3 months'). Leave empty for no date limit. Applies to channel and hashtag inputs (search results are not date-filtered)." }, "sortBy": { "title": "Sort Shorts By", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "Order the collected Shorts by newest, most viewed, or oldest. Sorting is applied to the Shorts collected for each source after their exact upload dates and view counts are gathered. When a result cap is set, this orders the Shorts collected under that cap (YouTube serves newest first), not YouTube's global ranking.", "default": "newest" }, "country": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "fr", "de", "es", "it", "nl", "be", "pt", "ch", "at", "se", "no", "dk", "fi", "pl", "jp", "kr", "hk", "tw", "sg", "my", "th", "id", "ph", "vn", "in", "br", "mx", "ar", "cl", "co", "ae", "sa", "tr", "il", "za", "eg" ], "type": "string", "description": "Localize results to this country. Affects which Shorts are shown and their localized metadata.", "default": "us" }, "language": { "title": "Language", "enum": [ "en", "fr", "de", "es", "it", "pt", "nl", "pl", "tr", "ru", "ja", "ko", "zh-CN", "zh-TW", "ar", "he", "th", "vi", "id" ], "type": "string", "description": "Interface language for Short titles and metadata returned in the response.", "default": "en" }, "includeChannelDetails": { "title": "Include Channel Details", "type": "boolean", "description": "Enrich each Short with extended details about its channel — description, join date, location, avatar, banner, total video count, and total view count. Adds one extra fetch per unique channel. Turn off for faster, leaner results.", "default": 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 } } } } } } } } } }