{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper", "description": "Every video from any YouTube channel, newest, popular or oldest first, with the channel's subscribers, total views, country, joined date and links on every row. No login.", "version": "0.2", "x-build-id": "pTh7xjadcxhk2BV8w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sedgelabs~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sedgelabs-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/sedgelabs~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-sedgelabs-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/sedgelabs~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-sedgelabs-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": [ "channels" ], "properties": { "channels": { "title": "Channels", "maxItems": 1000, "type": "array", "description": "Channel handles (@name), channel URLs or channel IDs (UC...). Up to 1,000 per run.", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Max videos per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Stop after this many videos per channel. 0 leaves the Videos tab out.", "default": 50 }, "maxShortsPerChannel": { "title": "Max Shorts per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Also get Shorts from the channel's Shorts tab, up to this many per channel. 0, the default, leaves them out.", "default": 0 }, "maxStreamsPerChannel": { "title": "Max live streams per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Also get streams from the channel's Live tab, up to this many per channel: past streams, live ones and upcoming ones. 0, the default, leaves them out. An upcoming stream has no date yet, and shows \"7 waiting\" where views would be.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Each tab's own order, as on the channel's page.", "default": "latest" }, "includeDetails": { "title": "Exact details", "type": "boolean", "description": "Fetch each video's exact views, likes, publish date, description, keywords and category. The tabs alone show rounded views (\"27M views\") and an age (\"3 weeks ago\"), and the Shorts tab shows no date at all. One extra request per video, charged as a separate small event.", "default": false }, "oldestDate": { "title": "Videos from", "type": "string", "description": "Only videos published on or after this: a date like 2026-01-31, or an age like \"30 days\". Stops at the first older video, so you don't pay for the rest. Needs Sort by Latest. Without Exact details the date comes from the rounded age YouTube shows (\"1 year ago\"), so a few videos just past your date can come back. With Shorts, it needs Exact details on, because the Shorts tab shows no dates." }, "profileOnly": { "title": "Profiles only", "type": "boolean", "description": "Return one row per channel with its profile (name, handle, subscribers, video count, total views, joined date, country, links, description, keywords) and no videos. Max videos per channel is ignored. Max Shorts, Max live streams, Sort by, Exact details and Videos from are rejected if you change them from their defaults. Charged as its own event, once per channel.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy for the channel pages. Apify's datacenter proxy works for these. Exact details always go through Apify residential IPs at no extra proxy cost to you; YouTube refuses them from datacenter IPs.", "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 } } } } } } } } } }