{
"openapi": "3.0.1",
"info": {
"title": "YouTube Shorts Scraper - Shorts by Channel or Keyword",
"description": "Scrape YouTube Shorts from any channel's Shorts tab or from a Shorts search: title, views, URL, thumbnail and channel, with optional likes, date and duration. Newest or most popular first. No API key, no quota, no login.",
"version": "0.1",
"x-build-id": "2uTlVBDP0oRgHUIzg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alom~youtube-shorts-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alom-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/alom~youtube-shorts-scraper/runs": {
"post": {
"operationId": "runs-sync-alom-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/alom~youtube-shorts-scraper/run-sync": {
"post": {
"operationId": "run-sync-alom-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": {
"startUrls": {
"title": "Channels",
"type": "array",
"description": "Channel URLs (youtube.com/@MrBeast, /channel/UC…): their Shorts tab. Single Shorts URLs (/shorts/…) work too.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"channels": {
"title": "Channel names (optional)",
"type": "array",
"description": "Handles with or without @ (e.g. nasa, @mkbhd). Same as putting the channel URL above.",
"items": {
"type": "string"
}
},
"searchQueries": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to search Shorts for (YouTube's search with Type = Shorts).",
"items": {
"type": "string"
}
},
"maxResultsShorts": {
"title": "Max Shorts per channel or keyword",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "YouTube's Shorts search ends after a few hundred results per keyword.",
"default": 50
},
"sortVideosBy": {
"title": "Order (channels)",
"enum": [
"NEWEST",
"POPULAR"
],
"type": "string",
"description": "The sort buttons on a channel's Shorts tab.",
"default": "NEWEST"
},
"includeVideoDetails": {
"title": "Add likes, date and duration",
"type": "boolean",
"description": "Shorts tiles show only the title and rounded views. This opens every Short to add exact views, likes, comment count, upload time, duration, description and hashtags. About 2 extra requests per Short; the price per row stays the same.",
"default": false
},
"onlyNewSinceLastRun": {
"title": "Only new Shorts since my last run",
"type": "boolean",
"description": "Skip Shorts that an earlier run with the same Monitoring name already returned (they are not charged). Schedule the run for daily or weekly monitoring.",
"default": false
},
"monitorName": {
"title": "Monitoring name",
"type": "string",
"description": "Any name, e.g. competitors-weekly. Runs with the same name share their memory. Defaults to default."
},
"maxConcurrency": {
"title": "Parallel inputs",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many URLs are processed at the same time.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "The default (Apify datacenter proxy) works for YouTube and is included in the price. If YouTube starts blocking it, the run switches to residential proxies on its own and says so in the log.",
"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
},
"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
}
}
}
}
}
}
}
}
}
}