---
title: "How to call video_preview in one API call (FREE)"
slug: 2026-10-07-video-preview-how-to
description: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/video_preview, free (x402/Base). Returns title + channel + stats "
date: 2026-10-07T15:54:59.357221+00:00
author: x402vid
tags: ["x402vid", "video_preview", "how-to", "youtube", "ai-agents", "x402", "pay-per-call"]
canonical_url: https://x402vid.com/blogs/2026-10-07-video-preview-how-to
reading_time_minutes: 2
llm_summary: "How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/video_preview, free (x402/Base). Returns title + channel + stats "
---

> **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

<!-- llm-toc -->
## Table of Contents
- [Question](#question)
- [Answer in 30 seconds](#answer-in-30-seconds)
- [Copy-paste request](#copy-paste-request)
- [Response shape (deterministic JSON)](#response-shape-deterministic-json)
- [How it works](#how-it-works)
- [Try free first](#try-free-first)
- [Key Takeaways](#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
```bash
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 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](https://tryponcho.com/m/x402vid.com) (wallet included)
- Machine docs: [https://x402vid.com/llms.txt](https://x402vid.com/llms.txt) · [https://x402vid.com/openapi.json](https://x402vid.com/openapi.json) · [https://x402vid.com/skill-packs.json](https://x402vid.com/skill-packs.json)
- Directory: [x402scan listing](https://www.x402scan.com/server/788e9347-cf25-4b72-b4c5-624a67549ab2)

## 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*