YouTube Video Watch — Viral Velocity Alerts (Vigia)

Track a YouTube channel's videos and get alerted only on what matters: new videos posted, and a view-count jump on one check far above that video's own normal pace — the earliest signal a video is taking off. Vigia never scrapes YouTube itself — it chains onto a licensed YouTube channel-videos actor.

Why choose Vigia

• Only meaningful changes, only charged for changes, at $0.010 — view counts drift by nature on every single check; Vigia only delivers and bills a view-count move once it clears a real magnitude threshold (moderate/major/viral), never a 3-view noise blip.
• Viral-velocity detection — the killer feature: Vigia remembers each video's own historical view-jump pace and flags viral_velocity when a check's jump is ≥3x that baseline — the earliest signal a video is breaking out, not a general-purpose video scraper's feature.
• Video-level, not just channel-level — Vigia's existing social monitor tracks channel-wide follower counts; this one goes one level deeper into individual video performance.
• No fragile scraping — chains onto a licensed YouTube channel-videos actor.
• Fair pricing — hard maxTotalChargeUsd cap; baseline and unchanged/minor-noise videos are free.

Input

• channels — YouTube channel handles to track (e.g. @channelname).
• monitorEnabled / monitorId — persistent delta mode; first run is a free baseline.
• maxTotalChargeUsd — hard spend cap for Vigia's own change charge.

You can also pass currentVideos directly if you bring your own video export.

Output

One row per meaningful change: change_type (new/views_updated/removed), title, view_count, previous_view_count, view_count_change_pct, magnitude, viral_velocity, url. Plus a RUN_SUMMARY.json with the aggregate video_signal.

Pricing transparency

	Cost
Source (chained YouTube channel-videos actor)	billed directly on your Apify invoice, not marked up
Vigia (delta, viral-velocity signal)	$0.010 per meaningful new/view-jump video, $0 otherwise
Example: 25 videos tracked, only minor view drift	source cost only, $0 Vigia charge
Example: 25 videos tracked, 1 new video + 1 viral jump	source cost + $0.02 Vigia charge
Cap	maxTotalChargeUsd (Vigia's own charge only)

FAQ

Does this actor fetch videos from YouTube itself? No — it chains onto a licensed YouTube channel-videos actor and adds the delta/viral-velocity layer. Why doesn't every view-count tick get billed? View counts change constantly by nature — billing every tick would be noise, not signal. Vigia only bills once a jump clears a real magnitude threshold. What counts as "viral velocity"? A single check's view-count jump reaching at least 3x that video's own largest jump seen so far — a real acceleration, not just a bigger absolute number on a big video.