Facebook Ad Library Scraper

Powerful Apify Actor to scrape Facebook Ad Library search results and Facebook page ads with strict data quality enforcement and structured dataset output.

Features

• Ad Details Extraction: Collects Ad Archive ID, Page Name, Ad Copy text, Media URLs (Images/Videos), Spend ranges, Impressions, and Demographics.
• Dynamic Search Support: Search by keywords (searchTerms), targeted Facebook page URLs (pageUrls), country codes, and active status.
• Strict Data Quality: Automatic zero-null validation filtering out missing or invalid data.
• Apify Dataset Storage: Outputs clean structured JSON dataset items directly to Apify dataset storage.

---

Input Parameters

Provide input in INPUT.json or via Apify Console form:

{
  "searchTerms": ["ecommerce", "software"],
  "pageUrls": ["https://www.facebook.com/apifytech"],
  "countryCode": "ALL",
  "maxAds": 50,
  "activeStatus": "active"
}

Parameter	Type	Description	Default / Example
searchTerms	Array of Strings	Keywords to search in Facebook Ad Library	["ecommerce", "software"]
pageUrls	Array of Strings	Specific Facebook Page URLs to extract ads from	["https://www.facebook.com/apifytech"]
countryCode	String	2-letter country code filter (e.g. ALL, US, GB)	"ALL"
maxAds	Integer	Maximum number of ad items to collect	100
activeStatus	String	Filter by status (all, active, inactive)	"active"

---

Output Data Structure

The Actor pushes structured objects to the default Apify Dataset:

{
  "adArchiveID": "104928374920184",
  "pageId": "FB-PAGE-104928374920184",
  "pageName": "Apify Technologies",
  "publisherPlatform": ["facebook", "instagram"],
  "adCopy": "Build web scrapers and automation tools in the cloud with Apify.",
  "mediaUrls": ["https://facebook.com/ad/media/sample.jpg"],
  "mediaType": "Image",
  "startDate": "2026-08-01T00:00:00.000Z",
  "endDate": "Active / Ongoing",
  "isActive": true,
  "ctaType": "Learn More",
  "ctaDestinationUrl": "https://apify.com",
  "spend": {
    "currency": "USD",
    "lowerBound": 100,
    "upperBound": 500,
    "rawRange": "$100 - $500"
  },
  "impressions": {
    "lowerBound": 1000,
    "upperBound": 5000,
    "rawRange": "1K - 5K"
  },
  "targetDemographics": [
    {
      "age": "18-65+",
      "gender": "All",
      "topLocations": ["United States"]
    }
  ],
  "categories": ["Sponsored Advertising", "Commercial"],
  "advertiserVerification": "Verified Identity"
}

---

How to Run

Run locally using Apify CLI:

$apify run

Or deploy to Apify Platform:

$apify push