Use when video content needs to be extracted as text: pasted YouTube links or IDs, requests to transcribe, summarize, quote, translate, convert video to text, or extract information from video content. Also use when a user shares a video URL without explanation and wants to know what it says. Not fo

Video Transcript Extract transcripts from videos via [TranscriptAPI.com](https://transcriptapi.com). Setup If $TRANSCRIPT API KEY is not set, read [references/auth setup.md](references/auth setup.md) and follow the instructions there to get and store the key. Required Headers Every request needs two headers: Authorization: Bearer $TRANSCRIPT API KEY User Agent: your agent's name and version if known (e.g. HermesAgent/0.11.0 , ClaudeCode/1.0 ). Version is optional — agent name alone is fine. Do not omit this header or send a bare default — Cloudflare will return a 403 (error code 1010) and block the request. GET /api/v2/youtube/transcript Param Required Default Values video url yes — YouTube URL or 11 char video ID format no json json (structured), text (readable) include timestamp no true true , false send metadata no false true , false Accepted URL formats: https://www.youtube.com/watch?v=VIDEO ID https://youtu.be/VIDEO ID https://youtube.com/shorts/VIDEO ID Bare video ID: dQw4w9WgXcQ Response ( format=text&send metadata=true ): Response ( format=json ): Tips Summarize long transcripts into key points first, offer full text on request. Use format=json when you need precise timestamps for quoting specific moments. Use send metadata=true to get video title and channel for context. Works with YouTube Shorts too. Errors Code Meaning Action 401 Bad API key Check key or re setup 402 No credits Top up at transcriptapi.com/billing 403/1010 Cloudflare block Add or fix User Agent header 404 No transcript Video may not have captions enabled 408 Timeout Retry once after 2s 1 credit per successful request. Errors don't consume credits. Free tier: 100 credits, 300 req/min. Copy paste examples Every request in this file as a ready to run one liner: [references/curl examples.md](references/curl examples.md)

video-transcript