{ "openapi": "3.0.1", "info": { "title": "YouTube Transcript Scraper", "description": "Download YouTube transcripts, captions and subtitles in bulk - by video URL, channel or keyword. No API key, no login. Full text, timed segments, ready-to-save SRT and VTT subtitle files, and translation into 55 languages with the timings kept. $2.99 per 1,000 transcripts.", "version": "0.1", "x-build-id": "bX4HdQOqxvbUjmXdg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reportable_broth~youtube-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reportable_broth-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/reportable_broth~youtube-transcript-scraper/runs": { "post": { "operationId": "runs-sync-reportable_broth-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/reportable_broth~youtube-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-reportable_broth-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": "Video URLs", "type": "array", "description": "YouTube video links. Watch links, Shorts links, youtu.be links and bare 11-character video IDs all work.", "default": [], "items": { "type": "string" } }, "channelUrls": { "title": "Channels", "type": "array", "description": "Transcribe a channel's latest videos. Handles work with or without the @, and full channel URLs are accepted.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Search YouTube and transcribe what comes back. Useful when you want the conversation on a topic rather than a specific channel.", "default": [], "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Max videos per channel / keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Applies to channels and keywords. Video URLs you list explicitly are always all transcribed.", "default": 10 }, "languages": { "title": "Preferred languages", "type": "array", "description": "Tried in order. A video with none of them still returns whatever transcript it has, preferring a human-written one over an auto-generated one — so you get a result instead of an error.", "items": { "type": "string", "enum": [ "en", "zh-TW", "zh-CN", "ja", "ko", "th", "vi", "id", "ms", "tl", "es", "pt", "fr", "de", "it", "ar", "ru", "tr", "hi" ], "enumTitles": [ "English", "Chinese — Traditional", "Chinese — Simplified", "Japanese", "Korean", "Thai", "Vietnamese", "Indonesian", "Malay", "Filipino", "Spanish", "Portuguese", "French", "German", "Italian", "Arabic", "Russian", "Turkish", "Hindi" ] }, "default": [ "en" ] }, "includeSegments": { "title": "Include timed segments", "type": "boolean", "description": "Keep the line-by-line transcript with start times and durations. Turn off for full text only, which makes the dataset much smaller.", "default": true }, "subtitleFormats": { "title": "Subtitle files", "type": "array", "description": "Also return the transcript as a ready-to-use subtitle file, so you do not have to convert the timings yourself.", "items": { "type": "string", "enum": [ "srt", "vtt" ], "enumTitles": [ "SRT", "WebVTT" ] }, "default": [] }, "translateTo": { "title": "Translate to", "enum": [ "", "af", "ar", "bn", "bg", "my", "ca", "zh-CN", "zh-TW", "hr", "cs", "da", "nl", "en", "et", "fil", "fi", "fr", "de", "el", "gu", "he", "hi", "hu", "id", "it", "ja", "kn", "ko", "lv", "lt", "ms", "ml", "mr", "ne", "no", "fa", "pl", "pt", "pa", "ro", "ru", "sr", "si", "sk", "sl", "es", "sw", "sv", "ta", "te", "th", "tr", "uk", "ur", "vi" ], "type": "string", "description": "Translate the transcript into another language. Timings are kept, so you also get translated SRT/VTT if you asked for subtitle files. Leave empty to skip.", "default": "" }, "skipShorts": { "title": "Skip Shorts", "type": "boolean", "description": "Most Shorts have captions switched off by their uploader. Skipping them raises the share of videos that come back with a transcript.", "default": false }, "includeVideoDetails": { "title": "Include video details", "type": "boolean", "description": "On by default. Adds the video's exact publish time, like count, view count, full description, duration, channel ID, subscriber count and the list of languages its captions are available in. Costs one extra request per video.", "default": true }, "exactCommentCount": { "title": "Exact comment count", "type": "boolean", "description": "Off by default. The video page only shows a rounded count like `4.2K`; turning this on fetches the exact number (4,296) at the cost of one extra request per video.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential is the default and recommended: YouTube rate-limits repeated requests from one IP.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many videos to fetch at once.", "default": 4 } } }, "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 } } } } } } } } } }