Scrapes Meta's public Ad Library and returns structured ad data. Four lookup modes (page_id, page_url, keyword, batch), opt-in pagination, schema-validated output.
All notable changes to this actor are documented here. Format loosely follows Keep a Changelog ; the actor follows semantic versioning over the output contract.
[0.2] — 2026-05-16
Added
match_type input field ("broad" | "exact", default "broad"). "broad" maps to Meta's search_type=keyword_unordered (current behavior, no change for existing runs); "exact" maps to search_type=keyword_exact_phrase. Applies to keyword, page_url, and batch modes; ignored for page_id mode.
Changed
max_session_rotations raised from the Crawlee default of 10 to 30, giving each query up to 30 fresh datacenter IPs from BUYPROXIES94952 before failing. Helps transient 403 blocks clear without escalating to residential proxy.
Fixed
Output schema templates use links.apiDefault* instead of the non-existent links.publicDefault*, so the Output tab now renders dataset and run-summary links.
[1.0.0] — Unreleased
Initial public release.
Added
Four lookup modes (page_id, page_url, keyword, batch) with per-mode input validation.
page_url resolution via keyword + page_profile_uri handle-match filter — never silently returns a near-match.
Per-item output schema (28 fields) including lifecycle dates (start_date, end_date) extracted from Meta's SSR.
Opt-in pagination (follow_pagination) with hard cap (max_ads_per_advertiser, 1–500).
Pydantic schema validation with non-silent _validation_errors envelope.
Per-run summary written to KV store as OUTPUT.json (block rate, validation error rate, per-advertiser totals + cursors, warnings).
