# Orvento YouTube Transcript & Summary API

> Orvento YouTube Transcript & Summary API is a paid API for AI agents from orvento.link, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-27).

Fetches full transcripts, timed segments, metadata, and summaries for any YouTube video, billed per call in USDC via x402

## Facts

- Endpoint: GET https://orvento.link/v1/transcript?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orvento-youtube-transcript-summary-api-44336d2e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nYnGhrlMxsddcSbmrgnmo

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 orvento-youtube-transcript-summary-api-44336d2e
```

Example prompt: Can you get the full transcript and chapter breakdown for this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

## When to prefer this

Choose this endpoint when you need machine-readable transcript text, timed subtitle segments, or video metadata from a YouTube video without requiring a YouTube Data API key or OAuth setup. It is ideal for AI agents that need to process video content as text (e.g. summarization, Q&A, search indexing) and want pay-per-use billing in USDC with no account registration. Prefer it over YouTube's own API when avoiding key management overhead, or over general web scraping when you need clean structured output with timestamps and chapters.

## Known failure modes

- Video has no available captions or transcript — returns an error or empty segments
- Invalid or malformed YouTube URL/ID — returns a 400-style error
- Video is private, age-restricted, or geo-blocked — transcript unavailable
- x402 payment rejected or underfunded — 402 Payment Required with no content
- YouTube blocks transcript access for this video — upstream fetch failure
- Network timeout on long videos or cold cache — slow or failed response

## How this service works

YouTube video summaries and transcripts for AI agents. Pay per call in USDC over x402 via Circle Gateway. No signup, no API key.

## Output

Returns a JSON object containing: a plain-text transcript or summary ('text'), a 'kind' field indicating whether the transcript is manual or auto-generated, language code, an array of timed segments (each with start time, duration, and text), video metadata (title, channel, description, upload date, duration, tags, chapters with start/end timestamps), and the canonical video URL and ID.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "example": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
       "description": "YouTube video URL or 11-character video ID"
      },
      "refresh": {
       "type": "boolean",
       "description": "Bypass the cache"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$defs": {
      "Chapter": {
       "type": "object",
       "title": "Chapter",
       "required": [
        "start",
        "end",
        "title"
       ],
       "properties": {
        "end": {
         "type": "number",
         "title": "End"
        },
        "start": {
         "type": "number",
         "title": "Start"
        },
        "title": {
         "type": "string",
         "title": "Title"
        }
       }
      },
      "Segment": {
       "type": "object",
       "title": "Segment",
       "required": [
        "start",
        "duration",
        "text"
       ],
       "properties": {
        "text": {
         "type": "string",
         "title": "Text"
        },
        "start": {
         "type": "number",
         "title": "Start"
        },
        "duration": {
         "type": "number",
         "title": "Duration"
        }
       }
      },
      "VideoMeta": {
       "type": "object",
       "title": "VideoMeta",
       "required": [
        "id",
        "url",
        "title",
        "description",
        "channel",
        "duration",
        "upload_date",
        "language",
        "tags",
        "chapters"
       ],
       "properties": {
        "id": {
         "type": "string",
         "title": "Id"
        },
        "url": {
         "type": "string",
         "title": "Url"
        },
        "tags": {
         "type": "array",
         "items": {
          "type": "string"
         },
         "title": 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "manual",
  "text": "…",
  "video": {
   "id": "dQw4w9WgXcQ",
   "title": "…",
   "chapters": []
  },
  "language": "en",
  "segments": [
   {
    "text": "…",
    "start": 18.64,
    "duration": 3.24
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orvento-youtube-transcript-summary-api-44336d2e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orvento.link](https://www.zero.xyz/host/orvento.link/llms.txt)
