What is Meta Ad Library Scraper?

Meta Ad Library Scraper extracts ads running on Facebook, Instagram, Messenger and Threads from Meta's public Ad Library — the creative, the landing page, the run dates, and the advertiser behind each ad.

Search by keyword to see everyone advertising in a niche, or by advertiser page ID to pull one company's entire ad history. No login and no Facebook account.

• Find who is spending on ads — every row carries the advertiser's page name, page ID, profile URL, follower count and business categories
• See the whole creative — headline, body copy, call-to-action, landing-page URL, and image or video URLs
• Competitor and market research — what a rival is running right now, how long each ad has been live, and which placements it runs on
• Filter before you pay — country, active/inactive, media type and ad category
• Export to Excel, CSV, JSON or HTML; run it on a schedule or from the API

Why this doubles as a lead list

An advertiser is a business that is actively spending money to get customers — which makes this one of the cleanest B2B lead signals there is. Every ad returns:

page_name · page_id · page_profile_url · page_likes · page_categories · link_url

That last one is the advertiser's own website, which you can push straight into an email or contact enrichment step. In a sample run for "plumber" in the US, 45 ads came from 39 distinct advertisers, each with a website and a follower count.

What data can this scraper extract?

🏢 Advertiser page name	🆔 Page ID	🔗 Page profile URL
👍 Page likes	🏷️ Page categories	🌐 Landing-page URL
📝 Headline & body copy	🔘 Call-to-action	🖼️ Image / video URLs
📅 Start & end date	✅ Active status	📱 Placements (FB/IG/Messenger/Threads)
🎞️ Display format	🗂️ Card count	🆔 Ad archive ID + Ad Library URL

On spend and impressions: Meta only publishes reach and spend ranges for political and issue ads — for everything else those fields are empty by design. That's the source data, not the scraper. To get them, set the ad category to "Issues, elections or politics".

How much does it cost?

Pay per event — you're charged for what you actually receive.

• Scraped ad — the base charge, once per unique ad. Ads are deduplicated by Meta's ad archive ID before you're billed.

How do I use it?

⬇️ Input

{
  "query": "plumber",
  "country": "US",
  "maxItems": 200,
  "activeStatus": "active"
}

To pull one advertiser's full history, take the numeric ID from an Ad Library URL (…view_all_page_id=1234567890) and put it in Advertiser page ID instead of a search term.

⬆️ Output

One row per ad:

{
  "ad_archive_id": "1409568196971821",
  "page_name": "Honest Plumbing AZ LLC",
  "page_id": "205528589318346",
  "page_profile_url": "https://www.facebook.com/HonestPlumbingAZ/",
  "page_likes": 73268,
  "page_categories": ["Business", "Home Repair"],
  "title": "Need a plumber today?",
  "body_text": "Same-day service across the valley…",
  "cta_text": "Learn more",
  "link_url": "https://www.example-plumbing.com/",
  "is_active": true,
  "start_date": "2026-07-09",
  "end_date": null,
  "publisher_platforms": ["FACEBOOK", "INSTAGRAM", "THREADS"],
  "ad_library_url": "https://www.facebook.com/ads/library/?id=1409568196971821"
}

Common uses

• Agencies & marketers — competitor creative research, and a prospect list of businesses already paying for ads
• Lead generation — advertisers are pre-qualified buyers; pair link_url with contact enrichment for outbound
• Market & trend research — who entered a category, what messaging they use, how long ads run
• Brand protection — spot ads impersonating your brand

Frequently asked questions

Do I need a Facebook account? No. The Ad Library is Meta's public ad-transparency product and this reads it without logging in.

Do I need residential proxies? Yes, and the default is already set correctly. Meta serves datacenter IPs a degraded page that returns no ad results, so switching to datacenter proxies will produce empty runs.

Why are spend and impressions empty? Meta only publishes them for political and issue ads. See the note above.

How many ads can I get? Meta paginates indefinitely for broad searches — set Number of ads to cap the run, or 0 to collect everything it will serve.

Is this legal? The Ad Library is published by Meta specifically for public transparency and requires no login. You are still responsible for complying with Meta's Terms of Service and applicable law, particularly around how you store and use any personal data.

Your feedback

Hit a bug or want another field? Open an issue on the Issues tab.