{ "openapi": "3.0.1", "info": { "title": "YouTube Scraper: Videos, Channels, Shorts & Comments", "description": "Scrape YouTube videos, Shorts, channels, playlists and comments by search, channel, playlist or video link. Views, likes, tags, publish dates, exact limits, pay per row. No login, no API key.", "version": "0.1", "x-build-id": "MgjNkXqg0xGYnylgW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apisamurai~youtube-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apisamurai-youtube-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/apisamurai~youtube-scraper/runs": { "post": { "operationId": "runs-sync-apisamurai-youtube-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/apisamurai~youtube-scraper/run-sync": { "post": { "operationId": "run-sync-apisamurai-youtube-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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "Words to search on YouTube, one per line. Each term is its own source with its own limit.", "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "videos", "shorts", "channels", "playlists" ], "type": "string", "description": "Videos or Shorts: the results themselves. Channels or Playlists: the matching channels or playlists are opened in search order and their videos are saved until the limit.", "default": "videos" }, "uploadDate": { "title": "Upload date", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Search filter: only videos uploaded in this period.", "default": "any" }, "sortBy": { "title": "Sort search by", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "Order of search results.", "default": "relevance" }, "duration": { "title": "Video length", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Search filter for videos: short (under 4 minutes), medium (4 to 20 minutes) or long (over 20 minutes).", "default": "any" }, "channels": { "title": "Channels", "type": "array", "description": "Handles (@mkbhd), channel links (https://www.youtube.com/@mkbhd, /channel/UC...) or channel IDs (UC...). One per line.", "items": { "type": "string" } }, "channelTabs": { "title": "Channel tabs", "type": "array", "description": "Which tabs of each channel to scrape. Each channel tab is its own source with its own limit.", "items": { "type": "string", "enum": [ "videos", "shorts", "streams" ], "enumTitles": [ "Videos", "Shorts", "Live (streams)" ] }, "default": [ "videos" ] }, "playlists": { "title": "Playlists", "type": "array", "description": "Playlist links (https://www.youtube.com/playlist?list=PL...) or playlist IDs. One per line.", "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Single videos or Shorts: watch links, youtu.be links, /shorts/ links or 11-character video IDs. One per line.", "items": { "type": "string" } }, "maxResultsPerSource": { "title": "Max videos per source", "minimum": 1, "type": "integer", "description": "Exact number of videos to save per search term, channel tab or playlist. The last page is trimmed, so you never get or pay for more.", "default": 50 }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Channel tabs only: stop once videos are older than this date (2026-01-31) or this long ago (7 days, 2 weeks). Channel pages show rounded ages such as \"3 weeks ago\", so videos near the boundary are judged on that rounded age unless details are on." }, "includeDetails": { "title": "Open each video for full details", "type": "boolean", "description": "Adds the full description, exact like count, comment count, tags, category and exact publish time. Two extra requests per video, charged as an extra event only when they load.", "default": false }, "includeComments": { "title": "Scrape comments", "type": "boolean", "description": "Save comments of every video in the results as separate rows (type \"comment\").", "default": false }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 0, "type": "integer", "description": "Exact number of comment rows per video, replies included.", "default": 100 }, "commentsSort": { "title": "Comments order", "enum": [ "top", "newest" ], "type": "string", "description": "Top comments (YouTube's ranking) or newest first.", "default": "top" }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also save replies to comments. They count toward the comment limit.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is the default. If YouTube starts refusing these IPs, the run switches to residential proxies by itself.", "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 } } } } } } } } } }