# 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
- POST /tools/transcript_text {video_url} — bare transcript as plain text
- POST /tools/transcript_markdown {video_url} — transcript as Markdown file
- POST /tools/title_optimizer {title, niche?} — 3 rewrites, description, tags
- POST /tools/batch_transcripts {video_ids, playlist_url?, max_n?} — up to 20 transcripts + metadata
- POST /api/v1/quote {tool?, endpoint?} — free price estimate, no payment

## Paid (HTTP 402 -> sign USDC -> retry with X-PAYMENT header)
- 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/video_performance_score {video_url} — $0.015
  Engagement rate plus S/A/B/C tier plus exactly 3 fixes.
- POST /tools/keyword_autocomplete {seed_topic, region?, lang?} — $0.02
  Autocomplete keyword mining: frequency-ranked phrases with intent clusters.
- 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/comment_replies {video_url, max_threads?, max_replies_each?} — $0.03
  Reply-thread mining: debates, splits, unanswered questions.
- 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/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.03
  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 (free) for caption pulls, graduate to $0.01 paid calls

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)
- [Weekly niche roundups on autopilot with shorts_to_script](https://youtube.x402vid.com/blogs/2026-11-03-shorts-to-script-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/shorts_to_script, $0.02 USDC (x402/Base). Ret
- [Weekly niche roundups on autopilot with keyword_autocomplete](https://youtube.x402vid.com/blogs/2026-11-03-keyword-autocomplete-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/keyword_autocomplete, $0.02 USDC (x402/Base).
- [Weekly niche roundups on autopilot with trending_on_youtube](https://youtube.x402vid.com/blogs/2026-11-03-trending-on-youtube-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/trending_on_youtube, $0.02 USDC (x402/Base). 
- [Weekly niche roundups on autopilot with live_monitor](https://youtube.x402vid.com/blogs/2026-11-03-live-monitor-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/live_monitor, $0.03 USDC (x402/Base). Returns
- [Weekly niche roundups on autopilot with title_optimizer](https://youtube.x402vid.com/blogs/2026-11-02-title-optimizer-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/title_optimizer, free (x402/Base). Returns 3 
- [Weekly niche roundups on autopilot with search_and_rank_videos](https://youtube.x402vid.com/blogs/2026-11-02-search-and-rank-videos-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/search_and_rank_videos, $0.01 USDC (x402/Base
- [Weekly niche roundups on autopilot with title_optimizer](https://youtube.x402vid.com/blogs/2026-11-01-title-optimizer-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/title_optimizer, free (x402/Base). Returns 3 
- [Weekly niche roundups on autopilot with search_and_rank_videos](https://youtube.x402vid.com/blogs/2026-11-01-search-and-rank-videos-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/search_and_rank_videos, $0.01 USDC (x402/Base
- [Weekly niche roundups on autopilot with transcript_text](https://youtube.x402vid.com/blogs/2026-11-01-transcript-text-curator): Curator loop: rank weekly winners, publish without watching anything. Endpoint POST https://x402vid.com/tools/transcript_text, free (x402/Base). Returns pl
- [Monitoring crypto YouTube sentiment with batch_transcripts (FREE/call)](https://youtube.x402vid.com/blogs/2026-11-01-batch-transcripts-trader): Autonomous-trader loop: cron the endpoint, flag keywords before humans. Endpoint POST https://x402vid.com/tools/batch_transcripts, free (x402/Base). Return