{ "openapi": "3.0.1", "info": { "title": "YouTube Playlist Scraper — Videos, Views & Channel Playlists", "description": "Scrape any public YouTube playlist, or every playlist of a channel: playlist title, owner, video count, views and last update, plus each video with its position, title, channel, views, date, duration and thumbnail. No API key, no login.", "version": "0.1", "x-build-id": "sSrXeVkdGmSdbaqHY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fabrikit~youtube-playlist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fabrikit-youtube-playlist-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/fabrikit~youtube-playlist-scraper/runs": { "post": { "operationId": "runs-sync-fabrikit-youtube-playlist-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/fabrikit~youtube-playlist-scraper/run-sync": { "post": { "operationId": "run-sync-fabrikit-youtube-playlist-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": { "playlistUrls": { "title": "Playlist URLs or IDs", "type": "array", "description": "One playlist per entry: a playlist page (https://www.youtube.com/playlist?list=PL...), a video link that carries &list=..., or the bare list id (PL..., UU... for a channel's uploads, OLAK5uy_... for albums). Mixes (RD...) and private lists (WL, LL) cannot be read.", "items": { "type": "string" } }, "channelUrls": { "title": "Channels (all their public playlists)", "type": "array", "description": "Channels whose Playlists tab you want to read: a handle (@NASA), a channel URL (https://www.youtube.com/@NASA/playlists, /channel/UC..., /c/..., /user/...) or a channel id (UC...). Every playlist found is then scraped like a pasted playlist.", "items": { "type": "string" } }, "playlistsOnly": { "title": "Playlists only (no videos)", "type": "boolean", "description": "On: one row per playlist with its title, owner, video count, views, last update, description and cover, and no video rows. Useful to inventory a channel's playlists. Off (default): one row per video, each row carrying the playlist's metadata too.", "default": false }, "maxItems": { "title": "Max rows (total)", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many rows across all playlists and channels. You pay only for the rows that are saved.", "default": 1000 }, "maxVideosPerPlaylist": { "title": "Max videos per playlist", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Optional cap for each playlist, so one huge list (a channel's uploads, for example) does not use the whole budget. Playlists are read 100 videos per request. Leave empty for no per-playlist cap." }, "maxPlaylistsPerChannel": { "title": "Max playlists per channel", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many playlists to take from each channel in \"Channels\" (30 are listed per request).", "default": 50 }, "channelPlaylistsSort": { "title": "Channel playlists order", "enum": [ "newest", "lastVideoAdded" ], "type": "string", "description": "Order of a channel's Playlists tab, the same two options YouTube offers: by date the playlist was created (newest first) or by the date a video was last added.", "default": "newest" }, "language": { "title": "Interface language", "type": "string", "description": "YouTube interface language sent with the requests (en, es, pt, de...). Keep \"en\": view counts, relative dates and the \"last updated\" text are parsed from English.", "default": "en" }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code sent with the requests (US, GB, DE, MX, BR, IN...). Playlist contents do not change by region; it also sets the country of the residential fallback proxy.", "default": "US" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy is enough in normal runs. If YouTube blocks it twice in a row (HTTP 403/429 or a consent page), the Actor switches to RESIDENTIAL proxy by itself for the rest of the run.", "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 } } } } } } } } } }