Facebook Ads Scraper

Scrape ads from the Meta (Facebook) Ad Library. Accepts Facebook Page URLs or Meta Ad Library search URLs (with filters) and returns structured ad data.

How it works

Instead of scraping rendered HTML, this Actor queries the Ad Library internal GraphQL endpoint (AdLibrarySearchPaginationQuery) directly and paginates through results using the connection cursor. This is faster and returns the full structured snapshot for each ad.

Input

• startUrls – one or more Facebook Page URLs or Meta Ad Library URLs.
• resultsLimit – max ads per URL (empty = as many as possible).
• activeStatus – active, inactive, or both (used if not in the URL).
• sorting – default / impressions / relevance (used if not in the URL).
• isDetailsPerAd – include per-ad detail (reach, spend, Instagram data).
• includeAboutPage – include page About / transparency data.
• onlyTotal – return only the total ad count per page.
• onlyAdsNewerThan / onlyAdsOlderThan – date filters on ad start date.

Output

Each dataset item is one ad, including pageId, adArchiveId, isActive, publisherPlatform, startDateFormatted / endDateFormatted, spend, reachEstimate, and a nested snapshot object with the creative (title, body, cards, images, videos, CTA, link).

Notes

Facebook aggressively rate-limits and blocks datacenter IPs. Residential proxies are strongly recommended (configured by default).