{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript & Subtitles Scraper API", "description": "Get full YouTube transcripts with timestamps and chapters, plus SRT, VTT and TXT subtitle files. Works for videos, Shorts, playlists, channels and search phrases. Language choice, no login or cookies. Bulk input, auto proxy. Export JSON, CSV or Excel.", "version": "1.0", "x-build-id": "iQste2nEXDf47HcT5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_minds~youtube-transcript-subtitles-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_minds-youtube-transcript-subtitles-scraper-api", "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/data_minds~youtube-transcript-subtitles-scraper-api/runs": { "post": { "operationId": "runs-sync-data_minds-youtube-transcript-subtitles-scraper-api", "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/data_minds~youtube-transcript-subtitles-scraper-api/run-sync": { "post": { "operationId": "run-sync-data_minds-youtube-transcript-subtitles-scraper-api", "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": [ "urls" ], "properties": { "urls": { "title": "🔗 YouTube links or search phrases", "minItems": 1, "type": "array", "description": "Video, Shorts, playlist or channel links, @handles, channel IDs or plain search phrases. Add as many as you like; channels, playlists and searches expand into their videos.", "items": { "type": "string" } }, "maxItems": { "title": "🔢 Max videos per input", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum videos to transcribe per input URL. Each channel, playlist or search gets up to this many videos independently.", "default": 10 }, "languages": { "title": "🌍 Transcript languages", "type": "array", "description": "Languages in priority order. The first available language is used. If none matches, the closest track is returned (flagged by language_matched).", "items": { "type": "string", "enum": [ "en", "es", "pt", "fr", "de", "it", "ja", "ko", "zh-Hans", "zh-Hant", "ar", "hi", "bn", "ru", "tr", "pl", "nl", "sv", "no", "da", "id", "ms", "th", "vi", "tl", "fi", "uk", "cs", "ro", "hu", "el" ], "enumTitles": [ "English", "Spanish", "Portuguese", "French", "German", "Italian", "Japanese", "Korean", "Chinese (Simplified)", "Chinese (Traditional)", "Arabic", "Hindi", "Bengali", "Russian", "Turkish", "Polish", "Dutch", "Swedish", "Norwegian", "Danish", "Indonesian", "Malay", "Thai", "Vietnamese", "Filipino", "Finnish", "Ukrainian", "Czech", "Romanian", "Hungarian", "Greek" ] }, "default": [ "en" ] }, "includeMetadata": { "title": "✅ Include video details", "type": "boolean", "description": "Add likes, comments, subscribers, upload date, category, tags, links and chapters with their own transcript text.", "default": true }, "subtitleFormats": { "title": "📦 Subtitle files", "type": "array", "description": "Ready-to-save subtitle files added to every video.", "items": { "type": "string", "enum": [ "srt", "vtt", "txt" ], "enumTitles": [ "SRT subtitles", "WebVTT subtitles", "Plain text" ] }, "default": [ "srt" ] }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Optional proxy settings. Leave the default unless you need a specific setup." } } }, "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 } } } } } } } } } }