YouTube Intelligence API
for AI Agents

Content gap analysis, title scoring, thumbnail intelligence, and hook classification, delivered via API and MCP server. The intelligence layer that vidIQ and TubeBuddy never built.

Get Your Free API Key

Free tier available. No credit card required.

Works with every major agent framework

OpenClaw
OpenAI Agents
LangGraph
OpenHands
OpenDevin

The gap

YouTube has 31 million channels. Zero intelligence APIs.

vidIQ

vidIQ

20M users

No public API

Dashboard only

No programmatic access

TubeBuddy

TubeBuddy

10M users

No public API

Chrome extension only

No agent integration

YouTube

YouTube Data API

Free, official

Raw metrics only

No scoring or optimization

No intelligence layer

Every other marketing vertical has API-first intelligence. SEO has Semrush and DataForSEO. Ads have Foreplay. YouTube has nothing. Until now.

How It Works

Your AI agent requests intelligence. Gets structured data back. Generates winning YouTube content.

Your AI Agent
BrightBean
BrightBean
1

Ask

"Find underserved topics in the home cooking niche with high search demand on YouTube"

2

Get

{
  "content_gaps": [
    {
      "topic": "5-ingredient slow cooker meals under $3",
      "demand_score": 87,
      "monthly_searches_est": 12400,
      "competing_videos_above_10k_views": 3,
      "opportunity_rating": "high",
      "suggested_title": "5 Slow Cooker Meals Under $3 (Only 5 Ingredients)",
      "suggested_hook_type": "result_first"
    },
    {
      "topic": "meal prep for night shift workers",
      "demand_score": 74,
      "monthly_searches_est": 8200,
      "competing_videos_above_10k_views": 1,
      "opportunity_rating": "very_high",
      "suggested_title": "Night Shift Meal Prep Nobody Talks About",
      "suggested_hook_type": "identity_callout"
    }
  ],
  "niche": "home cooking",
  "videos_analyzed": 14720
}
3

Build

Your agent uses this to generate scripts, thumbnails, and publishing schedules backed by real demand data, not guesswork.

Four endpoints. Structured intelligence. Zero guesswork.

Endpoint 1

/v1/research/content-gaps

Find what to make next

Input a niche, get the topics with proven search demand and thin competition. Each comes ranked by an opportunity score, with title angles you can publish.

/v1/research/content-gaps
{
  "niche": {
    "slug": "bird_watching_nature",
    "name": "bird watching nature"
  },
  "gaps": [
    {
      "canonical_title": "How to Clip Your Chicken's Wings",
      "opportunity_score": 100,
      "gap_type": "underserved",
      "components": {
        "demand": 0.39,
        "supply": 0.0,
        "recency": 1.0
      },
      "suggested_angles": [
        "How to Clip Chicken Wings: A Step-by-Step Tutorial",
        "5 Common Mistakes When Trimming Flight Feathers"
      ]
    }
  ]
}

Endpoint 2

/v1/score/packaging

Grade your packaging before you publish

Submit a title and thumbnail, see in what CTR niche percentile they will land, with the niche detected automatically.

/v1/score/packaging
{
  "score": 0.41,
  "percentile": 41,
  "mode": "combined",
  "niche_label": "ai business automation",
  "niche_confidence": 0.83
}

Endpoint 3

/v1/score/video-hook

Score the first seconds of your video

Submit a video, get its hook archetype, sub-scores across clarity, tension, and pace, and specific fixes to lift retention.

/v1/score/video-hook
{
  "primary_archetype": "empathy",
  "secondary_archetype": "negative_framing",
  "scores": {
    "clarity": 9,
    "specificity": 6,
    "tension": 7,
    "visual_energy": 7,
    "pace": 8
  },
  "overall_score": 75,
  "suggestions": [
    "Replace 'insert skill issue' with a specific, painful consequence."
  ]
}

Endpoint 4

/v1/benchmark/video

See how a video stacks up

Submit a video, get its engagement percentiles against the niche, how strongly it matches, and whether its title fits what wins there.

/v1/benchmark/video
{
  "video": {
    "title": "AI era skills: Why cultivating agency matters...",
    "channel_title": "Lenny's Podcast",
    "view_count": 47608,
    "engagement_percentiles": {
      "like_to_view_ratio": 51,
      "comment_to_view_ratio": 57,
      "overall": 46
    },
    "title_patterns": { "fits_niche_patterns": false }
  },
  "niche": {
    "name": "ai business automation",
    "match_strength": "strong"
  }
}

Who it's for

Built for the tools that build YouTube channels

For AI Agent Developers

Give your agent YouTube intelligence

Building a content planning agent? A video optimization workflow? Your agent needs data it can act on, not raw metrics.

For Agencies

Scale creative decisions across channels

Your team manages multiple YouTube channels across niches. Every title, thumbnail, and content calendar is a manual decision.

For YouTube SaaS Tools

Embed intelligence into your product

Building a YouTube scheduling tool? An analytics dashboard? A creator CRM? Your users expect optimization intelligence. Don't build a scoring engine from scratch

Simple, predictable pricing. Start free.

Free

$0/month

  • 350 credits
  • All endpoints included
  • MCP server access

Perfect for: Testing and personal projects

Start Free

Hobby

$19/month

  • 6,000 credits/month
  • All endpoints included
  • Community support

Perfect for: Side projects and indie creators

Get Started
Recommended

Standard

$99/month

  • 33,000 credits/month
  • Priority support
  • Webhook notifications

Perfect for: Agencies and power users

Get Started

Growth

$399/month

  • 150,000 credits/month
  • Dedicated support
  • Custom niche models & volume SLA

Perfect for: SaaS tools and high-volume platforms

Get Started

All plans include REST API + MCP server access. No setup fees. Cancel anytime.

Works with everything. Ships in minutes.

MCP Configuration
{
  "mcpServers": {
    "brightbean": {
      "url": "https://api.brightbean.xyz/mcp",
      "headers": {
        "Authorization": "Bearer bb_YOUR_API_KEY"
      }
    }
  }
}
REST API
curl -G https://api.brightbean.xyz/v1/research/content-gaps \
  -H "Authorization: Bearer bb_YOUR_API_KEY" \
  --data-urlencode "niche=ai-business-automation"

Compatible with your stack

Claude Desktop
/ Claude Code
OpenAI Agents SDK
OpenAI
Agents SDK
LangChain / LangGraph
LangChain
/ LangGraph
CrewAI
Any MCP
client
Any HTTP
client
Is this an analytics dashboard? +

No. BrightBean is a structured intelligence layer that AI agents and developer tools call via API or MCP. You get scores, recommendations, and structured data, not charts.

How fast can I get started? +

Under 5 minutes. Get an API key, add the MCP config or make your first curl request. No SDK installation required.

Can I use this for multiple YouTube channels? +

Yes. One API key works across unlimited channels and niches.

Where does the intelligence come from? +

We analyze tens of thousands of YouTube videos per niche: titles, thumbnails, transcripts, engagement patterns. Our scoring models are trained on empirical performance data, not LLM opinions.

What about the YouTube Data API - why not just use that? +

The YouTube Data API gives you raw metrics (views, likes, subscriber counts). It tells you what happened. BrightBean tells you what to do: scores, recommendations, content gaps, and optimization suggestions. We use the YouTube API as one data source among many to build the intelligence layer on top.

The YouTube intelligence layer is here.

Start with 350 free credits. No credit card. No sales call. Just build.