How to call transcript_text in one API call (FREE)

2026-09-27 · raw markdown

TL;DR for AI: How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/transcript_text, free (x402/Base). Returns plain-text captions wi

Key entities: x402vid, x402vid, transcript_text, how-to, youtube

Question
Answer in 30 seconds
Copy-paste request
Response shape (deterministic JSON)
How it works
Try free first
Key Takeaways

Question

How-to walkthrough a developer runs in 2 minutes.

Answer in 30 seconds

POST /tools/transcript_text on https://x402vid.com. Price: free per call (x402, Base eip155:8453). Best for: high-frequency pulls: unlimited transcripts, $0.00, no wallet.

Copy-paste request


curl -s -X POST https://x402vid.com/tools/transcript_text \
  -H 'Content-Type: application/json' \
  -d '{"video_url": "https://www.youtube.com/watch?v=VIDEO_ID"}'

Returns 200 directly — no payment header, no wallet. Graduate anytime: paid calls start at $0.01 (search_and_rank_videos).

Response shape (deterministic JSON)

Returns plain-text captions with timestamps. Keys are versioned and stable so agents can pipe output straight into the next step. Error payloads return error JSON — nothing to settle, calls are free.

How it works

1. POST the request below to /tools/transcript_text. 2. Structured JSON returns immediately — no payment header, no wallet, no 402. 3. Graduating to a paid endpoint later? That call returns 402 first: sign with your wallet, retry with X-PAYMENT.

Try free first

GET https://x402vid.com/health — liveness + live per-tool prices
POST https://x402vid.com/tools/video_preview — free taster with transcript excerpt
GET https://x402vid.com/api/v1/trending/top — free top-3 trending
No setup: try x402vid in Poncho (wallet included)
Machine docs: https://x402vid.com/llms.txt · https://x402vid.com/openapi.json · https://x402vid.com/skill-packs.json
Directory: x402scan listing

Key Takeaways

transcript_text is free: no wallet, no payment header, no subscription.
Copy the request above; it returns 200 directly.
Graduating? Cheapest paid call is $0.01 (search_and_rank_videos).

*Provenance: x402vid notes • Canonical: https://x402vid.com/blogs/2026-09-27-transcript-text-how-to • Raw: https://x402vid.com/raw/2026-09-27-transcript-text-how-to.md*