{"uid":"cap_mhrNGsz-PXDEqSY0ZhRl1","slug":"gateway-d402-xyz-youtube-video-transcript-extractor-9e55533b","name":"YouTube Video Transcript Extractor","description":"Paid d402 capability alias for media.youtube_transcript@1. Workers fetch the YouTube page, extract available transcript segments, and return a transcript with validation evidence.","url":"https://gateway.d402.xyz/v1/youtube/transcript","method":"POST","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Public youtube.com or youtu.be video URL whose page exposes a transcript."},"sync":{"type":"boolean","description":"Optional d402 sync flag. Defaults to gateway policy."},"timeoutMs":{"type":"number","maximum":45000,"minimum":1,"description":"Optional per-request timeout, capped by gateway policy."},"languageCode":{"type":"string","description":"Optional preferred transcript language code when the page exposes multiple languages."}},"additionalProperties":false},"responseSchema":{"type":"object","required":["taskId","status"],"properties":{"error":{"type":["string","null"]},"links":{"type":"object","properties":{"task":{"type":"string"},"result":{"type":"string"},"receipt":{"type":"string"}}},"result":{"type":"object","required":["url","videoId","transcript","transcriptHash","segmentCount","source","serviceVersion"],"properties":{"url":{"type":"string"},"title":{"type":"string"},"source":{"type":"string"},"videoId":{"type":"string"},"segments":{"type":"array","items":{"type":"object","required":["text"],"properties":{"text":{"type":"string"},"endMs":{"type":"number"},"startMs":{"type":"number"},"durationMs":{"type":"number"}}}},"fetchedAt":{"type":"string"},"transcript":{"type":"string"},"serviceName":{"type":"string"},"languageCode":{"type":"string"},"languageName":{"type":"string"},"segmentCount":{"type":"number"},"serviceVersion":{"type":"string"},"transcriptHash":{"type":"string"},"extractorVersion":{"type":"string"}}},"status":{"enum":["accepted","rejected","running","error"],"type":"string"},"taskId":{"type":"string"},"settlement":{"type":["object","null"],"additionalProperties":true},"x402Settlement":{"type":["object","null"],"additionalProperties":true},"validationReceipt":{"type":["object","null"],"additionalProperties":true}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.50","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__gqFOfrl73FdNKuIgnqPk","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_eFIdGDEelp2y-tsBTKSkW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"gateway.d402.xyz","brandSlug":"gateway-d402-xyz-mpp","brandBaseUrl":"https://gateway.d402.xyz","brandDocsUrl":null,"whatItDoes":"Fetches and returns the full transcript of a public YouTube video, including timed segments, language info, and a validation hash.","exampleAgentPrompt":"Can you grab the full transcript from this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — and give me the text with timestamps? I'd prefer English if multiple languages are available.","exampleUseCases":[{"title":"Research paper summary from video lecture","prompt":"I'm writing a paper on machine learning and found this great lecture video. Can you pull the transcript from https://www.youtube.com/watch?v=example1 and give me the key points with timestamps so I can cite the exact moments?"},{"title":"Accessibility transcript for hearing-impaired user","prompt":"My colleague is deaf and wants to watch our company's training video. Can you extract the full captions from https://www.youtube.com/watch?v=example2 with all the timing information so we can display it alongside the video?"},{"title":"Content moderation and compliance audit","prompt":"We need to audit this YouTube video for our compliance team. Can you fetch the complete transcript with timestamps from https://www.youtube.com/watch?v=example3 so we can search for specific terms and see exactly when they were mentioned?"}],"resultDescription":"Returns a task status plus a result object containing the full transcript as a plain string, an array of timed segments (each with text, startMs, endMs, durationMs), the video ID and title, language code and name, segment count, a transcript hash for validation, and metadata like fetchedAt and service version.","failureModes":["Video has no publicly available transcript or captions — returns error status","Invalid or private YouTube URL — rejected with error field set","Request timeout exceeded (max 45000ms) — error status returned","Unsupported language code requested — may fall back to default or return error","Video is age-restricted or geo-blocked — extraction fails with error"],"whenToPreferThis":"Use this endpoint when you need the spoken or captioned text from a YouTube video, especially with timestamped segments for precise referencing. It is ideal for summarization, quote extraction, search indexing, or accessibility workflows where the raw transcript with validation evidence is required. Prefer this over generic web scrapers when the target is specifically a YouTube video transcript.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":8,"lastUsedAt":"2026-06-05T03:49:46.661Z","lastSuccessfullyRanAt":"2026-05-11T03:00:39.525Z","lastHealthCheckAt":"2026-09-15T00:33:08.268Z","isFirstParty":false}