{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Videos Scraper - Exact Views, $0.50/1K", "description": "YouTube channel scraper: up to 5,000 videos, 2,000 Shorts and 1,000 live streams per channel, newest, popular or oldest first, with exact views, likes, comment counts, dates and channel info. No API key. API and MCP. $0.50 per 1,000 videos.", "version": "0.1", "x-build-id": "dxQEwR4aIle80VGml" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/om_kh~youtube-channel-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-om_kh-youtube-channel-videos-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/om_kh~youtube-channel-videos-scraper/runs": { "post": { "operationId": "runs-sync-om_kh-youtube-channel-videos-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/om_kh~youtube-channel-videos-scraper/run-sync": { "post": { "operationId": "run-sync-om_kh-youtube-channel-videos-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": { "channels": { "title": "YouTube channel handles to track", "type": "array", "description": "YouTube channel handles (@name), channel URLs or channel IDs to scrape the latest videos from.", "default": [], "items": { "type": "string" } }, "maxVideos": { "title": "Max videos per channel", "minimum": 0, "maximum": 5000, "type": "integer", "description": "How many videos to return per channel (0 to 5,000). Default 30. Use 0 to get only Shorts or live streams.", "default": 30 }, "maxShorts": { "title": "Max Shorts per channel", "minimum": 0, "maximum": 2000, "type": "integer", "description": "How many Shorts to return per channel (0 to 2,000). Default 0.", "default": 0 }, "maxStreams": { "title": "Max live streams per channel", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many live streams (past and current) to return per channel (0 to 1,000). Default 0.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "YouTube's own order on the channel page, applied to videos, Shorts and live streams.", "default": "newest" }, "oldestVideoDate": { "title": "Oldest video date (optional)", "type": "string", "description": "YYYY-MM-DD. Keep only what was published on or after this day. With Newest first the read stops there." }, "includeChannelInfo": { "title": "Include channel info", "type": "boolean", "description": "Add the channel's profile to every row: description, links, country, join date, subscribers, total views, video count, avatar, banner and verified badge.", "default": false }, "currentVideos": { "title": "Bring your own videos (optional)", "type": "array", "description": "Optional: pass video data you already have instead of fetching it from YouTube.", "default": [] }, "previousVideos": { "title": "Previous videos (non-monitor mode)", "type": "array", "description": "Videos from the prior run; used to identify changes when not using persistent monitor mode.", "default": [] }, "maxTotalChargeUsd": { "title": "Maximum Vigia charge (USD)", "minimum": 0, "type": "number", "description": "Hard maximum amount that this run may charge." }, "sources": { "title": "Declared upstream sources and estimated costs", "type": "array", "description": "Declare every upstream source before this run. Each item needs name, authorization, and estimated_cost_usd.", "default": [ { "name": "YouTube channel RSS feed (first-party)", "authorization": "public_structured_data", "estimated_cost_usd": 0 } ] }, "monitorEnabled": { "title": "Monitor only changes", "type": "boolean", "description": "The first monitored run stores a free baseline. Later runs deliver and charge only real changes.", "default": false }, "monitorId": { "title": "Monitor ID (optional)", "type": "string", "description": "Pins the persistent baseline to a name of your choice, so separate targets never share state. Leave empty to derive it automatically.", "default": "" } } }, "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 } } } } } } } } } }