{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript: Captions & Subtitles to Text, SRT, VTT", "description": "Get the transcript of any public YouTube video with captions as plain text, timestamped segments, SRT or VTT. Paste a whole list of videos in one run. Manual or auto captions in your language. No API key, no login. Videos without captions are never charged. Works in Claude and ChatGPT via MCP.", "version": "0.1", "x-build-id": "YFimIyxcxw5GbeiZl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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": "YouTube video URLs or IDs", "type": "array", "description": "One or more YouTube videos, one per line. Accepts watch URLs (https://www.youtube.com/watch?v=...), youtu.be short links, /shorts/, /embed/ and /live/ URLs, or a bare 11-character video ID such as dQw4w9WgXcQ. Duplicates are fetched and charged once. Channel and playlist URLs are not supported: list the individual videos.", "items": { "type": "string" } }, "outputFormats": { "title": "Output formats", "type": "array", "description": "Which transcript formats to return on each row. text: the whole transcript as one string (fullText). segments: an array of { start, dur, text } lines in seconds. srt and vtt: ready-to-use subtitle files as strings. Choose any combination; the price per transcript is the same.", "items": { "type": "string", "enum": [ "text", "segments", "srt", "vtt" ], "enumTitles": [ "Plain text (fullText)", "Timestamped segments (JSON)", "SRT subtitles", "WebVTT subtitles" ] }, "default": [ "text", "segments" ] }, "language": { "title": "Preferred caption language", "type": "string", "description": "Language code of the caption track to prefer, for example en, es, hi, fr or pt. en also matches en-US and en-GB. If the video has no track in this language, you get another available track instead (uploaded captions first), and the language field on the row says which one you got. This does not translate.", "default": "en" }, "includeTimestamps": { "title": "Include timestamped segments", "type": "boolean", "description": "When on, rows include the segments array (start time and duration of each line, in seconds) if segments is one of the output formats. Turn it off to drop the array. SRT and VTT always carry their own timings.", "default": true }, "useResidentialProxy": { "title": "Use residential proxy (2 charges per transcript)", "type": "boolean", "description": "Off by default. On the default datacenter proxy YouTube asks many videos to sign in to confirm they are not a bot; those rows come back with reason bot-check and needsResidentialProxy, and are not charged. Turn this on to fetch them. When it is on, the actor fetches through Apify RESIDENTIAL proxy and each delivered transcript is charged as TWO transcript-scraped events. That is about $10 per 1,000 transcripts on the Free plan from 12 Oct 2026, and $5 per 1,000 now. Videos that return no transcript are still not charged. While this is on, the proxy field below is ignored (a country set there is kept).", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional. Leave it on the default, Apify Proxy (datacenter). Videos that YouTube refuses there are marked needsResidentialProxy and are not charged; to fetch them, turn on Use residential proxy above instead of picking a residential group here. A residential group picked here is charged at the single price, and the cost guard stops such a run after about 100 videos. Ignored while Use residential proxy is on.", "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 }, "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 } } } } } } } } } }