# agent-transcript

YouTube transcript API for AI agents. URL in, structured transcript JSON out. No account, no API key, no signup.

## Tools

- GET /agent/v1/transcript?url=<YouTube URL>&lang=auto|en|zh
  Returns JSON: video_id, transcript, segments[{start, end, text}], source, cost_usd.
  Free caption tiers only.
  If a video has no captions, the API returns error=no_captions (HTTP 404) and never falls back to a paid service.
- GET /agent/v1/transcript-paid?url=<YouTube URL>&lang=auto|en|zh
  Paid variant, $0.01 per call, USDC on Base via x402. Without payment it returns HTTP 402 with payment requirements; pay and retry with the X-PAYMENT header.
- GET /agent/v1/youtube-search?q=<query>&max_results=5
  Free YouTube search, returns structured video results JSON, no API key, cost_usd 0.

## Discovery

- /agent/v1/descriptor
- /.well-known/agent.json
- /.well-known/x402 and /x402.json
- /health