Ad Creative Change Detector — Bring Your Own Ad Data (Vigia)

Compare two snapshots of ad creative data you already have (e.g. from your own Ads Library export or scraper) and get back only what changed: new creatives, ended ads, headline and landing-page edits. This Actor does not fetch ads itself — you supply currentAds (and optionally previousAds); it does the diffing, deduplication and change-detection. Charged per change event, not per run. Ideal for marketing and competitive-intel agents who already have ad data flowing in.

What this is NOT

This is a delta/change-detection engine, not a scraper. It never queries Meta Ad Library, TikTok, or any ad platform on its own — you provide the ad records (from your own pipeline, another Actor, or a manual export) and this Actor tells you what's new, changed, or gone since your last run. If you need the ads themselves collected first, see Facebook Ads Library Scraper or Google Ads Transparency Scraper below.

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

Track a competitor's creative rotation without paying to re-scan unchanged ads. 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-ad creative alerts are billed only for genuinely new ad creatives 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

{
  "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, ad_id, landing_url, runs_seen, long_running_creative, creative_fingerprint. A RUN_SUMMARY.json accompanies every run with the aggregated signal (counts, velocity spikes, trend).

How you're charged

• Ad creative alert — billed once per new ad creative (the only charge).
• Bring-your-own dataset — you pass the records in, so there is no upstream fetch and no source-check fee.
• A run with no new ad creatives costs $0.

---

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
Facebook Ads Library Scraper - Competitor Ad Data
Google Ads Transparency Scraper - Competitor Ads
Google Search Results Scraper - SERP Positions
[ATS Jobs Search API
[Hiring Signals
[Career Site Job Listing API