{ "openapi": "3.0.1", "info": { "title": "Youtube Video Transcript Translator", "description": "YouTube Video Transcript Translator extracts subtitles from YouTube videos and translates them into any supported language using lingo.dev. Ideal for learners, educators, and platforms that need multilingual access to video content at scale.", "version": "0.0", "x-build-id": "o3c5FnbQCaT1dJs0U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chrisdev_6278~youtube-video-transcript-translator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chrisdev_6278-youtube-video-transcript-translator", "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/chrisdev_6278~youtube-video-transcript-translator/runs": { "post": { "operationId": "runs-sync-chrisdev_6278-youtube-video-transcript-translator", "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/chrisdev_6278~youtube-video-transcript-translator/run-sync": { "post": { "operationId": "run-sync-chrisdev_6278-youtube-video-transcript-translator", "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": [ "youtubeVideoUrls", "targetLocale", "LINGODOTDEV_API_KEY" ], "properties": { "youtubeVideoUrls": { "title": "YouTube video URLs", "minItems": 1, "type": "array", "description": "Add one or more YouTube video URLs. Use the request list UI to add URLs. Each item is an object with a single `url` field.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "YouTube video URL", "type": "string", "description": "Full YouTube watch URL (https://www.youtube.com/watch?v=VIDEO_ID) or short youtu.be link.", "pattern": "^(https?:\\/\\/)?(www\\.)?(youtube\\.com\\/watch\\?v=|youtu\\.be\\/)[A-Za-z0-9_-]{11}(?:[&?].*)?$" } } }, "default": [ { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" } ] }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 1, "type": "integer", "description": "Maximum number of requests the crawler will make during the run. Use a lower number for quick tests and a higher number for production runs.", "default": 100 }, "sourcelocale": { "title": "Source locale (optional)", "pattern": "^[a-zA-Z]{2,3}(?:-[A-Za-z0-9-]+)*$", "type": "string", "description": "The language code of the video transcript (BCP-47). Leave blank (null) to let the Actor attempt to use the video's caption language or allow Lingo.dev to auto-detect. You can either pick from the list (searchable) or enter a custom BCP-47 locale (e.g. `en`, `en-GB`, `pt-BR`). If you enter a custom locale that Lingo.dev does not support, translation will fail — your run will receive a clear error." }, "targetLocale": { "title": "Target locale (required)", "pattern": "^[a-zA-Z]{2,3}(?:-[A-Za-z0-9-]+)*$", "type": "string", "description": "The target language (BCP-47) you want the transcript translated to. Choose from the searchable list or enter a custom BCP-47 locale. This field is required.eg. 'es', 'pt-BR', 'fr'", "default": "en" }, "LINGODOTDEV_API_KEY": { "title": "Lingo.dev API key", "type": "string", "description": "Your Lingo.dev API key. This is a secret and will be hidden in the UI. eg. api_xxxxxx" } } }, "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 } } } } } } } } } }