{
"openapi": "3.0.1",
"info": {
"title": "YouTube Shorts Scraper: YouTube Shorts Views & Data",
"description": "Scrape YouTube Shorts from any channel: exact views, likes, comment count, publish date, duration, description and hashtags, plus the channel's subscribers and stats on every row. Newest or popular first, with a date cut-off. Export JSON, CSV or Excel. No API key, no login.",
"version": "0.1",
"x-build-id": "9B8cwdjoq6dhHc9so"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/xmolodtsov~youtube-shorts-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-xmolodtsov-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/xmolodtsov~youtube-shorts-scraper/runs": {
"post": {
"operationId": "runs-sync-xmolodtsov-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/xmolodtsov~youtube-shorts-scraper/run-sync": {
"post": {
"operationId": "run-sync-xmolodtsov-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": "YouTube channels whose Shorts you want. Each line can be a channel URL (https://www.youtube.com/@nasa, /channel/UC…, /c/…, /user/…; a /shorts suffix is fine), an @handle, a username without the @ sign, or a channel ID (UC…).",
"items": {
"type": "string"
}
},
"maxResultsShorts": {
"title": "Maximum Shorts per channel",
"minimum": 1,
"maximum": 999999,
"type": "integer",
"description": "Stop after this many Shorts from each channel. On the free Apify plan a run returns at most 10 Shorts in total.",
"default": 50
},
"sortChannelShortsBy": {
"title": "Sort Shorts by",
"enum": [
"NEWEST",
"POPULAR",
"OLDEST"
],
"type": "string",
"description": "The same three buttons as on the channel's Shorts tab: Newest (Latest), Popular or Oldest. With \"oldestPostDate\" set, Shorts are always read newest first.",
"default": "NEWEST"
},
"oldestPostDate": {
"title": "Only Shorts published on or after",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^(\\d+)\\s*(minute|hour|day|week|month|year)s?$",
"type": "string",
"description": "Optional. A date (2025-06-03) or an age: 1 day keeps only today's Shorts (UTC), 2 days yesterday's and today's, and so on (also minutes, hours, weeks, months, years). The Actor stops reading a channel at its first older Short. With \"includeDuration\" off, only YouTube's US-Pacific publish day is known, so Shorts up to one day older than this date can be included."
},
"includeDuration": {
"title": "Include duration and exact publish time",
"type": "boolean",
"description": "On: one extra lookup per Short adds duration (HH:MM:SS), durationSeconds and the exact publish timestamp in date. YouTube only answers this lookup from residential IPs, so it always goes through Apify's residential proxy (or your own proxies). Off: date is YouTube's publish day in US Pacific time (2025-06-03), not the UTC day, and duration stays empty. The price per result is the same either way.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. By default the Actor uses Apify's datacenter proxy for listing and detail calls (0 blocks in 4,478 measured requests). Pick RESIDENTIAL to send every request through residential IPs, or add your own proxy URLs to use them for all requests.",
"default": {
"useApifyProxy": true
}
},
"startUrls": {
"title": "Channel URLs (alternative input)",
"type": "array",
"description": "Optional alternative to \"Channels\" for inputs copied from other YouTube scrapers: a list of channel URLs. When set, it is used instead of \"Channels\".",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}