{ "openapi": "3.0.1", "info": { "title": "Youtube Channel Videos Details Scraper", "description": "Extract granular data on every video, from rich thumbnails to detailed view counts, empowering data-driven decisions for content creation, audience engagement and channel growth. Whether you're a seasoned YouTuber, a digital marketer, or an AI researcher, unlock the insights you need to thrive in...", "version": "0.0", "x-build-id": "liyV9USsSKSVBU66F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~youtube-channel-video-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-youtube-channel-video-details-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/memo23~youtube-channel-video-details-scraper/runs": { "post": { "operationId": "runs-sync-memo23-youtube-channel-video-details-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/memo23~youtube-channel-video-details-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-youtube-channel-video-details-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "URLs to start with.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max videos per channel", "minimum": 0, "type": "integer", "description": "Maximum number of rows to take from the Videos tab of each channel. Counted per channel, so three start URLs at 100 return up to 300 rows. 0 takes nothing from the Videos tab, which is how you ask for shorts or streams only; there is no \"unlimited\" value, so set a high number to take a whole tab. A start URL pointing straight at /shorts or /streams is capped by this field too, unless that tab's own cap below is above 0. Free-plan runs are held to the first start URL and 10 rows shared across the three caps, whatever is set here.", "default": 100 }, "maxResultsShorts": { "title": "Max shorts per channel", "minimum": 0, "type": "integer", "description": "Rows to take from the channel's Shorts tab, on top of maxItems. 0 skips the tab entirely and costs no request. Above 0 it also caps a start URL that points straight at /shorts. A short card carries no publish date anywhere in YouTube's payload, so Oldest post date does not apply to these rows.", "default": 0 }, "maxResultsStreams": { "title": "Max live streams per channel", "minimum": 0, "type": "integer", "description": "Rows to take from the channel's Live tab (past streams, plus anything live right now), on top of maxItems. 0 skips the tab entirely and costs no request. Above 0 it also caps a start URL that points straight at /streams. A stream that is live right now has no publish date yet, so Oldest post date always keeps it.", "default": 0 }, "oldestPostDate": { "title": "Oldest post date", "pattern": "^$|^[0-9]{4}[-/][0-9]{1,2}[-/][0-9]{1,2}([T ][0-9:.+Zz-]*)?$|^ *[0-9]+ *([Ss]|[Ss]ec|[Ss]econd|[Mm]|[Mm]in|[Mm]inute|[Hh]|[Hh]r|[Hh]our|[Dd]|[Dd]ay|[Ww]|[Ww]k|[Ww]eek|[Mm]o|[Mm]onth|[Yy]|[Yy]r|[Yy]ear)[Ss]? *([Aa][Gg][Oo])? *$", "type": "string", "description": "Only return videos published on or after this date. Takes an ISO date (2026-01-01) or a span (\"3 months\", \"90 days\"); leave empty for no filter. A grid card only carries a relative age (\"1 year ago\"), so hours, days and weeks are exact while months and years are read as the newest day in that bucket, which keeps borderline videos rather than dropping them. A row YouTube ships with no age at all — a short, a stream that is live right now, an upcoming premiere — has no date to compare and is always kept.", "default": "" }, "sortVideosBy": { "title": "Sort videos by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "The order YouTube itself returns the feed in, using the channel's own sort chips. Applies to the Shorts and Live tabs as well. Only Newest lets a run with Oldest post date stop as soon as it passes the cutoff; the other two carry no usable date order, so they filter the feed row by row and give up after a run of pages that match nothing — which on a large channel can end the scan before it reaches the matches. Pair Oldest post date with Newest.", "default": "newest" }, "maxConcurrency": { "title": "Max Concurrency", "type": "integer", "description": "Maximum number of pages that can be processed at the same time.", "default": 10 }, "minConcurrency": { "title": "Min Concurrency", "type": "integer", "description": "Minimum number of pages that will be processed at the same time.", "default": 1 }, "maxRequestRetries": { "title": "Max Request Retries", "type": "integer", "description": "Number of times the crawler will retry a failed request before giving up.", "default": 3 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." } } }, "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 } } }, "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 } } } } } } } } } }