Meta Ads Library Scraper — Facebook & Instagram Ads

What does Meta Ads Library Scraper do?

Scrape Meta Ad Library search and Facebook Page URLs for Facebook and Instagram ads — ad copy, headlines, CTAs, landing links, image and video URLs, page names, start/end dates, platforms, and spend/reach when Meta shows them. Export JSON or CSV, schedule runs, or call via API / MCP.

Unofficial. Not affiliated with Meta. Public Ad Library data only — no login bypass.

Why use this scraper?

• 🔒 Hard resultsLimit cap — billing stops when the limit is hit (competitors often ignore max and overrun)
• 📊 onlyTotal mode — one honest count row per URL, billed as page-total (no phantom ad rows)
• 🌐 Residential proxy built-in — Meta blocks datacenter IPs (403)
• 🔁 Drop-in keys from apify/facebook-ads-scraper (startUrls, resultsLimit, onlyTotal, …)

How to scrape Meta ads

1. Open this Actor in Apify Console.
2. Click Start on the prefilled US keyword search for Nike (resultsLimit 5).
3. Keep Apify residential proxy enabled.
4. Export the dataset or pull via API.

{
  "startUrls": [
    { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=keyword&q=nike" }
  ],
  "resultsLimit": 5,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Count-only mode:

{
  "startUrls": [
    { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&search_type=page&view_all_page_id=15087023444" }
  ],
  "onlyTotal": true
}

Returns one row per URL: { "totalCount": 1234, "mode": "onlyTotal" } — no ad rows, no ad charges.

How much does it cost?

PPE: Actor start + Ad event per ad row, or Page total count ($0.009) in onlyTotal mode.

About $0.49 / 1,000 ads on Free; lower on paid plans (see Pricing tab).

Input

Field	Description
startUrls	Meta Ad Library URL or Facebook Page URL (required)
resultsLimit	Hard cap per URL (prefill 5)
onlyTotal	Count only — one row + page-total charge per URL
activeStatus	active / inactive if not already in URL
sorting	total_impressions or relevancy_monthly_grouped
isDetailsPerAd	Compatibility stub — adds ad_details.status=stub
includeAboutPage	Compatibility stub — not yet implemented
proxyConfiguration	Residential proxy required

Sample output (ad row)

{
  "adArchiveId": "1234567890123456",
  "pageName": "Nike",
  "pageId": "15087023444",
  "isActive": true,
  "publisherPlatform": ["FACEBOOK", "INSTAGRAM"],
  "startDate": 1735689600,
  "snapshot": {
    "body": "Just Do It.",
    "title": "New collection",
    "linkUrl": "https://www.nike.com/",
    "ctaText": "Shop Now",
    "images": ["https://..."],
    "videos": []
  },
  "sourceUrl": "https://www.facebook.com/ads/library/?...&q=nike",
  "scrapedAt": "2026-08-28T11:00:00+00:00"
}

Limitations (v0.1)

• isDetailsPerAd and includeAboutPage: schema accepted; enrichment is stubbed (see README).
• onlyAdsNewerThan / onlyAdsOlderThan / enrichWithEcommerceData: accepted for clone compatibility; set filters in the Ad Library URL instead.
• GraphQL doc_id rotates — if extraction returns zero rows across retries, rebuild may be needed.

Related Actors

Actor	Use together when…
Instagram Profile Scraper	You need public profile metadata for brands running the ads
Instagram Comments Scraper	You pair paid creatives with organic post comment research
Apify Facebook Ads Scraper	You need the official Store leader with full EU reach enrichment

SEO keywords

facebook ads library scraper, meta ad library api, facebook ad spy, instagram ads library, meta ads scraper, ad library export, competitor facebook ads

---

Legal: Public Ad Library transparency data only. No personal profiles or login-gated content.