{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper - Channels, Hashtags & Details", "description": "Scrape YouTube Shorts from direct Short URLs, channel handles, channel URLs, and hashtags. Get titles, URLs, thumbnails, duration, views, likes, comments, publish dates, author handles, subscriber counts, channel IDs, and profile metadata.", "version": "0.0", "x-build-id": "qYb5YdWdUXo5N3UWe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/newbs~Youtube-Shorts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-newbs-Youtube-Shorts", "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/newbs~Youtube-Shorts/runs": { "post": { "operationId": "runs-sync-newbs-Youtube-Shorts", "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/newbs~Youtube-Shorts/run-sync": { "post": { "operationId": "run-sync-newbs-Youtube-Shorts", "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": { "channel": { "title": "Channel handles or URLs", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Enter one or more YouTube channel handles, names, or URLs. Examples: youtube, @adidas, https://www.youtube.com/@zara/shorts. Ignored when hashtags are provided.", "items": { "type": "string" } }, "hashtag": { "title": "Hashtags", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Enter hashtags with or without #. When provided, hashtags take precedence over channels.", "items": { "type": "string" } }, "videoUrls": { "title": "Direct Shorts URLs", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Enter specific YouTube Shorts URLs to scrape directly, without loading a channel or hashtag listing. Direct URLs take precedence over hashtags and channels.", "items": { "type": "string" } }, "numberOfResults": { "title": "Results per source", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of Shorts to return for each channel or hashtag. Capped at 100 per source to keep runs predictable. The default sample is intentionally small so the first Apify test run finishes quickly.", "default": 1 }, "needVideoDetails": { "title": "Enrich video and channel details", "type": "boolean", "description": "Enabled by default. Uses fast HTTP extraction to collect available likes, views, publish date, description, and author metadata. Disable only for a faster listing-only run with fewer fields.", "default": true }, "fallbackToBrowser": { "title": "Use browser fallback for missing details", "type": "boolean", "description": "Disabled by default for speed. Enable it to open Shorts in a browser when HTTP extraction is missing important fields such as comment count. This is slower but can improve completeness.", "default": false }, "includeChannelDetails": { "title": "Visit channel pages for profile data", "type": "boolean", "description": "Disabled by default for faster sample runs. Enable it to visit each unique creator channel page for subscriber count, channel video count, banner, avatar, description, and social links.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many browser pages can run at once. Keep 1-2 for stable detail enrichment; higher values are capped at 5.", "default": 1 }, "maxRunSeconds": { "title": "Soft runtime limit", "minimum": 0, "maximum": 86400, "type": "integer", "description": "Optional graceful runtime cap in seconds. The sample run is prefilled with 240 so Apify tests stop cleanly before a 300-second timeout. Set 0 to use the Apify run timeout.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings used by the browser crawler. Apify Proxy is used by default on the Apify platform.", "default": { "useApifyProxy": 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 } } } } } } } } } }