Competitor Ads Library Monitor — New & Ended Ads (Vigia)

Track a competitor's public Meta Ad Library and get alerted only when something actually changes: a new ad launches, a creative gets edited, an ad stops running, or a creative has run long enough to prove it's a winner, not a test. Vigia never scrapes Meta itself — it chains onto a licensed Meta Ad Library actor.

Why choose Vigia

• Only real changes, only charged for changes, at $0.020 — most Ad Library scrapers charge per ad extracted, every run, whether it's new intel or the same ad you already saw.
• Long-running-creative signal — Vigia tracks how many consecutive runs each ad has stayed live and flags long_running_creative once it crosses a threshold — the strongest signal that a competitor found a winner, not a test they're rotating out.
• New vs. changed vs. ended, precisely — a creative edit on an ad you've already seen is never silently dropped (a real bug class documented in NORME_VIGIA.md §3 that Vigia tests for explicitly).
• No fragile scraping — chains onto a licensed Meta Ad Library actor instead of a homegrown scraper fighting Meta's anti-bot.
• Fair pricing — hard maxTotalChargeUsd cap; baseline and unchanged ads are free, and a source outage never falsely reports ads as "ended" (see NORME_VIGIA.md §3).

Input

• pageNames — Facebook/Instagram Page names to track.
• 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 currentAds directly if you bring your own Ad Library export.

Output

One row per change: change_type (new/changed/ended), page_name, landing_url, runs_seen, long_running_creative, creative_fingerprint. Plus a RUN_SUMMARY.json with the aggregate ad_signal.

Pricing transparency

	Cost
Source (chained Meta Ad Library actor)	billed directly on your Apify invoice, not marked up
Vigia (delta, long-running-creative signal)	$0.020 per new/changed ad, $0 otherwise
Example: 30 ads tracked, nothing changed	source cost only, $0 Vigia charge
Example: 30 ads tracked, 2 new + 1 changed	source cost + $0.06 Vigia charge
Cap	maxTotalChargeUsd (Vigia's own charge only)

FAQ

Does this actor fetch ads from Meta itself? No — it chains onto a licensed Meta Ad Library actor and adds the delta/long-running-winner layer. Why track "ended" ads for free? An ad stopping is only meaningful with a healthy source — Vigia never bills a false "ended" alert caused by a source outage (it merges the snapshot instead of overwriting on failure). What counts as "long running"? An ad still live after enough consecutive monitored runs — a real signal it's winning, not being rotated out as underperforming.