$ man youtube-transcript
/youtube-transcript(1)
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
uncategorized
STATUS
● live
NAME
youtube-transcript — youtube transcript / closed-caption fetcher / video subtitles puller / auto-generated cc reader
SYNOPSIS
POST https://x402.org/v1/youtube-transcript
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
YouTube transcript / closed-caption fetcher / video subtitles puller / auto-generated CC reader. Pulls YouTube auto-generated or manual captions for any video and returns the full text plus per-segment {start, duration, text}. Optional language pick. Backed by Supadata's transcript pipeline (server-side; no caller key required). If no transcript is available for the video, returns a 404 with a clear error.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| video_id_or_url | string | YouTube video ID (11-char) or full URL (youtube.com/watch?v=…, youtu.be/…, /embed/…, /shorts/…). | required |
| language | string | Preferred caption language code (e.g. 'en', 'es', 'ja'). Default: pick the first available. | optional |
| include_chapters | boolean | Parse chapter timestamps from the video description. Default false. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| video_id | string | YouTube video ID parsed from the input URL or passed through verbatim. |
| title | string | Video title as listed on YouTube. |
| channel | string | Channel name that uploaded the video. |
| duration_seconds | string | Total video length in seconds. |
| language | string | BCP-47 language code of the returned transcript (e.g. 'en', 'es'). |
| transcript | string | Full caption text joined into a single string with segment breaks collapsed. |
| segments | string | Array of {start, duration, text} objects giving per-caption-line timing in seconds. |
| chapters | string | Array of video chapter markers with title and start time, when YouTube exposes them. |
| source | string | Caption origin tag: 'manual' for uploaded subtitles or 'auto' for YouTube auto-generated CC. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/youtube-transcript \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the youtube-transcript tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- mediakityoutubetranscriptcaptionssubtitlesvideo-textclosed-captionsyoutube-transcript
- methods
- POST
- cluster
- mediakit
- price
- $0.01 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| audio-transcribe | Audio transcribe / speech-to-text / Whisper-large / multi-language ASR / OpenAI Whisper API compat. | $0.01 |
| csv-to-ics | CSV calendar to ICS / iCal file generator. | $0.01 |
| image-convert | Universal image format converter (PNG, JPG, WEBP, AVIF, GIF, BMP, TIFF, ICO, HEIC, HEIF, PSD, SVG). | $0.01 |
| image-format-convert | Image converter. | $0.01 |
| merge-pdf | PDF merger / combine PDFs / concatenate PDF files / join multiple PDFs into one. | $0.01 |
| pdf-merge | PDF merger / PDF combiner / PDF concatenator. | $0.01 |
| receipt-ocr | Receipt OCR. | $0.01 |
| receipt-parser | Receipt → structured JSON (vendor, address, date, line items with qty/unit_price/total, subtotal, tax, tip, total, payment method). | $0.01 |
SEE ALSO