Facebook Ad Library Scraper - Meta Ads Spy & Competitor Intelligence

Scrape the Facebook & Instagram Ad Library for any advertiser or keyword and get clean, structured data on every ad they are running. Built for competitor ad intelligence, creative research, and ad monitoring.

You are charged only for ads actually delivered to your dataset, never for failed runs, and never a single ad over your limit.

---

Why this scraper

Most Facebook ad scrapers hide the real price, ignore your result cap, stop early on big advertisers, and hand back metadata with links that expire. This one is different:

• Fair, flat pricing: $0.75 per 1,000 ads. Printed right here, no surprises.
• Your result cap is law. Set maxResultsPerPlatform and the run will never exceed it or bill you past it.
• No charge for failed or empty runs. If we do not deliver an ad, you do not pay for it.
• Complete results at scale. Paginates through large advertisers instead of silently stopping at a few thousand.
• Own your creatives. Optionally download every image and video into your storage, not a link that expires next week.
• Cost preview before you spend. Turn on estimateOnly to see the projected ad count and price without running a paid scrape.
• Reliable. Automatic retries, residential-proxy rotation, and save-as-you-go so a long run never loses delivered work.

What you get

Every ad in the Meta Ad Library, across Facebook, Instagram, Messenger, and Audience Network:

• Advertiser (page name, id, profile URL, verification)
• Full creative: headline, body text, call to action, landing URL, and every image/video URL
• Where it ran (the publisher platforms) and whether it is still active
• Start date, end date, and total days active
• EU reach and targeting, and political spend/impression ranges, where Meta publishes them

Quick start

Pull Nike's active ads in the US:

{
  "platforms": ["meta"],
  "searchMode": "advertiser",
  "searchTerms": ["nike"],
  "countries": ["US"],
  "adStatus": "active",
  "maxResultsPerPlatform": 500
}

Want a price first? Add "estimateOnly": true for a free cost preview.

Common use cases

• Spy on a competitor's ads: search their brand name and see every creative, hook, and offer they are running.
• Find winning angles: filter by media type and active status to see what is working right now.
• Monitor new ads: enable monitoringEnabled and schedule the run to get only ads you have not seen before.
• Feed an AI workflow: call it from an agent via API or MCP, clean JSON in, clean JSON out.

Key input options

Field	What it does
searchMode	keyword (ad text), advertiser (page/brand name), or advertiserId (exact page ID or profile URL).
searchTerms	Brands or keywords to search.
countries	ISO country codes, also geo-targets the proxy.
adStatus	active, inactive, or all.
adCategory	all, commercial, or political (political unlocks spend/impression ranges where published).
maxResultsPerPlatform	Hard cap on ads returned. Strictly enforced.
downloadMedia	Save image/video creatives into your storage (billed separately).
monitoringEnabled	Return only ads not seen in previous runs.
estimateOnly	Preview count and cost without a paid scrape.

Output

One row per ad:

{
  "platform": "meta",
  "adId": "1702938977100376",
  "advertiser": { "name": "Nike", "id": "...", "verified": true, "pageUrl": "..." },
  "creative": {
    "type": "carousel",
    "headline": "...",
    "body": "Bring sports more fully into your day with the Nike App.",
    "cta": "Install now",
    "landingUrl": "https://nike.com/...",
    "mediaUrls": ["https://..."],
    "downloadedMedia": []
  },
  "surfaces": ["facebook", "instagram", "audience_network", "messenger"],
  "status": "active",
  "dates": { "startDate": "...", "endDate": null, "totalActiveDays": 455 },
  "countries": ["US"],
  "sourceUrl": "https://www.facebook.com/ads/library/?id=1702938977100376"
}

Pricing

Event	Price
Ad scraped	$0.00075 per ad ($0.75 per 1,000)
Creative downloaded (optional)	$0.003 per file ($3 per 1,000)

You are billed per ad delivered to your dataset. Failed runs, empty runs, and anything over your cap are free.

Roadmap

Google Ads Transparency Center and TikTok ad-library support are in development and will be added as free updates. Follow the Actor to be notified.

Data and compliance

This Actor collects only public ad-transparency data that Meta publishes by design, while logged out, using public fields only. It does not log in, bypass authentication, or collect private personal data. Advertiser information is business data. For any data concern or removal request, contact the publisher.

FAQ

Do I need proxies? Yes, use Apify Residential (the default). Meta blocks datacenter IPs.

Will it stop at my limit? Always. The cap is enforced before any ad is counted, and you are never charged past it.

Which countries can I search? Any country Meta serves the ad in. The Ad Library is global for commercial ads.