{ "openapi": "3.0.1", "info": { "title": "YouTube Playlist Scraper: Videos & Metadata", "description": "YouTube playlist scraper: paste playlist links or search words, get every video with its true position, views, exact likes, comments, publish time, duration, tags and channel, plus the playlist's title, owner, counts and last update. Deleted videos are listed, never charged. No login.", "version": "0.1", "x-build-id": "QITGvyUvtQmWxgPS6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deepmine~youtube-playlist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deepmine-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/deepmine~youtube-playlist-scraper/runs": { "post": { "operationId": "runs-sync-deepmine-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/deepmine~youtube-playlist-scraper/run-sync": { "post": { "operationId": "run-sync-deepmine-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 links or IDs", "type": "array", "description": "Playlists to read, one per line: playlist links (youtube.com/playlist?list=...), watch links with &list=..., music.youtube.com and mobile links, bare playlist IDs (PL..., UU... channel uploads, OLAK5uy_... albums), podcasts and courses. A channel link (youtube.com/@name) reads that channel's playlists. Mixes and personal lists (Watch later, Liked videos) aren't public and are skipped.", "items": { "type": "string" } }, "searchQueries": { "title": "🔍 Find playlists by search words", "type": "array", "description": "Words to search YouTube's playlists for (its Playlists filter), one search per line: courses, podcasts and playlists come back in YouTube's order, and each one is read like a link above.", "items": { "type": "string" } }, "maxVideosPerPlaylist": { "title": "Max videos per playlist", "minimum": 0, "maximum": 100000, "type": "integer", "description": "The first N available videos of each playlist, in playlist order. Leave empty for every video. Deleted and private entries don't count." }, "maxPlaylists": { "title": "Max playlists per search or channel", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many playlists each search (or channel link) reads, in YouTube's order.", "default": 10 }, "includeVideoDetails": { "title": "Full video details", "type": "boolean", "description": "On: every video's exact likes, comments, description, tags, category, exact publish time and channel stats (one read per video). Off: only what the playlist page shows (position, title, duration, approximate views, relative age, channel), much faster for very large playlists. Same price per video.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxy works for every call; there's no need to change it.", "default": { "useApifyProxy": true } }, "maxItems": { "title": "Max videos in total (other Actors' inputs)", "type": "integer", "description": "At most this many videos in the whole run, in input order (maxItems)." } } }, "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 } } } } } } } } } }