{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript & Subtitles Scraper API", "description": "Scrape YouTube transcripts, subtitles and captions in bulk from videos, Shorts, channels and playlists. Clean text plus timestamps. Works from MCP clients such as Claude, Cursor and ChatGPT. No YouTube API key. $3 per 1,000 transcripts; videos with no captions are free.", "version": "0.1", "x-build-id": "bFccebazDFIREP89b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ryumoon-data~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ryumoon-data-youtube-transcript-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/ryumoon-data~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-ryumoon-data-youtube-transcript-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/ryumoon-data~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-ryumoon-data-youtube-transcript-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": { "videoUrls": { "title": "Video URLs or IDs", "type": "array", "description": "YouTube video links or 11-character video IDs. Works with watch, youtu.be, Shorts, live and embed links. Bad or private links are skipped with a clear status and never fail the run.", "items": { "type": "string" } }, "channelOrPlaylistUrls": { "title": "Channel or playlist URLs (optional)", "type": "array", "description": "Get transcripts for the newest videos of a channel (e.g. https://www.youtube.com/@mkbhd, add /shorts or /streams for those tabs) or every video in a playlist. Use the limit below to control how many.", "items": { "type": "string" } }, "maxVideosPerChannel": { "title": "Max videos per channel or playlist", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many videos to take from each channel or playlist (newest first for channels).", "default": 20 }, "maxVideosTotal": { "title": "Max videos in total", "minimum": 0, "type": "integer", "description": "Hard cap on videos processed in this run. 0 = no cap.", "default": 0 }, "languages": { "title": "Preferred languages", "type": "array", "description": "Caption language codes in order of preference, e.g. [\"en\", \"en-GB\", \"es\"]. 'en' also matches en-US, en-GB etc. Leave empty to get the video's original language.", "items": { "type": "string" } }, "allowAutoGenerated": { "title": "Use auto-generated captions when needed", "type": "boolean", "description": "Fall back to YouTube's automatic (speech-recognition) captions when no human-made subtitles exist. Most videos only have these.", "default": true }, "preferManualCaptions": { "title": "Prefer human-made subtitles", "type": "boolean", "description": "When both exist in a language, pick the uploaded (manual) subtitles over auto-generated ones.", "default": true }, "fallbackToAnyLanguage": { "title": "Fall back to any language", "type": "boolean", "description": "If none of your preferred languages exist, return the video's original-language transcript instead of skipping it. Turn off to only get your languages.", "default": true }, "includeSegments": { "title": "Include timestamped segments", "type": "boolean", "description": "Add a 'segments' array with start, end, duration (seconds) and text for every caption line.", "default": true }, "includeTimestampedText": { "title": "Include timestamped text", "type": "boolean", "description": "Add a 'timestampedTranscript' string with one '[m:ss] text' line per caption, handy for show notes and chapters.", "default": true }, "maxConcurrency": { "title": "Parallel videos", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many videos to fetch at once.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration (optional)", "type": "object", "description": "Not needed for most runs. If YouTube blocks the request, the scraper switches to Apify residential proxies automatically, rotating IPs until one works (included in the price).", "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 } } } } } } } } } }