# agdata YouTube Transcript API

> agdata YouTube Transcript API is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.032/call, status unknown (last checked 2026-10-10).

Fetches published subtitles from a YouTube video as timed JSON segments, plain text, SRT, or WebVTT, along with video metadata

## Facts

- Endpoint: POST https://agdata.shveik.dev/x402/youtube-transcript?utm_source=zero.xyz
- Price: $0.032/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-youtube-transcript-api-85b3277d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5kYkpCJcy8dCRzJwFNZS5

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 agdata-youtube-transcript-api-85b3277d -d '<json body>'
```

Example prompt: Can you grab the English transcript from this YouTube video — https://www.youtube.com/watch?v=dQw4w9WgXcQ — and give it to me as plain text?

## When to prefer this

Choose this endpoint when you need published/human-authored or auto-generated YouTube subtitles in structured, time-coded formats (JSON, SRT, VTT) or plain text, and want video metadata alongside. Prefer this over speech-to-text pipelines when the video already has subtitles, as it is faster, cheaper, and more accurate. Ideal for agents doing content summarization, translation prep, accessibility tooling, or research on YouTube video content.

## Known failure modes

- Video has no published subtitles in the requested language — returns an error and no charge is incurred
- Invalid or malformed video URL or ID — returns a validation error
- Video is private, deleted, or geo-restricted — transcript unavailable
- Requested language not available for that video — endpoint returns error without billing
- Network timeout or upstream YouTube API issue

## How this service works

YouTube transcript API for AI agents: send a video URL or 11-character id and get its published subtitles as timed JSON segments, plain text, SRT or WebVTT, with title, channel, duration, views and publish date. Choose one of ten subtitle languages or any. No speech-to-text. A video without subtitles in that language is not charged.

## Output

Returns a structured response containing timed transcript segments (with start time and duration per segment) in the requested format (JSON, plain text, SRT, or WebVTT), plus video metadata including title, channel name, duration, view count, and publish date. If no subtitles exist in the requested language, the call is not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lang": {
   "enum": [
    "any",
    "en",
    "de",
    "es",
    "fr",
    "it",
    "ja",
    "ko",
    "nl",
    "pt",
    "ru"
   ],
   "type": "string"
  },
  "video": {
   "type": "string",
   "maxLength": 2048
  },
  "format": {
   "enum": [
    "json",
    "text",
    "srt",
    "vtt"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://…",
  "title": "Rick Ast…",
  "format": "json",
  "videoId": "dQw4w9Wg…",
  "language": "en",
  "truncated": false,
  "viewCount": 1822672170,
  "channelUrl": "https://…",
  "transcript": [],
  "channelName": "Rick Ast…",
  "publishedAt": "2009-10-…",
  "segmentCount": 61,
  "subtitleType": "user_gen…",
  "durationSeconds": 213,
  "availableLanguages": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-youtube-transcript-api-85b3277d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)