{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper - Captions + AI + Translation", "description": "Extract YouTube transcripts by video, channel, from captions or AI when none exist. Multi-format output: JSON, SRT, VTT, plain text, LLM-ready. Optional DeepL translation into 30+ languages. Videos, channels - pay only for successful transcripts.", "version": "0.1", "x-build-id": "WY5qE69Q5zGLjbTZD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mof1re~youtube-transcript-scraper-ai-translatiton/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mof1re-youtube-transcript-scraper-ai-translatiton", "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/mof1re~youtube-transcript-scraper-ai-translatiton/runs": { "post": { "operationId": "runs-sync-mof1re-youtube-transcript-scraper-ai-translatiton", "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/mof1re~youtube-transcript-scraper-ai-translatiton/run-sync": { "post": { "operationId": "run-sync-mof1re-youtube-transcript-scraper-ai-translatiton", "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": { "videoIds": { "title": "📹 Videos", "type": "array", "description": "YouTube videos to get transcripts from — paste full URLs or plain video IDs, any mix is fine. Ignored if Channel mode is enabled.", "items": { "type": "string" } }, "channelMode": { "title": "📡 Channel/Playlist mode", "type": "boolean", "description": "Get transcripts from a playlist/channel's videos instead of a manual video list.", "default": false }, "channelUrl": { "title": "🔗 Channel", "type": "string", "description": "YouTube channel or playlist — paste the full channel/playlist URL (e.g. https://www.youtube.com/@sixtx6792/videos)." }, "channelVideoCount": { "title": "🔢 Number of videos from channel/playlist", "type": "integer", "description": "How many of the channel's/playlist latest videos to process.", "default": 10 }, "languages": { "title": "🌐 Transcript languages (priority order)", "uniqueItems": true, "type": "array", "description": "Languages to look for, in priority order. Leave empty to use the video's default available transcript.", "items": { "type": "string", "enum": [ "af", "am", "ar", "as", "az", "ba", "be", "bg", "bn", "bo", "br", "bs", "ca", "cs", "cy", "da", "de", "el", "en", "es", "et", "eu", "fa", "fi", "fo", "fr", "gl", "gu", "ha", "haw", "he", "hi", "hr", "ht", "hu", "hy", "id", "is", "it", "ja", "jw", "ka", "kk", "km", "kn", "ko", "la", "lb", "ln", "lo", "lt", "lv", "mg", "mi", "mk", "ml", "mn", "mr", "ms", "mt", "my", "ne", "nl", "nn", "no", "oc", "pa", "pl", "ps", "pt", "ro", "ru", "sa", "sd", "si", "sk", "sl", "sn", "so", "sq", "sr", "su", "sv", "sw", "ta", "te", "tg", "th", "tl", "tr", "tt", "uk", "ur", "uz", "vi", "yi", "yo", "yue", "zh" ], "enumTitles": [ "Afrikaans", "Amharic", "Arabic", "Assamese", "Azerbaijani", "Bashkir", "Belarusian", "Bulgarian", "Bengali", "Tibetan", "Breton", "Bosnian", "Catalan", "Czech", "Welsh", "Danish", "German", "Greek", "English", "Spanish", "Estonian", "Basque", "Persian", "Finnish", "Faroese", "French", "Galician", "Gujarati", "Hausa", "Hawaiian", "Hebrew", "Hindi", "Croatian", "Haitian Creole", "Hungarian", "Armenian", "Indonesian", "Icelandic", "Italian", "Japanese", "Javanese", "Georgian", "Kazakh", "Khmer", "Kannada", "Korean", "Latin", "Luxembourgish", "Lingala", "Lao", "Lithuanian", "Latvian", "Malagasy", "Maori", "Macedonian", "Malayalam", "Mongolian", "Marathi", "Malay", "Maltese", "Burmese", "Nepali", "Dutch", "Norwegian Nynorsk", "Norwegian", "Occitan", "Punjabi", "Polish", "Pashto", "Portuguese", "Romanian", "Russian", "Sanskrit", "Sindhi", "Sinhala", "Slovak", "Slovenian", "Shona", "Somali", "Albanian", "Serbian", "Sundanese", "Swedish", "Swahili", "Tamil", "Telugu", "Tajik", "Thai", "Tagalog", "Turkish", "Tatar", "Ukrainian", "Urdu", "Uzbek", "Vietnamese", "Yiddish", "Yoruba", "Cantonese", "Chinese" ] }, "default": [] }, "transcriptType": { "title": "📝 Transcript type", "enum": [ "auto_detect", "manual", "auto" ], "type": "string", "description": "Which transcript type to look for. Leave as Auto-detect to try manual first, then auto-generated.", "default": "auto_detect" }, "fallbackToAuto": { "title": "↩️ Fallback to auto-generated", "type": "boolean", "description": "If Manual only is selected above and no manual transcript is found, fall back to auto-generated.", "default": false }, "useAiFallback": { "title": "🤖 Use AI transcription fallback", "type": "boolean", "description": "If no transcript exists at all, transcribe the video's audio using AI (Whisper). Not available on the free tier.", "default": false }, "maxMinutes": { "title": "✂️ Max minutes to transcribe", "type": "integer", "description": "Limit AI transcription to the first N minutes of the video. Set to 0 to process the full video.", "default": 0 }, "skipAiIfLongerThanMinutes": { "title": "⏭️ Skip AI if video longer than (minutes)", "type": "integer", "description": "Skip AI transcription entirely for videos longer than this many minutes. Set to 0 for no limit.", "default": 0 }, "translationRequired": { "title": "🌍 Translate transcript", "type": "boolean", "description": "Translate the resulting transcript using DeepL. Not available on the free tier.", "default": false }, "translateTo": { "title": "🔤 Translate to", "enum": [ "Arabic", "Bulgarian", "Czech", "Danish", "German", "Greek", "English (British)", "English (American)", "Spanish", "Estonian", "Finnish", "French", "Hungarian", "Indonesian", "Italian", "Japanese", "Korean", "Lithuanian", "Latvian", "Norwegian (Bokmål)", "Dutch", "Polish", "Portuguese (Brazilian)", "Portuguese (European)", "Romanian", "Russian", "Slovak", "Slovenian", "Swedish", "Turkish", "Ukrainian", "Chinese (Simplified)" ], "type": "string", "description": "Target language for translation.", "default": "English (American)" } } }, "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 } } } } } } } } } }