Get Transcript
AI-generatedSummary
Operation: getTranscript
Inputs
- videoUrl (required) — YouTube URL, video ID, or any URL supported by yt-dlp (1000+ sites)
- subtitleLanguage — Subtitle language code (e.g. en, es, fr, de, ja, ko, zh)
- useProxy — Whether to route the request through a proxy server
- proxyUrl — Proxy URL — supports HTTP, HTTPS, and SOCKS5 protocols
- customFlags — Additional yt-dlp command-line flags for advanced use cases
Output shape
Returns an object with success: boolean, videoId, title, language, transcript (string or null), segments (array of {start, end, text}), wordCount, and optionally message when no subtitles are found.
If subtitles are unavailable for the requested language, transcript is null and message reports the missing language. Segments are parsed from json3 format when available; otherwise transcript is raw text.
Examples
Example 1: Extract English transcript with segments
videoUrl: 'https://youtu.be/abc123', subtitleLanguage: 'en'
Example 2: No subtitles found
videoUrl: 'https://youtu.be/abc123', subtitleLanguage: 'xy', result: {success: true, transcript: null, message: 'No subtitles found for language 'xy''}