Facebook Ads Library Scraper (Meta Ad Spy & Creative Extractor)

A high-performance, production-ready Facebook Ads Library Scraper for the Apify platform. Extract comprehensive ad data, creative assets (high-res images & HD videos), ad archive IDs, collation variations, spend, reach, publisher platforms, and advertiser details without blocking.

---

🌟 Key Features

• 🛡️ Zero-Blocking Stealth Engine: Uses real Chromium instances with genuine fingerprinting and authentication token exchange. Meta's anti-scraping defenses are naturally bypassed without triggering CAPTCHAs or IP bans.
• 📸 Complete Creative Media Assets:
  • Full high-resolution creative images.
  • HD and SD MP4 video URLs with video preview thumbnails.
  • Carousel cards array with individual card headlines, images, and links.
  • Full primary text (ad copy), headlines, link descriptions, and Call-To-Action (CTA) buttons.
• 📊 Collation & Variations Grouping:
  • Extracts collationID and collationCount showing how many variations of an ad are actively being tested.
• 🌐 Multi-Platform Coverage:
  • Scrapes platform distribution across Facebook, Instagram, Audience Network, and Messenger.
• 🔍 Dual Search Modes:
  • Keyword & Brand Search: Search by any brand or keyword (e.g., ["nike", "shopify", "saas"]).
  • Page ID Search: Extract every ad published by a specific Facebook Page ID.
• 📈 Spend, Reach & Compliance Metadata:
  • Captures spend ranges, estimated audience reach, start/end dates, total active duration, and digital media (AI generated) disclosures.
• 🚀 Apify Residential Proxy Ready: Built-in rotation for enterprise-grade scalability.

---

📥 Input Configuration

Parameter	Type	Default	Description
searchTerms	Array	["nike"]	Keywords or brand names to search in Meta Ads Library.
pageIds	Array	[]	Optional: Specific Facebook Page IDs to scrape all ads from.
country	String	"US"	Target country code (US, GB, DE, CA, AU, IN, or ALL).
activeStatus	String	"all"	Filter ads by status: all, active, inactive.
adType	String	"all"	Ad category: all, political_and_issue_ads, housing, employment, credit.
mediaType	String	"all"	Filter by format: all, image, video, meme, image_and_meme.
maxAds	Integer	50	Maximum number of unique ads to scrape.
proxyConfiguration	Object	{}	Apify Proxy configuration (Residential recommended).

Example Input (INPUT.json)

{
  "searchTerms": ["nike", "gymshark"],
  "country": "US",
  "activeStatus": "active",
  "adType": "all",
  "mediaType": "all",
  "maxAds": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

---

📤 Output Data Format

The Actor pushes structured records to the default Apify Dataset. You can export results to JSON, CSV, Excel, or consume them via the Apify REST API.

Sample Output Record

{
  "adId": null,
  "adArchiveID": "1046730950862281",
  "collationID": "3472161186254279",
  "collationCount": 1,
  "pageID": "146705838515566",
  "pageName": "Sukeban World",
  "pageProfilePictureUrl": "https://scontent.xx.fbcdn.net/v/...",
  "pageProfileUri": "https://www.facebook.com/61551864263186/",
  "adSnapshotUrl": "https://www.facebook.com/ads/library/?id=1046730950862281",
  "isActive": true,
  "startDate": 1752044400,
  "startDateFormatted": "2025-07-09T07:00:00.000Z",
  "endDate": null,
  "endDateFormatted": null,
  "totalActiveTime": null,
  "hideDataStatus": "NONE",
  "displayFormat": "VIDEO",
  "primaryText": "SUKEBAN at @animeexpo \n07/05/25 Los Angeles \nSneakers @nike ...",
  "title": null,
  "caption": "instagram.com",
  "linkUrl": "http://instagram.com/sukeban_world",
  "linkDescription": null,
  "ctaText": "Visit Instagram profile",
  "ctaType": "VIEW_INSTAGRAM_PROFILE",
  "creativeImageUrl": "https://scontent.xx.fbcdn.net/v/...",
  "creativeVideoUrl": "https://video.xx.fbcdn.net/o1/v/t2/f2/m86/...",
  "images": [],
  "videos": [
    {
      "video_hd_url": "https://video.xx.fbcdn.net/o1/v/t2/f2/m86/...",
      "video_sd_url": "https://video.xx.fbcdn.net/o1/v/t2/f2/m86/...",
      "video_preview_image_url": "https://scontent.xx.fbcdn.net/v/..."
    }
  ],
  "cards": [],
  "publisherPlatform": ["INSTAGRAM"],
  "targetedOrReachedCountries": [],
  "politicalCountries": [],
  "spend": null,
  "currency": "",
  "reachEstimate": null,
  "impressionsWithIndex": {
    "impressions_text": null,
    "impressions_index": -1
  },
  "containsDigitallyCreatedMedia": false,
  "isAaaEligible": false,
  "aaaInfo": null,
  "isProfilePage": false,
  "gatedType": "ELIGIBLE",
  "categories": ["UNKNOWN"],
  "archiveTypes": [],
  "hasUserReported": false,
  "reportCount": null,
  "stateMediaRunLabel": null,
  "regionalRegulationData": {
    "finserv": { "is_deemed_finserv": false, "is_limited_delivery": false },
    "tw_anti_scam": { "is_limited_delivery": false }
  },
  "menuItems": [],
  "advertiser": {
    "id": "146705838515566",
    "name": "Sukeban World",
    "profileUrl": "https://www.facebook.com/61551864263186/",
    "avatarUrl": "https://scontent.xx.fbcdn.net/v/...",
    "likeCount": 426,
    "categories": ["Sports league"]
  },
  "scrapedAt": "2026-09-12T07:34:00.000Z"
}

---

🚀 Running on Apify

1. Deploy the Actor using the Apify CLI:

   $apify push
   

2. Or trigger via Apify API:

   $curl --request POST "https://api.apify.com/v2/acts/datablow~facebook-ads-scraper/runs?token=<YOUR_TOKEN>"