📢 Facebook Ads Library Scraper

⚡️ Pull live and past ads from the Facebook (Meta) Ad Library — by keyword or by advertiser — and get clean, structured JSON in seconds. Ad copy, creative images & videos, landing-page URLs, advertiser details, platforms, and run dates. No login, no manual scrolling, no copy-paste.

🚀 Why this scraper

• 🎯 Two ways to search — by keyword/brand (coffee, Nike) or by advertiser page to grab a competitor's entire ad portfolio.
• 🖼️ Full creatives — every image and video URL, plus headline, body text, call-to-action, and the landing-page link each ad points to.
• 🌍 Any country — scope results to US, GB, DE, IN, BR, or any market the Ad Library covers.
• ⚡️ Fast & cheap — a lightweight data path means low cost per ad and quick runs, even for thousands of ads.
• 🔁 Daily-refresh friendly — the since filter keeps incremental runs tiny so you only pull new ads.
• 📦 Ready-to-use exports — JSON, CSV, and Excel, or pull straight from the Apify API.

🏁 Quick start

1. Click Try for free.
2. Type a search term (e.g. coffee) or an advertiser page ID, and pick a country.
3. Hit Start ▶️.
4. Download your ads as JSON / CSV / Excel when the run finishes. 🎉

⚙️ Input

Field	Description
Search terms	Keywords or brand names to look up. One search per term.
Advertiser page IDs	Page IDs to pull every ad from a specific advertiser — great for competitor monitoring.
Start URLs	Paste Ad Library URLs straight from your browser; their filters are applied automatically.
Country	Two-letter country code (US, GB, DE, …). The library is region-scoped.
Ad category	All ads, or one of Meta's special categories (political, housing, employment, credit, financial).
Active status	Active only, inactive only, or both.
Media type	All media, images, memes, videos, or none.
Keyword match	Match any words, or exact phrase.
Only ads started on/after	Optional date — keep only newer ads (ideal for daily refresh).
Max ads	Overall cap for the run (0 = unlimited).
Max ads per search / advertiser	Per-search cap so a budget spreads evenly across many advertisers.
Concurrency	How many searches to run in parallel.

📤 Sample output

{
  "url": "https://www.facebook.com/ads/library/?id=845039281462123",
  "id": "845039281462123",
  "scraped_at": "2026-06-09T17:53:53.178494+00:00",
  "is_active": true,
  "page_id": "20531316728",
  "page_name": "Nike",
  "page_url": "https://www.facebook.com/nike/",
  "page_profile_picture_url": "https://scontent.xx.fbcdn.net/v/nike_logo.jpg",
  "page_likes": 39000000,
  "page_categories": ["Sportswear store"],
  "page_is_deleted": false,
  "display_format": "VIDEO",
  "ad_text": "Engineered for your fastest mile yet. Meet the new Pegasus. 🏃",
  "title": "Nike Pegasus 41",
  "caption": "nike.com",
  "link_url": "https://www.nike.com/launch/pegasus-41",
  "link_description": "Free shipping for members.",
  "cta_text": "Shop Now",
  "cta_type": "SHOP_NOW",
  "publisher_platforms": ["FACEBOOK", "INSTAGRAM", "MESSENGER"],
  "start_date": "2026-05-01T07:00:00+00:00",
  "end_date": null,
  "total_active_time": null,
  "categories": ["UNKNOWN"],
  "collation_count": 4,
  "currency": null,
  "spend": null,
  "impressions": null,
  "reach_estimate": null,
  "byline": null,
  "disclaimer": null,
  "countries": ["US"],
  "images": ["https://scontent.xx.fbcdn.net/v/pegasus_thumb.jpg"],
  "videos": ["https://video.xx.fbcdn.net/v/pegasus_ad_hd.mp4"],
  "cards_count": 0
}

💡 Use cases

Who	What they use it for
🛒 Performance marketers & media buyers	Spy on competitors' live creatives, offers, and hooks; model winning ad copy before you spend.
🏢 Agencies	Build competitive ad audits and pitch decks from real, current advertiser activity.
📈 DTC & e-commerce brands	Track rivals' promos, launch timing, and the exact landing pages they drive to.
🔬 Market & trend researchers	Monitor category-wide ad volume and messaging shifts over time.
🤖 AI / ML teams	Collect ad-copy and creative datasets for generation, classification, and trend models.

🧪 Tips & tricks

• 🔎 Grab a whole competitor — paste their Page ID into Advertiser page IDs to export every ad they're running.
• 🌐 Compare markets — run the same brand across several countries to see how messaging changes by region.
• 🗓️ Schedule it — pair the since filter with Apify Schedules for a daily feed of new competitor ads only.
• 🎬 Save the creatives — images and videos hold direct media URLs you can download for swipe files.
• ⚖️ Spot cloaking — ads where the displayed link and real landing page disagree are flagged with _suspicious.

❓ FAQ

Do I need a Facebook account or API token? No. Just enter what you want and click Start.

Which ads are covered? Everything in the public Meta Ad Library for the country you pick — commercial ads as well as the political/issue, housing, employment, credit, and financial categories.

Why are spend, impressions, and byline empty on most ads? Meta only publishes spend/reach/funding data for political & issue ads. For regular commercial ads those fields are blank by design — everything else (copy, creatives, landing page, dates, platforms) is fully populated.

How is pricing calculated? Pay per result — you're billed only for the ads actually saved to your dataset. No subscription, no minimum.

Can I get a competitor's full ad history? Yes — search by their Advertiser page ID and set Max ads to 0 for unlimited.

What formats can I export? JSON, CSV, and Excel from the Console, or pull programmatically via the Apify API.