{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper - Videos, Streams & Channel Stats", "description": "Get all videos of a YouTube channel with exact views, likes, comment count and publish date, plus live streams and channel stats: subscribers, total views, video count, country, joined date and links. By @handle or URL, no API key. $0.80 per 1,000 videos; failed inputs are free.", "version": "1.0", "x-build-id": "dyXTM0fDGMWoUEqcK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tenfoldfleet~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tenfoldfleet-youtube-channel-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/tenfoldfleet~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-tenfoldfleet-youtube-channel-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/tenfoldfleet~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-tenfoldfleet-youtube-channel-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", "required": [ "channelUrls" ], "properties": { "channelUrls": { "title": "Channels", "type": "array", "description": "YouTube channels to scrape: @handles (@MrBeast), channel URLs (https://www.youtube.com/@NASA, /channel/UC..., /c/..., /user/...) or channel IDs (UC...).", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Max videos per channel", "minimum": 0, "maximum": 100000, "type": "integer", "description": "How many videos to return from each channel's Videos tab. 0 = skip videos. Shorts are not included (see our YouTube Shorts Scraper).", "default": 50 }, "maxStreamsPerChannel": { "title": "Max live streams per channel", "minimum": 0, "maximum": 100000, "type": "integer", "description": "How many live streams (live now, upcoming and past) to return from each channel's Live tab. 0 = skip streams.", "default": 0 }, "includeChannelInfo": { "title": "Channel stats", "type": "boolean", "description": "Return one row per channel with subscribers, exact total views, exact video count, description, country, joined date, links, avatar and banner.", "default": true }, "sortBy": { "title": "Sort videos by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "Order in which videos and streams are taken from each channel, as on YouTube's Latest / Popular / Oldest buttons.", "default": "newest" }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Only videos and streams published on or after this date, e.g. 2026-09-01, or a period such as \"30 days\". With exact details on, the date is checked exactly; with them off it uses YouTube's rounded \"2 months ago\" text and can include videos up to one week, month or year older. Works best with Newest first, where the scraper stops at the cutoff." }, "fetchExactDetails": { "title": "Fetch exact views, likes, comments and date", "type": "boolean", "description": "Load each video's exact view count, like count, comment count, publish date and full description. Turn off for a faster list with rounded views (\"207M views\") and relative dates (\"6 days ago\"). Same price either way.", "default": true }, "maxItems": { "title": "Max results in total", "minimum": 0, "type": "integer", "description": "Stop after this many results (videos, streams and channel rows) across all channels. 0 = no limit (the run's max cost still applies).", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy works for YouTube. Channel pages retry through residential proxy only if the datacenter IPs are blocked, so there is no need to pick residential.", "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 } } } } } } } } } }