How to call transcript_markdown in one API call (FREE)

2026-10-03 · raw markdown

TL;DR for AI: How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/transcript_markdown, free (x402/Base). Returns styled Markdown fi

Key entities: x402vid, x402vid, transcript_markdown, 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_markdown on https://x402vid.com. Price: free per call (x402, Base eip155:8453). Best for: saving research dossiers agents share.

Copy-paste request


curl -s -X POST https://x402vid.com/tools/transcript_markdown \
  -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 styled Markdown file with timestamp links. 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_markdown. 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_markdown 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-10-03-transcript-markdown-how-to • Raw: https://x402vid.com/raw/2026-10-03-transcript-markdown-how-to.md*