{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper", "description": "Scrapes a YouTube channel's videos, Shorts and live streams (title, views, length, date, thumbnail, live flags) plus channel details: subscribers, total views, video count, joined date, country and links. Latest, popular or oldest first. No login or API key.", "version": "0.0", "x-build-id": "SdqB0AJyeoqBFQjax" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mina_safwat~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mina_safwat-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/mina_safwat~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-mina_safwat-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/mina_safwat~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-mina_safwat-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": "YouTube channels", "type": "array", "description": "One channel per line. Channel links (https://www.youtube.com/@NASA, /channel/UC…, /c/…, /user/… or a tab such as /@NASA/videos), bare @handles (@NASA), channel IDs (UCLA_DiR1FfKNvjuUpBHmylQ) and links to any of the channel's videos or Shorts all work, with or without https://. Links that are not channels (playlists, other sites) are listed in the FAILED_INPUTS record.", "items": { "type": "string" } }, "content_types": { "title": "What to scrape", "type": "array", "description": "Which of the channel's tabs to read. Each one gives its own rows, marked with type \"video\", \"short\" or \"live\".", "items": { "type": "string", "enum": [ "videos", "shorts", "live" ], "enumTitles": [ "Videos (the channel's Videos tab)", "Shorts (the Shorts tab)", "Live streams (the Live tab: past, live now and upcoming)" ] }, "default": [ "videos" ] }, "sort": { "title": "Sort by", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "The order YouTube lists them in, as in the Latest / Popular / Oldest buttons above a channel's videos. Together with the limit below, this picks which videos you get: the newest, the most viewed or the first ones the channel uploaded.", "default": "latest" }, "max_videos_per_channel": { "title": "Max videos per channel", "minimum": 0, "type": "integer", "description": "Stops after this many videos for each channel, counted separately for videos, Shorts and live streams. To get everything, set a large number such as 100000. Set 0 to save only the channel details.", "default": 100 }, "include_channel_details": { "title": "Save channel details", "type": "boolean", "description": "Adds one row per channel (type \"channel\") with its name, handle, description, subscriber count, total views, video count, joined date, country, links, avatar, banner and verified badge.", "default": true }, "include_video_details": { "title": "Add exact dates, likes and descriptions", "type": "boolean", "description": "Looks up each video once more to add its exact publish date and time, like count, exact view count, length, description, category and tags. Without this, dates are estimated from the age YouTube shows (\"3 weeks ago\") and Shorts have no date or length. It makes runs slower: one extra request per video.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave this empty: YouTube answers the Actor directly, and if it ever refuses, the Actor retries through Apify's proxies on its own. Choose a proxy here only to send every request through it.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }