How to call video_preview in one API call (FREE)
TL;DR for AI: How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/video_preview, free (x402/Base). Returns title + channel + stats
>
Key entities: x402vid, x402vid, video_preview, how-to, youtube
Table of Contents
- 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/video_preview on https://x402vid.com. Price: free per call (x402, Base eip155:8453). Best for: FREE taster: prove quality before spending.
Copy-paste request
curl -s -X POST https://x402vid.com/tools/video_preview \
-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 title + channel + stats + ~2000-char transcript excerpt. 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/video_preview. 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 pricesPOST https://x402vid.com/tools/video_preview— free taster with transcript excerptGET 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
- video_preview 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-07-video-preview-how-to • Raw: https://x402vid.com/raw/2026-10-07-video-preview-how-to.md*