{ "openapi": "3.0.1", "info": { "title": "YouTube Channel Scraper - Videos, Shorts, Views & Likes", "description": "Scrape YouTube channels, playlists and videos: subscribers, total views, join date, country, links, plus each video's views, likes, publish date, duration, tags and description. Videos, Shorts and live tabs. No login, no proxy needed. From $1 per 1,000 videos; failed items are free.", "version": "0.1", "x-build-id": "iCaqswx5drynJcdvK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidytools~youtube-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidytools-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/tidytools~youtube-channel-scraper/runs": { "post": { "operationId": "runs-sync-tidytools-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/tidytools~youtube-channel-scraper/run-sync": { "post": { "operationId": "run-sync-tidytools-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": [ "urls" ], "properties": { "urls": { "title": "Channels, playlists or videos", "type": "array", "description": "One per line: a channel (https://www.youtube.com/@mkbhd, @mkbhd, a /channel/UC... URL or channel ID), a playlist URL, or a video (watch, youtu.be or Shorts URL, or an 11-character video ID). Spaces, commas and semicolons also separate entries; pasted quotes and brackets are removed. Up to 1,000 per run. Entries that are not YouTube channels, playlists or videos (for example a name without @) become a free row with errorType \"invalid_input\".", "items": { "type": "string" } }, "tabs": { "title": "Channel tabs", "type": "array", "description": "Which lists to read for each channel (newest first). Ignored for playlists and single videos.", "items": { "type": "string", "enum": [ "videos", "shorts", "streams" ], "enumTitles": [ "Videos", "Shorts", "Live streams" ] }, "default": [ "videos" ] }, "maxVideos": { "title": "Videos per channel tab or playlist", "minimum": 0, "maximum": 100, "type": "integer", "description": "The newest N videos of each channel tab or playlist (0 = channel info only). YouTube's public pages show at most 100; more would need YouTube's internal API, which robots.txt disallows, so we do not use it.", "default": 30 }, "videoDetails": { "title": "Full video details", "type": "boolean", "description": "Off: each video comes from the channel or playlist list (title, views rounded as YouTube shows them, e.g. 4.1M, duration, age such as \"3 days ago\"; $1 per 1,000). On: each video's page is read too, adding exact views, likes, publish date and time, category, tags, hashtags, chapters, full description, caption languages and live status ($2 per 1,000, charged instead). Video links in the input always get full details.", "default": false }, "includeChannelInfo": { "title": "Channel info row", "type": "boolean", "description": "One row per channel: subscribers, total views, video count, join date, country, description, external links, keywords, avatar and banner ($2 per 1,000 channels).", "default": true }, "publishedAfter": { "title": "Only videos published after (optional)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}.*$|^\\d+\\s*(day|week|month|year)s?$", "type": "string", "description": "A date (2026-09-01) or a period (7 days, 2 weeks, 3 months). In list mode YouTube shows only an age such as \"2 weeks ago\", so the cut-off is approximate; with full details (and for Shorts, whose lists show no age) it uses the exact publish date. Older videos are skipped and free." }, "onlyNewVideos": { "title": "Only videos not returned before (monitoring)", "type": "boolean", "description": "For scheduled runs: return (and charge) only videos that earlier runs with the same monitor name did not see, and each channel info row only once. The first run returns everything and saves the baseline.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate monitors keep separate memories (letters, digits and dashes). Only used with monitoring on.", "default": "default" }, "maxResults": { "title": "Max videos per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The run stops after this many video rows (channel rows are not counted). A cost cap on top of Apify's maximum charge per run.", "default": 1000 }, "httpVia": { "title": "Plain HTTP requests from", "enum": [ "auto", "direct", "backend" ], "type": "string", "description": "Every request uses our own user agent and follows youtube.com/robots.txt, with no cookies, login or browser. If YouTube refuses one network (consent page, bot check, HTTP 429), Auto retries the page from our servers.", "default": "auto" }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Only used for requests sent from Apify's network. Apify proxy usage is billed to your Apify account." }, "maxConcurrency": { "title": "Pages in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many YouTube pages are read at the same time.", "default": 5 } } }, "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 } } } } } } } } } }