Facebook Ads Scraper

Scrape the Meta (Facebook/Instagram) Ads Library to extract ads from any advertiser or keyword search — faster and richer than other scrapers.

Just paste a Facebook page URL or a Meta Ad Library search URL and run. No login required.

✨ What you get

• Ad status — isActive boolean: true for running ads, false for stopped
• Ad format — snapshot.displayFormat: DPA (Dynamic Product), DCO (Dynamic Creative), or STANDARD
• Ad title — snapshot.title: the main creative headline or body text
• Publisher platforms — FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK, MESSENGER, THREADS
• Delivery dates — startDateFormatted, endDateFormatted in ISO 8601
• Advertiser name — pageInfo.page.name
• Ad text — full creative body text
• Ad Library link — direct link to the ad in Meta's library
• Bonus fields (vs. competitors) — page category, likes, verification, Instagram username, CTA domain, headline, description, snapshot URL

📦 Sample output

[
  {
    "pageInfo.page.name": "Nike",
    "snapshot.title": "Just Do It. Shop the latest collection.",
    "snapshot.displayFormat": "DCO",
    "isActive": true,
    "spend": null,
    "reachEstimate": null,
    "publisherPlatform": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER"],
    "startDateFormatted": "2026-02-27T08:00:00.000Z",
    "endDateFormatted": "2026-04-11T07:00:00.000Z",
    "adArchiveID": "3948271054812",
    "pageID": "15087023444",
    "pageURL": "https://www.facebook.com/15087023444",
    "pageCategory": "Sportswear store",
    "pageLikes": 34800000,
    "pageVerified": true,
    "pageInstagramUser": "nike",
    "pageInstagramFollowers": 302000000,
    "pageCountry": "US",
    "adText": "Just Do It. Shop the latest collection.",
    "adCreativeBodies": ["Just Do It. Shop the latest collection.", "New arrivals — limited time only."],
    "languages": ["en"],
    "adLibraryURL": "https://www.facebook.com/ads/library/?id=3948271054812"
  },
  {
    "pageInfo.page.name": "SHEIN",
    "snapshot.title": "{{product.name}}",
    "snapshot.displayFormat": "DPA",
    "isActive": false,
    "spend": null,
    "reachEstimate": null,
    "publisherPlatform": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK"],
    "startDateFormatted": "2025-02-04T08:00:00.000Z",
    "endDateFormatted": "2025-06-25T07:00:00.000Z",
    "adArchiveID": "7261039485012",
    "pageID": "380039845369159",
    "pageURL": "https://www.facebook.com/380039845369159",
    "adText": "{{product.name}}",
    "adCreativeBodies": ["{{product.name}}"],
    "languages": null,
    "adLibraryURL": "https://www.facebook.com/ads/library/?id=7261039485012"
  }
]

🚀 Usage

Input

Field	Type	Default	Description
startUrls	array	—	Required. Facebook page URLs or Meta Ad Library search URLs
resultsLimit	number	10	Max ads to return per URL
activeStatus	string	""	Filter: ACTIVE, INACTIVE, or ALL (blank = use URL's filter)
includeAboutPage	boolean	false	Add page category, likes, Instagram info
isDetailsPerAd	boolean	false	Add CTA domain, headline, description, snapshot URL
onlyTotal	boolean	false	Return only the total ad count (no ad data)
countryFallback	string	ALL	Country code when not set in URL

Supported URL formats

Facebook page URL — extract all ads from a specific advertiser:

https://www.facebook.com/nike
https://www.facebook.com/SHEINOFFICIAL
https://www.facebook.com/15087023444

Meta Ad Library search URL — copy-paste from facebook.com/ads/library with any filters applied:

https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&media_type=video
https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&search_type=page&view_all_page_id=15087023444&publisher_platforms[0]=instagram

You can mix both types in the same run.

Example input (compatible with apify/facebook-ads-scraper)

{
  "startUrls": [
    { "url": "https://www.facebook.com/SHEINOFFICIAL" },
    { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&media_type=image&publisher_platforms[0]=instagram&search_type=page&view_all_page_id=15087023444" }
  ],
  "resultsLimit": 20,
  "activeStatus": "ACTIVE",
  "includeAboutPage": false,
  "isDetailsPerAd": false
}

💡 Tips

• Keyword search: paste a full Ad Library URL with q=your+keyword to search ads by keyword across all advertisers.
• Page ads: use a Facebook page URL (or view_all_page_id in the URL) to get all ads from a specific brand.
• Smart page discovery: when a keyword search returns fewer results than expected (e.g. the brand name doesn't appear in ad body text), the scraper automatically discovers the advertiser's pages by name and queries them directly.
• DPA detection: ads with snapshot.displayFormat = "DPA" use dynamic product catalogs — the title shows {{product.name}} which is normal (Meta doesn't expose the actual product names).
• Use onlyTotal: true to count ads before committing to a full scrape.

💰 Pricing

Charged per result: $0.0015 per ad ($1.50 per 1,000 ads) plus a flat $0.005 per run.

This is 2–4× cheaper than comparable Facebook ads scrapers on the Apify marketplace.

Spend data and audience estimates are null for standard commercial ads — Meta only provides these for Special Ad Categories (political, housing, employment).

⚠️ Limitations

• Uses the public Meta Ads Library API — no login, no private data.
• spend and reachEstimate are always null for standard ads (Meta API restriction).
• Health/pharmaceutical advertisers may return 0 results due to Meta platform restrictions on API access for those categories.

---

🔍 Keywords

Facebook ads scraper, Meta ads library scraper, Facebook ad library, Instagram ads scraper, Facebook advertising data, scrape Facebook ads, ad spy tool, competitor ad research, Facebook ads intelligence, social media ads scraper, Facebook ads dataset, Meta ads extractor, paid ads research, Facebook ads monitoring, Facebook page ads extractor, brand ads scraper, Facebook ads export JSON CSV, ad creative scraper, Facebook ads active status, publisher platform ads, DPA scraper, dynamic product ads, DCO ads extractor, Facebook ads automation, Apify Facebook, ecommerce competitor ads, dropshipping ad research, Facebook ads analytics, multi-country Facebook ads, Instagram ads data, Facebook ads by page, Messenger ads, Audience Network ads, Threads ads, Facebook ads start date end date, ad delivery dates, Facebook advertiser category, page likes scraper, verified page ads, Instagram username from Facebook ads, CTA domain scraper, Facebook ads headline, ad snapshot URL, Facebook ads count, ad library bulk download