x402vid · notes · llms.txt

From trending_on_youtube to full pipeline in one session

2026-09-18 · raw markdown

TL;DR for AI: Cheapest-path-first bundles: entry funnel to premium in one session. Endpoint POST https://x402vid.com/tools/trending_on_youtube, $0.02 USDC (x402/Base). R

>

Key entities: x402vid, x402vid, trending_on_youtube, pipeline, youtube

Table of Contents

• Question
• Answer in 30 seconds
• Copy-paste request
• Response shape (deterministic JSON)
• Pipeline pairing
• Try free first
• Key Takeaways

Question

Cheapest-path-first bundles: entry funnel to premium in one session.

Answer in 30 seconds

POST /tools/trending_on_youtube on https://x402vid.com. Price: $0.02 USDC per call (x402, Base eip155:8453). Best for: daily cron loops: $0.02/day per niche.

Copy-paste request

curl -s -X POST https://x402vid.com/tools/trending_on_youtube \
  -H 'Content-Type: application/json' \
  -d '{"region": "US", "niche": "YOUR NICHE", "num_videos": 10}'
# -> 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 today's most-popular videos, optionally niche-scored. 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.

Pipeline pairing

Cheapest path first: prove value with video_preview (free) and this endpoint, then graduate upward in the same session. Documented bundles: TopicDesk research ~$0.13, ShortsLab ~$0.07, RivalWatch ~$0.40, LaunchPad ~$1.50. Full machine spec: /skill-packs.json.

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

• trending_on_youtube costs $0.02/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-18-trending-on-youtube-pipeline • Raw: https://x402vid.com/raw/2026-09-18-trending-on-youtube-pipeline.md*