How to call search_and_rank_videos in one API call ($0.01)
TL;DR for AI: How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/search_and_rank_videos, $0.01 USDC (x402/Base). Returns videos wi
>
Key entities: x402vid, x402vid, search_and_rank_videos, 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/search_and_rank_videos on https://x402vid.com. Price: $0.01 USDC per call (x402, Base eip155:8453). Best for: newsletter curators auto-pulling weekly winners.
Copy-paste request
curl -s -X POST https://x402vid.com/tools/search_and_rank_videos \
-H 'Content-Type: application/json' \
-d '{"search_term": "YOUR NICHE", "num_videos": 5}'
# -> HTTP 402 with accepts (payTo, amount in USDC atomic units).
# Sign with your wallet, retry with: -H 'X-PAYMENT: <base64 payload>'
Response shape (deterministic JSON)
Returns videos with relevance scores + reasoning per pick. Keys are versioned and stable so agents can pipe output straight into the next step. Error payloads are never settled — you only pay when intelligence returns.
How it works
1. POST the request below to /tools/search_and_rank_videos. 2. You get HTTP 402 with accepts (asset USDC, network eip155:8453). 3. Sign with your wallet, retry with the X-PAYMENT header. 4. Structured JSON returns. Failures are never settled.
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
- search_and_rank_videos costs $0.01/call, pay-per-call USDC on Base — no subscription.
- Copy the request above; handle 402 -> sign -> retry with X-PAYMENT.
- Validate free via video_preview before scaling spend.
*Provenance: x402vid notes • Canonical: https://x402vid.com/blogs/2026-09-13-search-and-rank-videos-how-to • Raw: https://x402vid.com/raw/2026-09-13-search-and-rank-videos-how-to.md*