{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper", "description": "Scrape YouTube Shorts from public channels for titles, views, likes, publish dates, hashtags, thumbnails, descriptions, and channel data. Filter by keywords, views, dates, or sort order before output. Pay per Short with no login or YouTube API key.", "version": "0.2", "x-build-id": "nfdTqTjgzCo08hqnz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/schnellscrapers~youtube-shorts-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-schnellscrapers-youtube-shorts-monitor", "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/schnellscrapers~youtube-shorts-monitor/runs": { "post": { "operationId": "runs-sync-schnellscrapers-youtube-shorts-monitor", "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/schnellscrapers~youtube-shorts-monitor/run-sync": { "post": { "operationId": "run-sync-schnellscrapers-youtube-shorts-monitor", "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", "required": [ "channels" ], "properties": { "channels": { "title": "YouTube channels", "type": "array", "description": "One or more public YouTube channel handles, usernames, or channel URLs. Examples: `@MrBeast`, `MrBeast`, or `https://www.youtube.com/@MrBeast`.", "items": { "type": "string" } }, "maxShortsPerChannel": { "title": "Maximum Shorts per channel", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum Shorts considered from each channel before filters are applied. Lower values keep recurring monitoring runs fast and cheap.", "default": 50 }, "maxPagesPerChannel": { "title": "Maximum feed pages per channel", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum initial or continuation feed pages fetched per channel. One page is enough for a low-cost recurring check; increase it for older Shorts.", "default": 1 }, "maxItems": { "title": "Maximum total Shorts", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on Shorts written across all input channels after filters. Use a small value such as `20` for a cost-bounded smoke run.", "default": 1000 }, "sortBy": { "title": "Sort Shorts by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "Order the channel feed as newest, popular, or oldest. The source's own Shorts sort controls are used when available.", "default": "newest" }, "publishedAfter": { "title": "Only Shorts published after", "type": "string", "description": "Optional exact date or relative period such as `2026-01-01`, `7 days`, or `2 weeks`. Date filtering fetches Short detail pages so the cutoff uses the exact publish timestamp." }, "titleKeywords": { "title": "Include title keywords", "type": "array", "description": "Keep a Short when its title, description, or hashtags contain at least one of these case-insensitive phrases. Filtering happens before dataset writes.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop a Short when its title, description, or hashtags contain any of these case-insensitive phrases. Filtering happens before dataset writes.", "items": { "type": "string" } }, "minViews": { "title": "Minimum views", "minimum": 0, "maximum": 100000000000, "type": "integer", "description": "Keep only Shorts with at least this many parsed views. Shorts without a view count are excluded when this is greater than zero.", "default": 0 }, "includeVideoDetails": { "title": "Fetch exact Short details", "type": "boolean", "description": "Fetch each selected Short page for exact publish time, views, likes, duration, description, and channel metadata. Off is the cheapest feed-only mode.", "default": false }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Fetch, filter, and validate Shorts without writing dataset records. Use for previews and smoke tests when you want logs without result billing.", "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 } } } } } } } } } }