{ "openapi": "3.0.1", "info": { "title": "YouTube Scraper: Channel Videos, Search Results, Playlists", "description": "Scrape YouTube channel videos, Shorts and live streams, search results (with date, duration and sort filters) and playlists. Get title, views, publish time, duration, thumbnail and channel details per video, plus optional channel stats. No login or API key.", "version": "1.0", "x-build-id": "nfsT1KhtjZa319cOR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fernandosord~youtube-channel-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fernandosord-youtube-channel-search-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/fernandosord~youtube-channel-search-scraper/runs": { "post": { "operationId": "runs-sync-fernandosord-youtube-channel-search-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/fernandosord~youtube-channel-search-scraper/run-sync": { "post": { "operationId": "run-sync-fernandosord-youtube-channel-search-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": "Channels", "type": "array", "description": "Channel URLs, @handles or channel IDs, for example @MrBeast, https://www.youtube.com/@MrBeast/videos or UCX6OQ3DkcsbYNE6H8uQQuVA. One run can mix channels, searches and playlists.", "items": { "type": "string" } }, "searchQueries": { "title": "Search terms", "type": "array", "description": "Words to search for on YouTube, one per line. A youtube.com/results?search_query=... link also works and keeps the filters from its sp= parameter.", "items": { "type": "string" } }, "playlists": { "title": "Playlists", "type": "array", "description": "Playlist URLs (youtube.com/playlist?list=...) or playlist IDs (PL...). Videos come in playlist order.", "items": { "type": "string" } }, "maxResultsPerInput": { "title": "Max results per input", "minimum": 1, "type": "integer", "description": "Stop after this many rows for each channel, search term or playlist. The optional channel info row is not counted. Set it high to get a whole channel.", "default": 20 }, "channelContentType": { "title": "Channel tab", "enum": [ "videos", "shorts", "live" ], "type": "string", "description": "Which tab of each channel to read. Shorts rows have no duration or publish time, because YouTube does not show them on that tab. Live lists current and past streams.", "default": "videos" }, "channelSort": { "title": "Channel sort order", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Order of the videos taken from each channel tab.", "default": "latest" }, "includeChannelInfo": { "title": "Add a channel info row", "type": "boolean", "description": "Adds one extra row per channel with subscribers, total videos, total views, description, links, joined date and country. It is charged like any other row.", "default": false }, "searchType": { "title": "Search result type", "enum": [ "video", "channel" ], "type": "string", "description": "Videos returns video rows. Channels returns one row per channel found (name, handle, subscribers, description).", "default": "video" }, "searchSort": { "title": "Search sort", "enum": [ "relevance", "date", "views", "rating" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "searchUploadDate": { "title": "Search: uploaded", "enum": [ "any", "hour", "today", "week", "month", "year" ], "type": "string", "description": "Only videos uploaded within this period.", "default": "any" }, "searchDuration": { "title": "Search: duration", "enum": [ "any", "short", "medium", "long" ], "type": "string", "description": "Only videos of this length. Applies to video searches.", "default": "any" }, "searchIncludeShorts": { "title": "Search: include Shorts", "type": "boolean", "description": "YouTube mixes Shorts into video search results. Turn off to keep only regular videos.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. YouTube's channel, search and playlist pages worked without a proxy in testing. If YouTube refuses your IP the run reports it and stops; then pick Apify Proxy here.", "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 } } } } } } } } } }