Facebook Ads Library Scraper - Meta Ad Creative Monitor

Scrape public Meta/Facebook Ads Library results by keyword, Ads Library URL, or Facebook Page ID. Extract competitor ad copy, creatives, CTAs, landing pages, start dates, active status, and ad snapshot URLs.

Built for media buyers, agencies, DTC brands, SaaS marketers, growth teams, and competitive intelligence workflows.

Why use this Actor?

• Keyword and advertiser research — search the public Meta Ads Library by keyword or Page ID.
• Creative intelligence — extract ad text, titles, descriptions, CTA, landing pages, all detected external landing page URLs, images, and video URLs when visible.
• Monitoring mode — remember seen Library IDs and output only newly discovered ads on scheduled runs.
• No Facebook login required — uses the public Ads Library UI.
• CSV/JSON ready — structured dataset output for spreadsheets, dashboards, and ad swipe files.
• Residential proxy ready — recommended for reliable production scraping.

Input example

{
  "searchTerms": ["nike"],
  "country": "US",
  "activeStatus": "active",
  "mediaType": "all",
  "maxAds": 100,
  "maxScrolls": 20,
  "includeImages": true,
  "includeVideos": true,
  "monitorMode": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Output example

{
  "adArchiveId": "1869276447125570",
  "libraryId": "1869276447125570",
  "isActive": true,
  "activeStatus": "Active",
  "startDateText": "Mar 17, 2026",
  "advertiserName": "Nike",
  "advertiserPageUrl": "https://www.facebook.com/nike",
  "adText": "Celebra tu cumpleaños con Nike...",
  "title": "Nike",
  "description": "Download Nike: Shoes, Apparel, Stories...",
  "cta": "Install Now",
  "landingPageUrl": "https://itunes.apple.com/...",
  "landingPageUrls": ["https://itunes.apple.com/..."],
  "displayUrl": "ITUNES.APPLE.COM",
  "hasMultipleVersions": true,
  "imageUrls": ["https://..."],
  "videoUrls": [],
  "snapshotUrl": "https://www.facebook.com/ads/library/?id=1869276447125570",
  "sourceUrl": "https://www.facebook.com/ads/library/?...",
  "searchTerm": "nike",
  "country": "US",
  "scrapedAt": "2026-06-27T12:00:00.000Z"
}

Monitoring mode

Set:

{
  "monitorMode": true,
  "monitorKey": "nike-us-active"
}

The Actor stores seen Library IDs in the default key-value store and returns only new ads on later runs with the same monitorKey.

Recommended proxy setup

Meta may block or rate-limit datacenter traffic. Use residential proxies for production:

"proxyConfiguration": {
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"],
  "apifyProxyCountry": "US"
}

Limitations

• Meta frequently changes Ads Library HTML/GraphQL internals; ongoing maintenance is expected.
• Some media URLs are lazy-loaded or protected and may not appear in every result.
• Official Graph API spend/impression/demographic fields are limited mainly to political/issue/EU ads and may require a Meta access token; this MVP focuses on the public no-login Ads Library UI.
• Use moderate maxScrolls and residential proxies for best reliability.

SEO keywords

Facebook Ads Library scraper, Meta Ads scraper, Facebook ad spy scraper, competitor ads scraper, Meta ad creative monitor, Facebook ad creative scraper, Instagram ads scraper, ad library API, competitor ad monitoring, DTC ad spy, paid social creative research.