YouTube Video Watch — Viral Velocity Alerts (Vigia)

Track a YouTube channel's videos and get alerted only when something actually changes: new videos posted, and a view-count jump far above a video's normal pace — the earliest signal a video is going viral.

Free tier — 10 results free on every run

The first 10 results of every run are free, on every run you ever make — not a one-off trial. Run it on your own subjects and see the real output before you are billed for a single result.

One guard: the free allowance never covers more than half of a run, so a run returning 6 results gets 3 free. That keeps the offer sustainable.

What it does

Get alerted to a channel's new video uploads. You get only what changed since your last check — never a full re-dump to diff yourself.

Why Vigia — 5 advantages a raw scraper can't match

1. You pay the alert price only for real change. New-video alerts are billed only for genuinely new videos since your last check. A quiet run bills just the small source-check fee (the cost of looking) — never the alert price on unchanged data. Raw scrapers bill every row of a full re-scan every run.
2. Never billed on a failed source. The source check is charged only when the source actually responded. If it's down, you don't pay for our outage.
3. Append-only delta + spike signal. The first monitored run stores a free baseline; later runs deliver only what's new, plus a velocity-spike alert when volume suddenly surges (trend / review-bomb / hiring-surge).
4. Hard cost cap you control. Set maxTotalChargeUsd and the run can never bill above it — predictable spend, no surprise invoice.
5. Agent-ready output. Clean, normalized rows and a RUN_SUMMARY.json with ready-to-use signals — chainable from any MCP / A2A agent in one step.

Example input

{
  "channels": [
    "@MrBeast",
    "@mkbhd"
  ],
  "monitorEnabled": true,
  "maxTotalChargeUsd": 1.0
}

Set monitorEnabled: true so the first run stores a free baseline and later runs return only new results. Pin a monitorId to keep separate targets from sharing state.

Output

Each row is a normalized change record: record_id, change_type, title, view_count, previous_view_count, view_count_change_pct, magnitude, viral_velocity, url. A RUN_SUMMARY.json accompanies every run with the aggregated signal (counts, velocity spikes, trend).

How you're charged

• Video alert — billed once per new video since the last check (this is the only charge that scales with change).
• Source check ($0.05) — billed once per monitored target per run, only when the source responded. A failed source is free.
• A quiet run bills only the source check ($0.05), never the alert price. Vigia never scrapes the source itself; it chains a licensed scraper, caps every call, and passes you only the delta.

---

Part of the Vigia monitoring suite — change-only billing, outage-safe, agent-ready.

Related scrapers

Same data, other sources — all with the same free tier, the same clean schema and the same pay-only-for-what-you-get billing:

Actor
Instagram Hashtag Scraper - Posts & Engagement
TikTok Search Scraper - Videos by Keyword
Facebook Page Scraper - Info, Followers & Contacts
Facebook Page Posts Scraper - Posts & Engagement
X (Twitter) Search Scraper - Posts by Keyword
Instagram & TikTok Profile Scraper - Follower Stats