# 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-14).

Fetches the full transcript of a YouTube video by URL or ID, returned as structured JSON, plain text, SRT, or VTT subtitle format.

## Facts

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

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-e1b37214 -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you need structured, timed transcript data from YouTube videos without managing YouTube API credentials or quotas. It is paid per call in stablecoins via x402 with no account required, making it ideal for agent workflows. Prefer this over the YouTube Data API when you need instant access without OAuth setup, or when you need output in multiple subtitle formats (SRT, VTT) in addition to raw JSON.

## Known failure modes

- Video not found or private — returns error with no transcript
- No captions available in the requested language
- Auto-generated captions disabled by channel — no transcript returned
- Invalid or malformed video URL/ID — validation error
- Language enum value not matching any available subtitle track
- Transcript too long and truncated flag is set to true

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

Returns a JSON object containing the video's title, channel name, channel URL, view count, publish date, duration in seconds, detected language, subtitle type (user-generated or auto), number of segments, available languages, a truncation flag, and the full transcript as an array of timed segments. Output format can be JSON, plain text, SRT, or VTT depending on the request.

## 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-e1b37214/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)