↑
Zio Advertising

Free Python script

Find the small channel whose video is about to blow up.

A one-file script that scans YouTube for videos massively outperforming their own channel: ranked by views per subscriber, then confirmed against that channel's typical video. Runs on a free Google API key. No subscription, no credits to buy.

Free: copy-paste ready. If it saves you time, buy me a coffee (optional).

Quick answer

A YouTube outlier finder is a tool that ranks videos by how far they beat their own channel's normal size, not by raw view count. This one runs on YouTube's own Data API, is free to use with your own API key, and ranks results by views divided by subscribers, confirmed against the channel's median views so a channel that is just big doesn't crowd out a real breakout.

This is for you if

  • ✓You make YouTube videos and want to know what’s already working in your niche
  • ✓You run content or marketing for a client and need topic ideas backed by real numbers
  • ✓You are tired of paying per-search credits on a tool that does the same math
  • ✓You want the ranking logic in a file you can read, not a black box

Skip it if

  • ×You want a hosted dashboard with no setup at all
  • ×You need results for channels over 100k subs (this is tuned to find small breakouts)
  • ×You are not comfortable running one command in a terminal

How it ranks

Views ÷ subscribers, confirmed against the channel's own median.

Why raw view count lies to you

  • A 2-million-subscriber channel hitting 500,000 views is normal, not an outlier
  • A 4,000-subscriber channel hitting 500,000 views is something unusual happening
  • Most "trending" lists only sort by raw views, so they miss the second case entirely

What the script checks instead

  • Searches your keyword, pulls view counts, subscriber counts, and channel age for every hit
  • Ranks by views ÷ subscribers first, then checks each candidate against that channel's own median recent-video views
  • Flags LOW-ENG (likely bought views) and HOT (still climbing right now, 1,000+ views/hour)
SCAN: "claude code" --days 90 --max-subs 100000

TOP HIT
━━━━━━━
Channel subs:    ~4,400
Video views:     980,000
Views / subs:    224x
vs channel median: confirmed breakout, not a fluke upload
Flags:           HOT (still climbing)

What this means: a channel this size normally tops out in the
low thousands of views. One video did 224x that. Something in
the title, thumbnail, or topic made this one travel.

That is the exact shape of a result worth opening: a small channel, a view count that does not match its size, and a flag telling you whether the video is still growing.

Setup

Get a free API key, then run one command.

  1. 1

    Create a Google Cloud project

    Free, no credit card. console.cloud.google.com, then New Project.

  2. 2

    Enable the YouTube Data API v3

    APIs & Services → Library → search for it → Enable.

  3. 3

    Create and restrict an API key

    APIs & Services → Credentials → Create Credentials → API key, then restrict it to the YouTube Data API only.

  4. 4

    Paste the key into .env

    Unzip the download, copy .env.example to .env, paste YOUTUBE_API_KEY=your-key-here.

Three commands to start with

uv run outliers.py "claude code" "ai agents"
# long-form, last 90 days, channels under 100k subs

uv run outliers.py "seiko mod" --shorts --days 30
# Shorts only, last 30 days

uv run outliers.py "claude code" --transcripts 5
# also saves transcripts of the top 5 hits, for script research

Full setup walkthrough with every option explained: see the setup guide.

The report

How to read it, and what it costs to run.

Column / flagWhat it means
ratio (views ÷ subs)10x or more is worth a look. 50x or more is a real breakout.
vs channel medianViews on this video compared to that channel's typical recent upload. Confirms the hit wasn't just a channel that always does big numbers.
LOW-ENGLikes + comments are under 1% of views. Possibly bought or bot views, treat with caution.
HOT1,000+ views per hour right now. Still climbing, not a breakout that already peaked.

Free quota

YouTube gives every project 10,000 free API units a day. A keyword search costs 100 units and everything else is cheap, so one scan runs about 130 units. That is roughly 75 scans a day, free, every day, with no subscription.

What this replaces

Most paid outlier or research tools charge per search, often around 5 credits a search, so a day of real digging can burn through a plan fast. This runs on your own key, so the only limit is Google's free daily quota, not a bill.

Get it

Get the YouTube Outlier Finder

One Python file, the README, the MIT license, and the .env template. No account, no email, no watermark.

Free: copy-paste ready. If it saves you time, buy me a coffee (optional).

FAQ

Common questions about the YouTube outlier finder

What counts as a YouTube outlier?+
A video that massively outperforms the channel that posted it. The script ranks every result by views divided by subscribers, then checks that number against the channel’s own median views on its recent uploads. A channel with 4,400 subscribers and a video at 980,000 views is a 224x outlier on the subs ratio, and the median check confirms it was a real breakout, not just a channel that always does big numbers.
How is this different from VidIQ or other paid outlier tools?+
Paid outlier and research tools typically charge credits per search, often around 5 credits a search depending on the plan, and that cost adds up fast if you are scanning more than a handful of niches a week. This script runs on your own free YouTube Data API key: Google gives you 10,000 units a day, and a scan costs about 130, so you get roughly 75 scans a day for free, forever, with no subscription and no credit limit you have to watch.
What do LOW-ENG and HOT mean in the report?+
LOW-ENG flags a video where likes plus comments add up to under 1% of its views, which can mean bought or bot views rather than a real audience, so treat those hits with more caution. HOT flags a video currently getting 1,000 or more views per hour, meaning it is still actively climbing right now, not a breakout that already peaked weeks ago.
Do I need to know how to code to run this?+
You need to be comfortable typing a few commands into a terminal, but no programming knowledge is required. Install uv (one command, one-time), paste your free API key into a text file, then run the script with your search term in quotes. The README has the exact commands, and the setup guide walks through the whole thing.
Can I use this for niches other than Claude Code or AI tools?+
Yes. Swap the keywords for anything: "seiko mod", "sourdough bread", "cold plunge", your own niche. The ranking logic (views per subscriber, confirmed against the channel’s median) works the same regardless of topic.

Want this kind of system built for your business?

This script took one sitting with Claude Code. If you want research tools, dashboards, or AI workflows built for your own business and owned by you, that is what I do for clients.

Book a Call

More free tools

Other free kits from the same playbook

Analytics

GA4 Watcher

A free daily Google Analytics anomaly watcher that emails you only when a site breaks or recovers.

Video

Claude Video Editor Agent

The Claude Code agent kit that cut a 33-minute video down to 14, by itself.

Library

All Downloads & Tools

Every free and paid kit Zio has built, in one place.

Zio team member

Got a quick question?

Giuseppe usually replies within a few hours

Or email us at sep@zioadvertising.com