{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper — Subtitles, Captions & LLM Text", "description": "Extract YouTube transcripts, subtitles and captions without an API key. Bulk videos, playlists and channels. Output timestamped segments, LLM-ready text, readable paragraphs, SRT and VTT. Resilient multi-client engine with automatic residential fallback. Free — you only pay Apify usage.", "version": "0.0", "x-build-id": "7aNX2UMneY9b7GL37" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fit_melon~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fit_melon-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/fit_melon~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-fit_melon-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/fit_melon~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-fit_melon-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": [ "videos" ], "properties": { "videos": { "title": "Videos, playlists or channels", "type": "array", "description": "One entry per line. Accepts video URLs, bare 11-character video IDs, youtu.be links, Shorts, /live/ and /embed/ URLs, playlist URLs, and channel URLs (/channel/UC…, /@handle, /c/name, /user/name). Playlists and channels are expanded into their videos.", "items": { "type": "string" } }, "language": { "title": "Preferred language", "type": "string", "description": "Preferred caption language code (e.g. en, fr, es, de). Matches en-US when you ask for en. Leave empty to take the first available track.", "default": "en" }, "includeAutoGenerated": { "title": "Include auto-generated captions", "type": "boolean", "description": "Allow YouTube's automatic (ASR) captions when no human-made captions exist. Manual captions are always preferred when both are available.", "default": true }, "outputFormats": { "title": "Output formats", "type": "array", "description": "Which representations to include in each result. 'text' is a single clean string ideal for LLMs; 'segments' are timestamped; 'srt' and 'vtt' are subtitle files.", "items": { "type": "string", "enum": [ "segments", "text", "paragraphs", "srt", "vtt" ], "enumTitles": [ "Timestamped segments", "Plain text (LLM-ready)", "Readable paragraphs", "SRT subtitles", "VTT subtitles" ] }, "default": [ "segments", "text" ] }, "translateTo": { "title": "Translate to (optional)", "type": "string", "description": "Translate captions to this language code using YouTube's own translation (e.g. en, fr). Leave empty to keep the original language.", "default": "" }, "includeMetadata": { "title": "Include video metadata", "type": "boolean", "description": "Attach title, channel, duration, view count, publish date and thumbnail to each result.", "default": true }, "maxVideosPerChannel": { "title": "Max videos per playlist/channel", "minimum": 1, "maximum": 5000, "type": "integer", "description": "When a playlist or channel is provided, cap how many of its videos are processed.", "default": 20 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many videos to fetch in parallel. Higher is faster on large inputs; each request uses its own rotating proxy session. If you see many bot-checks, lower this or rely on the residential fallback.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests to YouTube are routed through this proxy. Apify Proxy (datacenter) is enabled by default and is free on the platform. Most videos work on datacenter; the few that trip YouTube's bot-check are handled by the residential fallback below.", "default": { "useApifyProxy": true } }, "autoResidentialFallback": { "title": "Auto residential fallback", "type": "boolean", "description": "When a video is blocked by YouTube's 'confirm you're not a bot' check on a datacenter IP, automatically retry just that video through residential proxies. This maximises reliability while only spending the (higher) residential rate on the videos that truly need it. Turn off to stay strictly on datacenter proxies.", "default": 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 } } } } } } } } } }