{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper", "description": "Get every video, Short and stream of any YouTube channel, plus channel stats: subscribers, total views, links, country. 0.80 USD per 1,000 videos, no minimum charge per run.", "version": "0.1", "x-build-id": "8xFvzzHbh7X5hIhrO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vakitek~youtube-channel-videos/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vakitek-youtube-channel-videos", "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/vakitek~youtube-channel-videos/runs": { "post": { "operationId": "runs-sync-vakitek-youtube-channel-videos", "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/vakitek~youtube-channel-videos/run-sync": { "post": { "operationId": "run-sync-vakitek-youtube-channel-videos", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Channel URLs / handles / ids", "type": "array", "description": "YouTube channel URLs (e.g. https://www.youtube.com/@mkbhd), bare handles (@mkbhd) or channel ids (UC...).", "items": { "type": "string" } }, "maxResults": { "title": "Max videos per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum number of regular videos to scrape per channel. Set to 0 to only scrape channel info (no videos).", "default": 50 }, "maxResultsShorts": { "title": "Max Shorts per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum number of Shorts to scrape per channel.", "default": 0 }, "maxResultStreams": { "title": "Max streams per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum number of live/past streams to scrape per channel.", "default": 0 }, "sortVideosBy": { "title": "Sort videos by", "enum": [ "NEWEST", "POPULAR", "OLDEST" ], "type": "string", "description": "Order in which regular videos, Shorts and streams are scraped.", "default": "NEWEST" }, "oldestPostDate": { "title": "Oldest post date", "type": "string", "description": "Stop scraping a channel's tab once its videos are older than this date. ISO date (e.g. 2026-01-01) or a relative number of days (e.g. \"30 days\"). Leave empty to only limit by count. Uses the exact publish date when includeVideoDetails is on, the approximate one otherwise. An unparseable value is a free INVALID_INPUT error item, not silently ignored." }, "includeVideoDetails": { "title": "Include video details (likes, comment count)", "type": "boolean", "description": "Adds likes and comment count to each video via one extra request per video (two when the comment count needs a second request). Comment count is null with commentsTurnedOff set to true when the creator disabled comments.", "default": false }, "language": { "title": "YouTube interface language (titles, dates)", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "Interface language (hl) requested from YouTube, as an ISO 639-1 code (e.g. fr, de, ja). Controls which language translated titles/descriptions come back in. It does NOT change the transcript or video content language, only YouTube's own UI strings.", "default": "en" }, "country": { "title": "Country", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "Geolocation (gl) requested from YouTube, as an ISO 3166-1 alpha-2 code (e.g. FR, DE, JP).", "default": "US" }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 0, "maximum": 3600, "type": "integer", "description": "Stop and return what is ready after this many seconds, so n8n/Make run-sync calls never time out. 0 = no limit.", "default": 240 } } }, "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 } } } } } } } } } }