{ "openapi": "3.0.1", "info": { "title": "YouTube Shorts & Channel Scraper: Videos, Subs, About", "description": "YouTube Shorts scraper and channel video scraper: every video, Short and live stream of a channel with views, duration and date, plus the About tab (subscribers, country, links). By URL, @handle or ID. No login, no API key.", "version": "0.1", "x-build-id": "7NnH7Zd1WStUcccMI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-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/datagleaner~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-datagleaner-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/datagleaner~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-datagleaner-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", "properties": { "channelUrls": { "title": "Channel URLs", "type": "array", "description": "YouTube channel URLs such as `https://www.youtube.com/@MrBeast`, `https://www.youtube.com/channel/UC...` or older `/c/` and `/user/` links. @handles and `UC...` IDs also work here.", "items": { "type": "string" } }, "handles": { "title": "Channel handles", "type": "array", "description": "Handles with or without the @, e.g. `@MrBeast` or `MrBeast`. Use this or the URL field, whichever your list has.", "items": { "type": "string" } }, "channelIds": { "title": "Channel IDs", "type": "array", "description": "Channel IDs that start with `UC` and are 24 characters long, e.g. `UCBJycsmduvYEL83R_U4JriQ`.", "items": { "type": "string" } }, "tabs": { "title": "What to scrape", "type": "array", "description": "Which parts of each channel to read: regular videos, Shorts, live streams (past and current). Pick one or several; `maxVideosPerChannel` applies to each. The channel's About facts come from `includeAbout`, not from this list. Leave the list empty with `includeAbout` on to get channel rows only (subscribers, views, country, links).", "items": { "type": "string", "enum": [ "videos", "shorts", "streams" ], "enumTitles": [ "Videos", "Shorts", "Live streams" ] }, "default": [ "videos" ] }, "maxVideosPerChannel": { "title": "Max rows per channel and tab", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stops after this many videos for each channel and each selected tab (so 2 tabs and 50 give up to 100 rows per channel). The list is read newest first unless you change `sortBy`. Each row is billed once.", "default": 50 }, "sortBy": { "title": "Sort order", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "The order YouTube's own sort buttons give: Latest, Popular or Oldest. Use newest to monitor a channel, popular for its best content.", "default": "newest" }, "includeAbout": { "title": "Include the channel About row", "type": "boolean", "description": "Adds one channel row per channel: subscribers, total views, video count, country, join date, description, links and avatar. It is billed as one channel row. Turn off if you only want the videos.", "default": true }, "includeVideoDetails": { "title": "Add exact views, date, likes and description", "type": "boolean", "description": "One extra request per video fills in the exact view count, the exact publish date, the like count and the full description. Without it, view counts are rounded as YouTube shows them on the channel page (`1.2M`) and dates are approximate (`3 weeks ago`). Billed at the higher video-details price for each row that was filled in.", "default": false }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Requests in flight at once. Keep it low; the default is polite to YouTube and fast enough.", "default": 4 }, "requestDelaySecs": { "title": "Pause between requests (seconds)", "minimum": 0, "maximum": 10, "type": "number", "description": "Minimum spacing between requests across the whole run, with random jitter. Raise it if you run many channels and see rate-limit warnings in the log.", "default": 0.25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The Actor works without a proxy. Turn on Apify Proxy only if YouTube rate-limits your run." } } }, "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 } } } } } } } } } }