{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper: Stats, Videos & Subscriber History", "description": "Scrape YouTube channels: subscribers, exact total views, video count, join date, country, links, upload frequency and median views, plus the channel's videos, Shorts and streams with exact views, likes and dates. Scheduled runs track subscriber and view growth. No API key.", "version": "0.1", "x-build-id": "gKXdiTJTN4hta09Ov" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-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/s_actors~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-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/s_actors~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-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", "type": "array", "description": "One per line: channel links (youtube.com/@handle, /channel/UC...), @handles, channel IDs or a link to any video of the channel. One channel row each, then its videos.", "items": { "type": "string" } }, "maxVideos": { "title": "🔢 Max videos per channel", "minimum": 0, "maximum": 20000, "type": "integer", "description": "How many videos to return per channel and content type. 0 = only the channel row (stats, links, history), the fastest and cheapest way to check many channels.", "default": 20 }, "contentType": { "title": "🎞️ Content", "enum": [ "videos", "shorts", "streams", "all" ], "type": "string", "description": "Which tab of the channel to read. All = up to Max videos of each.", "default": "videos" }, "videosSort": { "title": "↕️ Videos order", "enum": [ "newest", "popular", "oldest" ], "type": "string", "description": "As on the channel's tabs. Most popular = the channel's most viewed videos of all time.", "default": "newest" }, "newerThan": { "title": "📅 Newer than", "type": "string", "description": "Only videos published in this period, e.g. 7 days, 2 weeks, 6 months, or a date like 2026-01-01. With Newest first the scan stops at the first older video." }, "videoDetails": { "title": "🔎 Exact video stats", "type": "boolean", "description": "Open every video for its exact views, likes, comment count, exact publish date and full description. Off: the channel page data only (rounded views like 77M, relative dates), faster for thousands of videos. Same price.", "default": true }, "trackHistory": { "title": "📈 Track subscriber and view history", "type": "boolean", "description": "Remember each channel's subscribers, total views and video count on every run and add the change since the previous run (subscribersChange, totalViewsChange, viewsPerDaySinceLastCheck) and the last 30 checks (history). Schedule the task daily for a growth chart.", "default": true }, "onlyNewVideos": { "title": "🔔 Only new videos", "type": "boolean", "description": "For scheduled runs. The first run returns the latest videos and remembers them; later runs return only videos uploaded since (the channel rows with their growth still come every run).", "default": false }, "monitorName": { "title": "🏷️ Monitor name", "type": "string", "description": "Name of the memory used by Only new videos. Use a different name for each task.", "default": "default" }, "maxConcurrency": { "title": "⚡ Parallel requests", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many requests to YouTube run at the same time.", "default": 10 }, "proxyConfiguration": { "title": "🛡️ Proxy", "type": "object", "description": "Requests go direct first and switch to Apify datacenter proxies when YouTube refuses them. The default works for most runs.", "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 } } } } } } } } } }