{ "openapi": "3.0.1", "info": { "title": "YouTube Playlist Scraper - Publish Dates & Full Video Stats", "description": "Extract all videos from any YouTube playlist, including titles, URLs, thumbnails, durations, descriptions, and metadata. Perfect for research, content audits, SEO analysis, archiving, and dataset creation. Fast, reliable, and ideal for automating playlist data collection.", "version": "0.1", "x-build-id": "d1cb0Lg6A0DjAIjnT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~youtube-playlist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-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/scraper-engine~youtube-playlist-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-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/scraper-engine~youtube-playlist-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-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", "required": [ "playlistInputs" ], "properties": { "playlistInputs": { "title": "🎞️ Playlists / channels to scan", "minItems": 1, "type": "array", "description": "One entry per line: a playlist URL, a channel @username (first playlists), or a raw playlist ID. Every video found is enriched with watch-page stats below.", "items": { "type": "string" } }, "maxVideos": { "title": "🔢 Videos to enrich per playlist", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Cap on videos read (and stat-enriched) per playlist. 0 = every video. Each video costs one extra watch-page request when stats are on. Real ceiling is ~100 (playlist has no continuation).", "default": 10 }, "fetchVideoStats": { "title": "📊 Fetch watch-page stats", "type": "boolean", "description": "Master switch for the enrichment. ON = open each video's watch page and add publishDate, uploadDate, viewCountExact (integer), category and isLiveContent. OFF = plain playlist rows only.", "default": true }, "includeDescription": { "title": "📝 Add full video description", "type": "boolean", "description": "Include each video's complete description text (from the watch page). Requires 'Fetch watch-page stats' to be ON.", "default": true }, "includeTags": { "title": "🏷️ Add video tags (best-effort)", "type": "boolean", "description": "Include the uploader's keyword tags when present. Many creators leave these empty or YouTube strips them, so each row carries a tagsAvailable flag. Requires stats ON.", "default": false }, "includeApproxLikes": { "title": "👍 Add approximate like count", "type": "boolean", "description": "Include an approximate like count parsed from the like button. YouTube hid exact likes in 2021, so this is labelled likesAreApproximate. Requires stats ON.", "default": false }, "includeVideoDetails": { "title": "🧩 Rich base row fields", "type": "boolean", "description": "When on, each row also carries the base listing fields (thumbnail, videoInfo, durationLabel, full channel & playlist objects, extractedAt). Off = a slim base row (still enriched with the stats above).", "default": true }, "proxyConfiguration": { "title": "🛡️ Proxy routing", "type": "object", "description": "Optional. Starts direct, then auto-falls back datacenter → residential if YouTube blocks. Residential is recommended when enriching many videos." } } }, "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 } } }, "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 } } } } } } } } } }