# YouTube Transcript

> YouTube Transcript is a paid API for AI agents from ryumoon-x402-tools.ryumoon.workers.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-20).

Fetches full captions/subtitles for a YouTube video as clean plain text with timestamped segments, metadata (title, channel, duration, language), language fallback, and optional translation.

## Facts

- Endpoint: GET https://ryumoon-x402-tools.ryumoon.workers.dev/youtube/transcript?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youtube-transcript-b89218e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QtPpTw43xPF107UTS-Awa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability youtube-transcript-b89218e1
```

Example prompt: Can you grab the full transcript of this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — with timestamps included, in English?

## When to prefer this

Use this endpoint when you need the spoken content of a YouTube video as text — for summarization, search, translation, quote extraction, or analysis — without needing to download or process the video file itself. It is preferable to raw audio transcription pipelines when captions already exist, as it is faster and more accurate. The language fallback and built-in translation support make it suitable for multilingual workflows. It charges only on success, making it safe to use speculatively.

## Known failure modes

- Video ID or URL is invalid or malformed — returns an error indicating the video could not be found
- Video has no available captions or subtitles in any language — returns an error or empty transcript
- Requested language not available and no fallback found — may fall back to auto-generated captions or return an error
- Translation fails for the target language code — returns an error or untranslated text
- Video is private, deleted, or region-restricted — returns an access error
- Rate limiting or upstream YouTube API errors — returns a service unavailable error

## How this service works

YouTube transcript: full captions/subtitles for one video as clean plain text plus timestamped segments, title, channel, duration and language, with language fallback and translation. Charged only on success.

## Output

Returns clean plain text of the full video transcript, an array of timestamped caption segments (start time, duration, text), the video title, channel name, total duration, and the detected or requested language. Only charged on successful retrieval.

## Request schema (JSON Schema)

```json
{
 "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": [
      "video"
     ],
     "properties": {
      "lang": {
       "type": "string",
       "description": "Preferred caption languages, comma-separated, e.g. en,es"
      },
      "video": {
       "type": "string",
       "description": "YouTube URL or 11-character video ID"
      },
      "translate": {
       "type": "string",
       "description": "Translate captions to this language code"
      },
      "timestamps": {
       "type": "boolean",
       "description": "Include timestamped segments (default true)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youtube-transcript-b89218e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ryumoon-x402-tools.ryumoon.workers.dev](https://www.zero.xyz/host/ryumoon-x402-tools.ryumoon.workers.dev/llms.txt)
