# YouTube Shorts Outlier Finder — Viral Score (`vanborn_labs/youtube-shorts-outlier-finder`) Actor

Find winning YouTube Shorts from URLs, channels, hashtags or search. Views, likes, comments, subscribers, views per hour and an outlier score versus the rest of the run. No API key, no browser. Export JSON, CSV or Excel. $1.20 per 1,000 Shorts.

- **URL**: https://apify.com/vanborn_labs/youtube-shorts-outlier-finder.md
- **Developed by:** [Van Born Labs](https://apify.com/vanborn_labs) (community)
- **Categories:** Videos, Social media, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 short results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## YouTube Shorts Outlier Finder — Viral Score

**YouTube Shorts Outlier Finder** finds the Shorts that are breaking out right now. Feed it Shorts URLs, a channel's Shorts tab, a hashtag or a search term and it returns views, likes, comments, channel subscribers, **views per hour**, engagement rate and an **outlier score** that compares each Short with the rest of the run.

It is the Shorts specialist of the Van Born Labs YouTube family. For long-form videos use the YouTube Video Details & Outlier Score Scraper.

### Website

Product page, pricing and docs: https://arkadiuszvanborn.com/labs

Part of Van Born Labs by Arkadiusz Van Born. Independent software. Support: arkadiuszvanborn@gmail.com

### What is YouTube Shorts Outlier Finder?

YouTube Shorts Outlier Finder is an Apify Actor by Van Born Labs. It runs in the cloud, so you can start it from the Apify Console, call it through the Apify API, schedule it, or plug it into Make, n8n, Zapier, Google Sheets and AI agents through the Apify MCP server. Results can be exported as JSON, CSV, Excel, XML or HTML.

#### Key features

- 🎬 Scrape Shorts from watch / Shorts URLs, bare video IDs, **channel Shorts tabs**, **hashtag pages** and **Shorts-only search**.
- 📈 **Views per hour**, views per day, like rate, comment rate and engagement rate ((likes + comments) / views).
- 🏆 **Outlier flags** compared with the median of the same run: views, views/hour and views-per-subscriber. Tune the threshold (default: 2× the median).
- 👤 Channel name, channel ID, subscriber count, publish date, duration, category, tags and thumbnails.
- 🎯 Caps per source and per run, so you never pay more than you planned.
- 🔑 No official API key. Lightweight HTTP, optional proxy only if YouTube starts blocking your run.

### What data can YouTube Shorts Outlier Finder extract?

| Field | What it means |
|---|---|
| `videoId` | Video ID |
| `url` | Watch URL |
| `shortsUrl` | Shorts URL |
| `title` | Title |
| `description` | Description |
| `channelName` | Channel name |
| `channelId` | Channel ID |
| `channelUrl` | Channel URL |
| `subscriberCount` | Subscribers |
| `viewCount` | Views |
| `likeCount` | Likes |
| `commentCount` | Comments |
| `publishDate` | Published at |
| `durationSeconds` | Duration (seconds) |
| `category` | Category |
| `tags` | Tags |
| `isShort` | Is Short |
| `thumbnailUrl` | Thumbnail |
| `ageHours` | Age (hours) |
| `viewsPerHour` | Views per hour — Views divided by age in hours (5-minute minimum). |
| `viewsPerDay` | Views per day |
| `likeRate` | Like rate |
| `commentRate` | Comment rate |
| `engagementRate` | Engagement rate — (likes + comments) / views when both are known. |
| `outlierScore` | Views per subscriber — viewCount / subscriberCount. |
| `viewsVsMedian` | Views vs median |
| `viewsPerHourVsMedian` | Views/hour vs median |
| `outlierScoreVsMedian` | Views/subscriber vs median |
| `isOutlier` | Is outlier — True when any ratio is at or above the threshold. |
| `outlierThreshold` | Outlier threshold used |
| `scrapedAt` | Scraped at |

### How to use YouTube Shorts Outlier Finder

1. Open the Actor and click **Try for free** (an Apify account is free and includes monthly platform credit).
2. Paste Shorts URLs, channels, hashtags (without #) or search terms and set the outlier threshold.
3. Click **Start** and wait for the run to finish. Small runs finish in seconds.
4. Download the results as JSON, CSV or Excel, or connect them to your app with the Apify API, a webhook or an integration.
5. To monitor changes, save your input as a task and add a **schedule** (hourly, daily or weekly).

### How much does it cost to use YouTube Shorts Outlier Finder?

This Actor uses **pay-per-event** pricing: **$1.20 per 1,000 Shorts** plus a tiny $0.00005 start fee per run. You only pay for Shorts actually returned; failed lookups are not charged. Platform usage is included in the price.

| Shorts | Price |
|---|---|
| 100 | $0.12 |
| 1,000 | $1.20 |
| 10,000 | $12.00 |

Apify's free plan includes $5 of monthly credit, which covers about **4,166 Shorts** with this Actor. Set **Max cost per run** in the run options if you want a hard spending cap.

### Use cases

- **Creator research**: open a niche search or a competitor's Shorts tab and sort by `isOutlier` / `viewsPerHour`.
- **Shorts strategy & SEO**: see which topics, hashtags and formats get outsized views for a given subscriber count.
- **Agency reporting**: export a clean JSON / CSV of a client's last N Shorts with engagement already calculated.
- **AI pipelines**: titles, descriptions, tags, dates and metrics as structured data, ready for clustering or briefs.

### Notes

- Shorts search and channel tabs occasionally mix in a long-form video. With **Keep Shorts only** on (the default), those rows are dropped and not charged.
- YouTube often returns LOGIN_REQUIRED on bare cloud IPs. The default input uses Apify datacenter proxy, with a residential retry only for blocked videos. Turn residential fallback off if you want to avoid any residential traffic.
- This Actor collects publicly available video metadata. Make sure your use complies with YouTube's terms and applicable law for your purpose.

### Input

Full field descriptions are on the **Input** tab. Example input (this is also the default run, which finishes in under a minute):

```json
{
  "videos": [
    "https://www.youtube.com/shorts/sHpEqeSByPI",
    "https://www.youtube.com/shorts/bkSNwyl7iHE"
  ],
  "maxItems": 2,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}
```

### Output

Each result is one row in the dataset. Example output item from a real run:

```json
{
  "videoId": "sHpEqeSByPI",
  "url": "https://www.youtube.com/watch?v=sHpEqeSByPI",
  "title": "Unboxing The World’s Largest Toy",
  "description": "",
  "channelName": "MrBeast",
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
  "channelUrl": "https://www.youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
  "subscriberCount": 527000000,
  "viewCount": 22527242,
  "likeCount": 337865,
  "commentCount": 8900,
  "publishDate": "2026-11-13T09:00:00-08:00",
  "uploadDate": "2026-11-13T09:00:00-08:00",
  "durationSeconds": 28,
  "category": "Entertainment",
  "tags": [],
  "chapters": [],
  "isLive": false,
  "isShort": true,
  "isFamilySafe": true,
  "isUnlisted": false,
  "hasCaptions": false,
  "captionLanguages": [],
  "thumbnailUrl": "https://i.ytimg.com/vi/sHpEqeSByPI/maxresdefault.jpg?sqp=-oaymwEoCIAKENAF8quKqQMcGADwAQH4AbYIgAKAD4oCDAgAEAEYLSBZKHIwDw==&rs=AOn4CLCV94OtW4_x-DvvbICqIioWU29jzw",
  "viewsPerDay": 4963917.4,
  "likeRate": 0.015,
  "commentRate": 0.000395,
  "outlierScore": 0.043,
  "scrapedAt": "2026-11-18T05:55:00.339135+00:00",
  "shortsUrl": "https://www.youtube.com/shorts/sHpEqeSByPI",
  "ageHours": 108.92,
  "viewsPerHour": 206826.7,
  "engagementRate": 0.01539,
  "medianViewsInRun": 22527242,
  "medianViewsPerHourInRun": 206826.7,
  "viewsVsMedian": 1,
  "viewsPerHourVsMedian": 1,
  "outlierScoreVsMedian": 1,
  "isOutlier": false,
  "outlierThreshold": 2
}
```

You can view results as a table in the Console, or get them from the API in JSON, CSV, Excel, XML or HTML.

### FAQ

#### Do I need a YouTube API key?

No. The actor reads public watch and Shorts data.

#### How is the outlier score calculated?

`outlierScore` is views ÷ subscribers (how hard a Short punches relative to the channel size). `isOutlier` is true when views, views/hour or that score is at least *threshold* times the **median of the same run** (default 2×). A run with one Short cannot flag an outlier against a peer group — add a channel, a search or several URLs.

#### Will this download the video file?

No. Metadata and public engagement only.

#### What if a channel URL has no /shorts tab in the input?

Bare @handles and channel URLs are sent to the Shorts tab automatically.

#### Can I use it through the API, MCP or integrations?

Yes. Every run is available through the Apify API and the official Python and JavaScript clients, and the Actor can be called by AI agents through the Apify MCP server. Integrations include Make, n8n, Zapier, Google Sheets, Slack and webhooks.

#### Is it legal to scrape this data?

The Actor only collects publicly available data and does not log in or bypass access controls. You are responsible for how you use the results: respect the source site's terms, copyright and privacy laws such as GDPR, and do not collect personal data without a legal basis. If in doubt, ask a lawyer.

#### Something did not work. What should I do?

Open an issue on the **Issues** tab with your run link. We usually answer within a day and fix breakages quickly.

### Other Van Born Labs Actors

| Actor | What it does |
|---|---|
| [YouTube Video Details & Outlier Score Scraper](https://apify.com/vanborn_labs/youtube-video-details-outlier-score) | YouTube video details scraper with an outlier score: views, likes, comments, subscribers, tags, chapters, views per day and engagement rate |
| [YouTube Comments Scraper — Replies, No API Key](https://apify.com/vanborn_labs/youtube-comments-scraper-fast) | YouTube comments scraper for comment text, replies, likes, authors, pinned and creator-hearted flags |
| [Clip Views & Earnings Tracker — TikTok, Shorts](https://apify.com/vanborn_labs/clip-views-earnings-tracker) | Track views, likes, comments and estimated payout for TikTok, YouTube Shorts and Instagram Reels URLs |
| [GTA 6 Viral Clips Tracker — YouTube & Shorts](https://apify.com/vanborn_labs/gta-6-viral-clips-trends-tracker) | Find the newest and fastest-growing GTA 6 / GTA VI videos on YouTube and Shorts: views, views per day, outlier score, keyword ideas, release countdown and new breakout clips since your last run |

More tools: [Van Born Labs on Apify](https://apify.com/vanborn_labs).

# Actor input Schema

## `videos` (type: `array`):

YouTube Shorts URLs, watch URLs, youtu.be links or bare 11-character video IDs.

## `channels` (type: `array`):

Channel URLs or @handles. Bare channels use the Shorts tab automatically. Add /videos if you really want the long-form tab.

## `hashtags` (type: `array`):

Hashtags to open on YouTube (with or without #), e.g. funny or #cooking.

## `searchTerms` (type: `array`):

YouTube search queries restricted to Shorts. Great for finding outliers in a niche.

## `maxVideosPerSource` (type: `integer`):

How many Shorts to take from each channel, hashtag or search term.

## `maxItems` (type: `integer`):

Hard cap on Shorts scraped and charged in this run.

## `outlierThreshold` (type: `number`):

A Short is flagged isOutlier when views, views/hour or views-per-subscriber are at least this many times the median of the run. 2 means twice the median.

## `shortsOnly` (type: `boolean`):

Drop long-form videos that slipped in from a search or channel tab. Explicit video URLs are still returned if nothing else qualifies.

## `maxConcurrency` (type: `integer`):

Parallel requests. Keep modest to stay polite.

## `proxyConfiguration` (type: `object`):

Apify Proxy (datacenter) is recommended on the platform so YouTube does not return LOGIN_REQUIRED. Leave residential groups off unless a run is still blocked.

## `residentialFallback` (type: `boolean`):

If datacenter proxy is still blocked (LOGIN_REQUIRED), retry once through residential. Recommended on the platform so daily runs stay green. Residential traffic is billed, but metadata requests are tiny.

## Actor input object example

```json
{
  "videos": [
    "https://www.youtube.com/shorts/sHpEqeSByPI",
    "https://www.youtube.com/shorts/bkSNwyl7iHE"
  ],
  "channels": [],
  "hashtags": [],
  "searchTerms": [],
  "maxVideosPerSource": 30,
  "maxItems": 2,
  "outlierThreshold": 2,
  "shortsOnly": true,
  "maxConcurrency": 8,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}
```

# Actor output Schema

## `results` (type: `string`):

One item per Short: metadata, views, engagement, views per hour and outlier flags.

## `runSummary` (type: `string`):

JSON counters stored as RUN_SUMMARY.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videos": [
        "https://www.youtube.com/shorts/sHpEqeSByPI",
        "https://www.youtube.com/shorts/bkSNwyl7iHE"
    ],
    "channels": [],
    "hashtags": [],
    "searchTerms": [],
    "maxItems": 2,
    "proxyConfiguration": {
        "useApifyProxy": true
    },
    "residentialFallback": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("vanborn_labs/youtube-shorts-outlier-finder").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "videos": [
        "https://www.youtube.com/shorts/sHpEqeSByPI",
        "https://www.youtube.com/shorts/bkSNwyl7iHE",
    ],
    "channels": [],
    "hashtags": [],
    "searchTerms": [],
    "maxItems": 2,
    "proxyConfiguration": { "useApifyProxy": True },
    "residentialFallback": True,
}

# Run the Actor and wait for it to finish
run = client.actor("vanborn_labs/youtube-shorts-outlier-finder").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videos": [
    "https://www.youtube.com/shorts/sHpEqeSByPI",
    "https://www.youtube.com/shorts/bkSNwyl7iHE"
  ],
  "channels": [],
  "hashtags": [],
  "searchTerms": [],
  "maxItems": 2,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "residentialFallback": true
}' |
apify call vanborn_labs/youtube-shorts-outlier-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vanborn_labs/youtube-shorts-outlier-finder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/1kG9SKP2L72NsDUne/builds/BJDmDpDEkFF8oZ5FY/openapi.json
