{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper - Bulk Captions & Subtitles", "description": "Extract YouTube transcripts and captions in bulk - full text, timestamps and SRT, in 100+ languages. No API key, no quota. Paste many URLs at once.", "version": "0.1", "x-build-id": "1vnaLyHxzrwyHwRTU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/convertfleetdotonline~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-convertfleetdotonline-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/convertfleetdotonline~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-convertfleetdotonline-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/convertfleetdotonline~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-convertfleetdotonline-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", "required": [ "videoUrls" ], "properties": { "videoUrls": { "title": "YouTube video URLs", "type": "array", "description": "One or more YouTube video URLs to pull transcripts/captions from. Add as many as you like — they are processed in a single run. Supports youtube.com/watch?v=, youtu.be/, /shorts/, /live/ and /embed/ links. Tip: paste a bare 11-character video ID and it still works.", "items": { "type": "string" } }, "preferredLanguages": { "title": "Preferred caption languages", "type": "array", "description": "Ordered list of ISO 639-1 language codes (e.g. en, es, fr). The actor returns the first one that exists for each video, preferring human-made subtitles over auto-generated ones. If none of your preferred languages exist, it falls back to the video's original-language captions and tells you which language it used. Leave as-is for English.", "default": [ "en" ], "items": { "type": "string" } }, "translateTo": { "title": "Translate transcript to (optional)", "enum": [ "", "en", "pt", "es", "fr", "de", "it", "ja", "ko", "zh", "ru", "ar", "hi", "nl", "pl", "tr", "vi", "id", "th", "sv", "da", "no", "fi", "cs", "hu", "ro", "uk", "el", "he", "fa", "bn", "ta", "te", "mr", "ur", "gu", "kn", "ml", "pa", "sr", "hr", "bg", "sk", "lt", "lv", "et", "sl", "ca", "af", "sq", "am", "hy", "az", "eu", "be", "bs", "my", "ceb", "zh-Hans", "zh-Hant", "co", "eo", "fil", "fy", "gl", "ka", "ht", "ha", "haw", "hmn", "is", "ig", "ga", "jv", "kk", "km", "rw", "ku", "ky", "lo", "la", "lb", "mk", "mg", "ms", "mt", "mi", "mn", "ne", "ny", "or", "ps", "sm", "gd", "sn", "sd", "si", "so", "st", "su", "sw", "tg", "tt", "tk", "ug", "uz", "cy", "xh", "yi", "yo", "zu" ], "type": "string", "description": "Optionally translate the transcript into another language using YouTube's built-in caption translation. Leave empty to return the original captions untouched.", "default": "" }, "includeTimestamps": { "title": "Include timestamped segments", "type": "boolean", "description": "Return the full timestamped segment array (start, dur, end, text) in addition to the plain-text transcript. Turn off if you only want the clean paragraph text.", "default": true }, "includeSrt": { "title": "Include SRT subtitle text", "type": "boolean", "description": "Also return the transcript as a ready-to-use .srt subtitle string (great for captioning video editors). Off by default.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Captions are fetched through this proxy. Apify datacenter IPs are sometimes rate-limited by YouTube, so the actor automatically retries failed videos directly (and via the RESIDENTIAL group when available). The default works for most videos.", "default": { "useApifyProxy": true } }, "cookies": { "title": "YouTube cookies (Netscape format) - optional", "type": "string", "description": "Optional. Paste the contents of a Netscape-format cookies.txt from a logged-in YouTube session to reach age-gated or region-restricted videos. See https://github.com/yt-dlp/yt-dlp/wiki/FAQ#how-do-i-pass-cookies-to-yt-dlp.", "default": "" } } }, "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 } } } } } } } } } }