🔍 Meta Ads Scraper — The Most Powerful Facebook Ad Library Scraper

Trusted by 500+ marketers, agencies, and brands — with over 1,000,000+ ad records scraped and counting. Get complete, structured ad intelligence from the Meta Ad Library in minutes, not hours.

Whether you're tracking competitors, building creative swipe files, or powering an ad intelligence pipeline — this scraper delivers 99% data accuracy with proxy support.

---

⚡ Why This Scraper?

Feature	Details
🎯 Complete Ad Data	Brand, body copy, CTA, links, images, videos, carousel assets, platform breakdown
📊 1M+ Records Delivered	Battle-tested across thousands of runs for brands worldwide
🔄 Two Input Modes	Paste a URL directly or build your search with simple parameters
🌍 Any Country, Any Brand	Supports all 200+ countries in the Meta Ad Library
🛡️ Anti-Detection Built-In	Stealth mode, session rotation, human-like scrolling
🖼️ All Media Formats	Images, videos (with duration), carousels — all captured
⚙️ Proxy Ready	Plug in your Apify Residential proxy for 99% coverage

---

🚀 Quick Start

You have two ways to tell the scraper what to fetch:

Option A: Paste a Direct URL

Already have a Facebook Ad Library URL? Just paste it:

{
  "targetUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&view_all_page_id=108047081396228"
}

Option B: Build from Parameters (New! ✨)

Don't want to craft URLs manually? Just fill in the fields:

{
  "country": "US",
  "searchQuery": "nike",
  "activeStatus": "active",
  "mediaType": "video",
  "sortMode": "total_impressions"
}

Or search by Page ID:

{
  "country": "IN",
  "pageId": "786827864757998",
  "activeStatus": "active"
}

The scraper builds the correct URL automatically — no guesswork needed.

---

📋 Input Parameters

Search Identifiers (at least one required when using parameters)

Parameter	Type	Description	Example
targetUrl	string	Full Facebook Ad Library URL (Option A)	https://www.facebook.com/ads/library/...
country	string	ISO 3166-1 alpha-2 country code	US, IN, IT, GB
searchQuery	string	Keyword search across all ads	nike, adidas shoes
pageId	string	Facebook Page ID to view all ads	108047081396228
adId	string	Look up a specific ad by ID	1191898553123641

Filtering Options

Parameter	Type	Values	Default
activeStatus	enum	active, inactive, all	all
adType	enum	all, political_and_issue_ads, housing, employment, credit	all
mediaType	enum	all, image, video, meme	all
isTargetedCountry	boolean	true, false	false
contentLanguages	array	ISO 639-1 codes (e.g. ["en", "it"])	all languages

Sorting

Parameter	Type	Values	Default
sortMode	enum	total_impressions, relevance, start_date	total_impressions
sortDirection	enum	desc, asc	desc

Performance Settings

Parameter	Type	Default	Description
maxConcurrency	integer	1	Browser tabs in parallel (1–10)
requestHandlerTimeoutSecs	integer	900	Max time per page (60–1200s)
proxyUrl	string	—	Your Apify Residential proxy URL

---

📦 Output Format

Each run outputs a clean JSON array of ad objects:

[
  {
    "libraryID": "1234567890",
    "brand": "Nike",
    "brandLogo": "https://scontent...",
    "active": true,
    "platforms": ["Facebook", "Instagram"],
    "totalPlatforms": 2,
    "similarAdCount": 5,
    "multipleVersions": true,
    "body": "Just Do It. Shop the latest collection...",
    "linkTitle": "Nike.com",
    "linkUrl": "https://nike.com/shop",
    "linkDescription": "Free shipping on orders over $50",
    "ctaText": "Shop Now",
    "ctaUrl": "https://nike.com/shop",
    "images": [{ "url": "https://..." }],
    "videos": [{ "url": "https://...", "duration": 30 }],
    "startDate": "1/15/2025",
    "format": "video"
  }
]

Every field you need — brand identity, creative assets, copy, CTA, platform breakdown, dates, and format detection (image / video / carousel).

---

🛡️ Proxy Setup (Recommended)

Without a proxy, Facebook limits results heavily. With an Apify Residential proxy, you get 99% of all ads.

How to set up:

1. Go to Apify Console → Proxy → Groups tab
2. Click RESIDENTIAL → Copy the proxy URL
3. Paste it into the proxyUrl field

Format: http://groups-RESIDENTIAL:YOUR_TOKEN@proxy.apify.com:8000

External proxies (BrightData, Oxylabs, etc.) also work — just paste the URL.

---

🏗️ Built With

• Apify SDK + Crawlee for orchestration
• Puppeteer with stealth plugin for undetectable scraping
• Scroll-based pagination with intelligent stall detection
• Duplicate detection and memory-efficient DOM cleanup for large datasets (500+ ads)

---

💡 Pro Tips

1. Start with maxConcurrency: 1 — increase only if you have enough memory
2. Pages with 200+ ads need at least 600s timeout
3. Use activeStatus: "active" to get only currently running ads
4. Sort by start_date to catch the freshest creatives first
5. Combine mediaType: "video" + keyword search to find video ads for specific niches

---

🤝 Enterprise & Custom Solutions

Building an ad intelligence platform? Need a full creative pipeline — from scraping to analysis to insights?

Let's talk. We've helped brands and agencies build end-to-end creative intelligence workflows.

🌐 Website: whoareyouanas.com
📧 Email: anas5678go@gmail.com
🐦 Twitter/X: @whoareyouanas

Whether you need custom scraping pipelines, bulk data delivery, or API integrations — reach out and let's build something great together.