{ "openapi": "3.0.1", "info": { "title": "Universal Transcriber - Video, Audio & Podcast to Text", "description": "Turn any video, audio file or podcast feed into clean, timestamped text with automatic language detection.", "version": "0.1", "x-build-id": "jdo4Q2geQm4FcjmHl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maged120~universal-transcriber/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maged120-universal-transcriber", "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/maged120~universal-transcriber/runs": { "post": { "operationId": "runs-sync-maged120-universal-transcriber", "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/maged120~universal-transcriber/run-sync": { "post": { "operationId": "run-sync-maged120-universal-transcriber", "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": "URLs", "type": "array", "description": "One link per line. Video pages, direct audio/video files, podcast feeds, news and blog articles, documentation pages and PDFs all work β€” mix them freely. Each link is detected and handled automatically.", "default": [ "https://www.youtube.com/watch?v=jNQXAC9IVRw" ], "items": { "type": "string" } }, "quality": { "title": "Transcription quality", "enum": [ "fast", "balanced", "accurate" ], "type": "string", "description": "Higher quality is more accurate on difficult audio, accents and background noise, but takes longer per minute of media. Only applies when the transcript has to be generated from the audio.", "default": "balanced" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code (en, es, de, ar…). Leave empty to detect the language automatically and to take whichever published transcript the publisher offers.", "default": "" }, "usePublishedCaptions": { "title": "Use the publisher's own transcript when available", "type": "boolean", "description": "When the publisher already provides a transcript, use it: it is near-instant and much cheaper than generating one. Turn this off to always generate a fresh transcript from the audio.", "default": true }, "maxMinutesPerItem": { "title": "Max minutes per item", "minimum": 0, "type": "integer", "description": "Stop after this many minutes of each item. 0 = transcribe the whole thing. Use this to keep long recordings predictable β€” work stops at the limit, it is not just trimmed afterwards.", "default": 0 }, "maxEpisodesPerFeed": { "title": "Max episodes per feed", "minimum": 1, "type": "integer", "description": "How many of the latest episodes to take from each podcast feed.", "default": 5 }, "outputTranscripts": { "title": "Output full-transcript rows", "type": "boolean", "description": "Push one row per item holding the complete transcript text.", "default": true }, "outputSegments": { "title": "Output timestamped segment rows", "type": "boolean", "description": "Push one row per timestamped line, ready for subtitles, search and clip-finding. Turn off if you only need the full text.", "default": true }, "linkHandling": { "title": "Link handling", "enum": [ "auto", "article", "media" ], "type": "string", "description": "How to read each link. Auto detects the right mode per link and suits almost every run. Force article text when a page holds both a video and an article you want, and force transcription for a player page that is misread as an article.", "default": "auto" }, "maxCharactersPerItem": { "title": "Max characters per article", "minimum": 0, "type": "integer", "description": "Cap the text taken from each article or PDF. 0 = no limit.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for the requests. The default suits most runs. Switch to Residential when an item has no published transcript and has to be transcribed from its audio β€” some sources refuse datacenter traffic for the media itself.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }