{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts Scraper: Views, Likes, Comments, $2/1K", "description": "Scrape YouTube Shorts from channels or single Shorts URLs: views, likes, comment count, exact publish date, duration, hashtags, description and full channel stats. Sort by newest, popular or oldest, filter by date, monitor for new Shorts. No login, no API key, no proxy needed.", "version": "0.1", "x-build-id": "aY9bswH8YkUWuYjwS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/transparent_meteorite~youtube-shorts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-transparent_meteorite-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/transparent_meteorite~youtube-shorts-scraper/runs": { "post": { "operationId": "runs-sync-transparent_meteorite-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/transparent_meteorite~youtube-shorts-scraper/run-sync": { "post": { "operationId": "run-sync-transparent_meteorite-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": "Channels to take Shorts from: @handle, channel URL (/@name, /channel/UC..., /c/, /user/) or channel ID. A single Shorts URL (youtube.com/shorts/...) also works. One per line.", "items": { "type": "string" } }, "startUrls": { "title": "Channel or Shorts URLs", "type": "array", "description": "Same as Channels, in URL-list form. Channel pages, /shorts tabs and single Shorts URLs are accepted.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResultsShorts": { "title": "Max Shorts per channel", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many Shorts to return from each channel (newest first by default).", "default": 10 }, "sortChannelShortsBy": { "title": "Sort Shorts by", "enum": [ "NEWEST", "POPULAR", "OLDEST" ], "type": "string", "description": "Same as the Latest / Popular / Oldest chips on the channel Shorts tab.", "default": "NEWEST" }, "oldestPostDate": { "title": "Only Shorts newer than", "type": "string", "description": "A date (2025-01-31) or a relative period (7 days, 2 weeks, 3 months, 1 year). Older Shorts are skipped and not charged. Works best with Newest first." }, "scrapeDetails": { "title": "Scrape full Short details", "type": "boolean", "description": "On (default): opens each Short for likes, comment count, exact publish time, description, hashtags and category. Off: listing data only (title, views, thumbnail, approximate date), a little faster. Same price.", "default": true }, "includeChannelInfo": { "title": "Add channel info to every row", "type": "boolean", "description": "Subscribers, total views, video count, country, joined date, links, avatar and banner (one extra request per channel).", "default": true }, "maxConcurrency": { "title": "Parallel Short pages", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many Short pages to load at once.", "default": 12 }, "monitorMode": { "title": "Monitor mode: only new Shorts", "type": "boolean", "description": "Remembers Shorts delivered by earlier runs (in a named key-value store) and only returns and charges new ones. Ideal for schedules.", "default": false }, "stateStoreName": { "title": "Monitor store name", "type": "string", "description": "Use a different name per schedule if you monitor different channels.", "default": "youtube-shorts-scraper-seen" }, "autoProxyFallback": { "title": "Switch to residential proxy when blocked", "type": "boolean", "description": "On by default: if you left the proxy off and YouTube starts rate-limiting the IP, the run switches itself to Apify residential proxy instead of returning errors. Residential traffic is billed by Apify separately.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed for normal runs: public YouTube pages load fine without a proxy. Set one only if you want to force a specific country or group.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }