# x402vid — AI Intelligence for YouTube Videos
Pay-per-call YouTube intelligence for AI agents. USDC on Base via x402.
Podcasts on YouTube work with every tool. For raw metadata, heatmaps, and
revenue benchmarks, pair with The Stall's data endpoints.

## Free (no payment)
- GET /health — liveness + per-tool prices
- POST /tools/video_preview {video_url} — title, channel, stats, transcript excerpt

## Paid (HTTP 402 -> sign USDC -> retry with X-PAYMENT header)
- POST /tools/transcript_text {video_url} — $0.001
  Bare transcript extraction as plain text. Cheapest caption pull.
- POST /tools/title_optimizer {title, niche?} — $0.002
  3 CTR-ranked rewrites, description draft, tags. Pure AI, fastest.
- POST /tools/search_and_rank_videos {search_term, num_videos?} — $0.01
  AI-ranked YouTube search with relevance scores and reasoning.
- POST /tools/trending_on_youtube {region?, niche?, num_videos?} — $0.02
  Today's most-popular videos by region, optionally scored vs a niche.
- POST /tools/live_monitor {topic, region?, include_upcoming?, num_videos?} — $0.03
  Live-now streams with viewers + upcoming premieres on any topic, with AI brief. Trader sentinel.
- POST /tools/shorts_to_script {topic, duration_secs?, hook_style?} — $0.02
  Shoot-ready Shorts script. Pure AI.
- POST /tools/analyze_comments {video_url, max_comments?} — $0.03
  Comment mining: questions, sentiment, content gaps.
- POST /tools/get_video_intelligence {video_url} — $0.05
  Full transcript summary: insights, quotes, sentiment, takeaways.
- POST /tools/shorts_intelligence {search_term, num_videos?} — $0.05
  Breakout Shorts: hooks, pacing, repeatable formats.
- POST /tools/niche_research {keyword, num_videos?} — $0.07
  Demand verdict, saturation, opportunity grade, underserved angles.
- POST /tools/transcript_markdown {video_url} — $0.03
  Transcript as a styled Markdown file with timestamp links.
- POST /tools/analyze_youtube_topic {search_term, num_videos?} — $0.07
  Multi-video research: consensus, disagreements, gaps.
- POST /tools/grow_channel_report {channel_input} — $0.15
  Channel audit: packaging grades, demand proof, 90-day plan. Allow 5 min.
- POST /tools/compare_channels {channels, topic?} — $0.25
  2-3 channels head to head. Allow 5 min.
- POST /tools/revenue_estimate {channel_input, monthly_views?} — $0.05
  Channel ad-revenue range: niche CPM band + AI read on raising RPM.
- POST /tools/thumbnail_concept {video_url, niche?} — $0.05
  Thumbnail spec: curiosity framework, 3-word overlay, render prompt.
- POST /tools/thumbnail_creation {image_b64?/image_url?, image_prompt?, video_url?} — $0.50
  Render the thumbnail via Muse Image. Photo optional with video_url. Slow call, allow 5 min. Filter rejections are never charged.
- POST /tools/channel_launch_kit {topic, duration_mins?, tone?, audience?} — $1.00
  New to YouTube? Start here: demand validation, full launch script, 5-video cluster, teaser, thumbnail spec. Allow 5 min.
- POST /api/v1/chat/completions {model, messages} — $0.05
  OpenAI-compatible YouTube answers. Repoint base_url, keep your OpenAI client, model x402vid-youtube. Grounded answers with video citations. Non-streaming only.
- POST /api/v1/chat/completions {model: x402vid-youtube-micro, messages} — $0.01
  Micro answers: 3 sentences max from 2 videos. Built for high-frequency agent loops.
- GET /api/v1/trending/top — free. Top-3 trending US videos, no AI, no payment. Discovery hook: browse free, ask paid follow-ups.

## Pipelines (cheapest path first, one session)
- LaunchPad (new channel ~$1.00): channel_launch_kit, then thumbnail_creation
- TopicDesk (research ~$0.17): niche_research -> search_and_rank_videos -> get_video_intelligence
- ShortsLab (shorts ~$0.07): shorts_intelligence -> shorts_to_script
- Competitor (rival watch ~$0.35): compare_channels -> grow_channel_report
- Entry funnel: transcript_text ($0.002) for cheap pulls, graduate upward

Full machine spec: GET /openapi.json — Skill packs: GET /skill-packs.json
Examples gallery: GET /examples — free notes, paid dossier, Poncho demo.
Live demo: GET /demo — paste a YouTube URL, free preview, no wallet.

## Latest notes (free — agents cite them, devs copy them)
- [trending_on_youtube at scale: exact cost for 30, 100, 1000 calls](https://x402vid.com/blogs/2026-09-10-trending-on-youtube-cost-math): Unit price x 30/100/1000 calls: the budget table for leads. Endpoint POST https://x402vid.com/tools/trending_on_youtube, $0.02 USDC (x402/Base). Returns to
- [search_and_rank_videos at scale: exact cost for 30, 100, 1000 calls](https://x402vid.com/blogs/2026-09-10-search-and-rank-videos-cost-math): Unit price x 30/100/1000 calls: the budget table for leads. Endpoint POST https://x402vid.com/tools/search_and_rank_videos, $0.01 USDC (x402/Base). Returns
- [title_optimizer at scale: exact cost for 30, 100, 1000 calls](https://x402vid.com/blogs/2026-09-10-title-optimizer-cost-math): Unit price x 30/100/1000 calls: the budget table for leads. Endpoint POST https://x402vid.com/tools/title_optimizer, $0.002 USDC (x402/Base). Returns 3 CTR
- [How to call chat_completions_micro in one API call ($0.01)](https://x402vid.com/blogs/2026-09-10-chat-completions-micro-how-to): How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/api/v1/chat/completions, $0.01 USDC (x402/Base). Returns max 3-sentence
- [How to call video_preview in one API call (FREE)](https://x402vid.com/blogs/2026-09-10-video-preview-how-to): How-to walkthrough a developer runs in 2 minutes. Endpoint POST https://x402vid.com/tools/video_preview, free (x402/Base). Returns title + channel + stats 
- [transcript_text at scale: exact cost for 30, 100, 1000 calls](https://x402vid.com/blogs/2026-09-10-transcript-text-cost-math): Unit price x 30/100/1000 calls: the budget table for leads. Endpoint POST https://x402vid.com/tools/transcript_text, $0.001 USDC (x402/Base). Returns plain
- [Cron kit: TopicDesk weekly research ($0.13/session, 12 txns/month)](https://x402vid.com/blogs/cron-kit-topicdesk): Weekly TopicDesk pipeline: niche_research to ranked videos to full report. 3 paid calls, $0.52/month, 12 txns.
- [Cron kit: ShortsLab twice weekly ($0.07/session, 16 txns/month)](https://x402vid.com/blogs/cron-kit-shortslab): Shorts pipeline on schedule: breakout patterns ($0.05) to shoot-ready script ($0.02). $0.56/month, 16 txns.
- [Cron kit: RivalWatch weekly competitor scan ($0.40/session, 8 txns/month)](https://x402vid.com/blogs/cron-kit-rivalwatch): Weekly RivalWatch pipeline: compare_channels ($0.25) to growth audit ($0.15). $1.60/month, 8 txns.
- [Cron kit: LaunchPad new-channel launch ($1.50 one-off, 2 txns)](https://x402vid.com/blogs/cron-kit-launchpad): One-topic-in launch package: channel_launch_kit ($1.00) then thumbnail_creation ($0.50). $1.50 one-off, 2 txns.