{"uid":"cap_M0tGYgUrT-2iQT-C_OVaW","slug":"youtube-transcript-captions-chapters-19f9ac9d","name":"YouTube Transcript, Captions & Chapters","description":"Full transcript of any YouTube video by video id or URL: captions/subtitles as clean plain text plus timestamped segments, the video's chapter markers, and every caption track it offers so an agent can pick a language and re-fetch. YouTube transcript, video to text, captions extraction, subtitle download, closed captions, speech to text, multilingual, asr and authored tracks. No API key.","url":"https://youtube.use.x402atlas.com/transcript?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["v"],"properties":{"v":{"type":"string","maxLength":500,"description":"YouTube video id (11 characters) or a full YouTube video URL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["video_id","queried_at","text","segments","chapters","available_transcripts"],"properties":{"note":{"type":"string","description":"Present only on the sample response (a call with no v): a hint that this is a canned example. The paid request ran; no upstream call was made."},"text":{"type":"string","description":"Whole transcript as one plain-text block"},"chapters":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"end_ms":{"type":"integer"},"start_ms":{"type":"integer"},"start_time_text":{"type":"string"}}},"description":"Chapter markers; empty for videos without chapters"},"segments":{"type":"array","items":{"type":"object","required":["start_ms","text"],"properties":{"text":{"type":"string"},"end_ms":{"type":"integer","description":"Line end offset in milliseconds; absent on tracks that carry only starts"},"start_ms":{"type":"integer","description":"Line start offset in milliseconds"},"start_time_text":{"type":"string","description":"Line start as displayed, e.g. 0:43"}}}},"video_id":{"type":"string","description":"Normalized 11-character video id"},"queried_at":{"type":"string","format":"date-time"},"language_code":{"type":"string","description":"Language of the track actually served; omitted when the upstream identifies none — never an echo of the request"},"available_transcripts":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"asr on auto-generated tracks; absent on authored ones"},"title":{"type":"string","description":"Track title, on videos with named tracks"},"selected":{"type":"boolean","description":"True on the track this response served"},"language_code":{"type":"string"}}},"description":"Every track this video offers; feed language_code/type/title back to fetch one. A language may appear twice — the authored track and the asr one."}}}}}}},"responseSchema":{"type":"json","example":{"text":"Good morning. How are you? (Audience) Good. It's been great, hasn't it?","chapters":[{"title":"Introduction","end_ms":42000,"start_ms":0,"start_time_text":"0:00"},{"title":"Three themes","end_ms":115000,"start_ms":42000,"start_time_text":"0:42"}],"segments":[{"text":"Good morning. How are you?","end_ms":29678,"start_ms":27103,"start_time_text":"0:27"},{"text":"(Audience) Good.","end_ms":31105,"start_ms":29702,"start_time_text":"0:29"}],"video_id":"iG9CE55wbtY","queried_at":"2026-07-24T12:00:00Z","language_code":"en","available_transcripts":[{"selected":true,"language_code":"en"},{"type":"asr","language_code":"en"},{"language_code":"fr"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.96","successRate":"0.67","reviews":2,"stars":"4.8","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VNg5XKGIwy3laYmeezsrW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the full transcript, timestamped caption segments, chapter markers, and available caption tracks for any YouTube video by ID or URL.","exampleAgentPrompt":"Can you grab the full transcript of this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — including the timestamped segments and chapter markers?","exampleUseCases":[{"title":"Summarize a YouTube lecture","prompt":"Get me the full transcript of this YouTube lecture — https://www.youtube.com/watch?v=aircAruvnKk — so I can summarize the key points."},{"title":"Find a quote timestamp in a video","prompt":"Pull the timestamped captions for YouTube video ID 9bZkp7q19f0 so I can find exactly when a specific phrase is spoken."},{"title":"Check available subtitle languages","prompt":"What caption languages are available for this YouTube video? https://www.youtube.com/watch?v=JGwWNGJdvx8 — I need to know if there's a Spanish track I can use."}],"resultDescription":"Returns the full video transcript as a plain-text block, an array of timestamped caption segments (each with start_ms, optional end_ms, and display-formatted start time), an array of chapter markers with titles and time offsets, the language code of the served track, the normalized 11-character video ID, the query timestamp, and a list of all available caption tracks (including whether each is auto-generated or authored, its language code, and whether it was selected).","failureModes":["Video ID not found or invalid — returns error if the 11-character ID or URL cannot be resolved","No captions available — some videos have no caption tracks at all","Private or age-restricted videos — transcript may be inaccessible","Network or upstream YouTube API timeout — transient errors possible","Malformed URL input — if the URL cannot be parsed to extract a valid video ID"],"whenToPreferThis":"Choose this endpoint when you need to extract spoken content from a YouTube video as text, need timestamped segments for quote attribution or search, want to enumerate available caption languages before fetching in a specific language, or need chapter markers to navigate long-form video content. It requires no API key and costs a flat $0.02 USDC per call, making it ideal for lightweight, one-off transcript fetches without YouTube Data API quota concerns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":3,"lastUsedAt":"2026-10-10T01:06:22.651Z","lastSuccessfullyRanAt":"2026-10-06T03:36:23.601Z","lastHealthCheckAt":"2026-10-23T13:47:49.033Z","isFirstParty":false,"canonicalSlug":"youtube-transcript-captions-chapters-19f9ac9d"}