Facebook Ads Library Scraper

Extract public advertising data from the Meta Ad Library. Scrape ads from Facebook Page URLs or Ad Library search URLs across Facebook, Instagram, and other Meta publisher platforms.

✨ Key Features

• 📢 Scrape ads from Facebook Pages or Meta Ad Library URLs
• 📱 Publisher platforms: Facebook, Instagram, WhatsApp, Threads, Audience Network, and more
• ✍️ Ad copy, titles, CTAs, landing links, and creative cards
• 🖼️ Images, videos, and carousel creatives when available
• ✅ Filter by active / inactive, date range, and sort order
• 🏢 Optional About info and per-ad detail enrichment
• 🔢 Optional count-only mode for total ads per page
• 📋 Structured JSON output, streamed while the run is in progress

💪 Why Choose This Actor?

• Focused: Meta Ad Library ads without product-page enrichment add-ons
• Flexible: Page URLs or pre-filtered Ad Library search URLs
• Structured: Renamed, integration-friendly field names
• Practical: Built for competitor monitoring and creative research

🎯 Perfect For

• 🕵️ Competitor ad monitoring
• 🎨 Creative and messaging research
• 🌍 Platform / country campaign analysis
• 🤖 Enrichment pipelines and automation

📝 Input Requirements

• sourceUrls (required): Facebook Page URLs and/or Meta Ad Library URLs
• maxAdsPerUrl (optional): Max ads per URL (default 50)
• adStatus (optional): all, active, or inactive
• sortBy (optional): default, impressions, or recent
• activeAfter / activeBefore (optional): Date filters
• countOnly / includeAboutInfo / includeAdDetails (optional)

Input Example

{
  "sourceUrls": [
    "https://www.facebook.com/SHEINOFFICIAL"
  ],
  "maxAdsPerUrl": 50,
  "adStatus": "active",
  "sortBy": "impressions"
}

Output Example

{
  "pageName": "SHEIN",
  "archiveId": "1229350099285014",
  "isActive": true,
  "title": "Summer sale starts now",
  "body": "Shop the latest drops…",
  "ctaLabel": "Shop now",
  "landingUrl": "https://www.shein.com/",
  "platforms": ["FACEBOOK", "INSTAGRAM"],
  "startedAt": "2026-03-16T07:00:00.000Z",
  "endedAt": "2026-07-09T07:00:00.000Z",
  "scrapedAt": "2026-08-04T06:00:00.000Z"
}

🚀 How to Use

1. Add one or more Facebook Page or Ad Library URLs
2. Optionally set status, sort, date range, and detail options
3. Click Start
4. Download results as JSON, CSV, Excel, or HTML

📌 Notes

• Filters already present in an Ad Library URL override matching input fields
• Results may appear only after the upstream run finishes collecting ads
• This actor does not follow landing pages for product/price enrichment