Meta Ad Library Scraper

Scrape listings from Meta Ad Library easily with Meta Ad Library Scraper.

About

Meta Platforms

Meta Platforms, Inc. (formerly Facebook, Inc.) is an American multinational technology company headquartered in Menlo Park, California. Founded by Mark Zuckerberg and his Harvard roommates in February 2004 as "TheFacebook", it was renamed Facebook in 2005 and rebranded to Meta in October 2021 to signal a broader ambition beyond social networking — toward the so-called metaverse.

Meta is one of the "Big Five" American tech companies alongside Alphabet, Amazon, Apple, and Microsoft. Its family of apps — Facebook, Instagram, WhatsApp, and Messenger — collectively reach over 3.2 billion daily active users worldwide, making it the largest social media ecosystem on the planet. Facebook alone counts roughly 3 billion monthly active users. Meta has grown aggressively through acquisitions. Key milestones:

• 2005 — purchased the facebook.com domain for $200,000
• 2010 — acquired social gaming companies Hot Potato and photo sharing app Nextstop
• 2012 — bought Instagram for ~$1 billion (cash and stock), at the time one of the largest tech acquisitions ever for an app with no revenue
• 2013 — acquired Parse, a mobile backend platform, for ~$85 million (later shut down in 2017)
• 2014 — purchased WhatsApp for ~$19 billion, making it the largest acquisition of a venture-backed company in history at the time; also acquired Oculus VR for ~$2 billion, signaling early interest in virtual reality
• 2016 — bought MSQRD (augmented reality face filters) and Masquerade, key building blocks for Facebook and Instagram AR effects
• 2019 — acquired CTRL-labs, a startup working on neural interface technology, for a reported $500 million–$1 billion
• 2020 — purchased Mapillary, a street-level imagery platform, to power mapping for AR features
• 2021 — rebranded to Meta Platforms and doubled down on the metaverse; acquired several VR/AR studios including Unit 2 Games (Crayta) and BigBox VR
• 2022 — attempted to acquire Within (VR fitness app maker), ultimately blocked by the FTC on antitrust grounds in 2023

Meta's acquisition strategy has consistently focused on eliminating potential social competitors early (Instagram, WhatsApp) and acquiring enabling technology for its next strategic bets (VR/AR, neural interfaces).

Advertising is the core of Meta's business model, accounting for around 97% of its total revenue. The company's ad targeting capabilities — built on vast behavioral and demographic data — make it one of the most powerful digital advertising platforms in the world, alongside Google.

Meta Ad Library

The Meta Ad Library is a publicly accessible, searchable repository of all ads currently running across Meta's platforms — Facebook, Instagram, Messenger, and Audience Network. It was launched in 2018 as a transparency measure following widespread criticism over the role of political advertising and disinformation in the 2016 US presidential election.

Initially covering only political and social issue ads in the United States, the library expanded in 2019 to include all active ads globally. For political and social issue ads, records are retained for 7 years after a campaign ends; for all other ads, data is kept for at least 1 year.

The library is freely accessible at https://www.facebook.com/ads/library and requires no login. It provides advertisers' names, the pages running the ads, creative content, estimated reach, spend ranges, and — for political ads — payer and beneficiary disclosures. Under the EU Digital Services Act (DSA), Meta is additionally required to publish a machine-readable ad repository covering EU-targeted advertising, including audience targeting parameters and impression counts. This makes the Ad Library a key resource for researchers, journalists, and regulators monitoring advertising transparency and potential disinformation campaigns.

Why should you use it?

It provides the latest ads data from Meta Ad Library, without requiring login or session cookies.

How to use

Meta Ad Library Scraper has number of input parameters that can be used.

Input parameter	Description	Required	Default value
urls	Meta Ad Library urls that needs to be scraped	true	{url: "https://www.facebook.com/ads/library/?id=1873455736760336"}
maxRecords	Maximum number of records to be scraped	false	100

Valid Meta Ad Library links:

• https://www.facebook.com/ads/library/?id=1873455736760336
• https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&q=jetbrains&search_type=keyword_unordered&sort_data[mode]=total_impressions&sort_data[direction]=desc

Examples

Input

Scrape 20 search results from given search URL:

{
  "urls": [
    "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&q=jetbrains&search_type=keyword_unordered&sort_data[mode]=total_impressions&sort_data[direction]=desc"
  ],
  "maxRecords": 20
}

Output

The output below is a synthetic example showing all fields in a fully populated state.

{
  "adId": "123456789012345",
  "pageId": "987654321098765",
  "pageName": "Acme Corp",
  "pageIsDeleted": false,
  "collationId": "111222333444555",
  "collationCount": 5,
  "isActive": true,
  "hasUserReported": false,
  "reportCount": 2,
  "stateMediaRunLabel": "ACTIVE",
  "gatedType": "ELIGIBLE",
  "categories": ["HOUSING"],
  "isAaaEligible": true,
  "containsDigitalCreatedMedia": false,
  "accountsReached": 45000,
  "currency": "USD",
  "adSpend": "1000-1999",
  "endDate": 1798761600,
  "endDateUtc": "2027-01-01T00:00:00.000Z",
  "startDate": 1735689600,
  "startDateUtc": "2025-01-01T00:00:00.000Z",
  "publisherPlatform": ["FACEBOOK", "INSTAGRAM"],
  "containsSensitiveContent": false,
  "totalActiveTime": 365,
  "hideDataStatus": "NONE",
  "impressionsText": "1M–2M",
  "targetedOrReachedCountries": ["US", "CA"],
  "regionalRegulationData": {
    "finserv": {
      "isDeemedFinserv": true,
      "isLimitedDelivery": false
    },
    "twAntiScam": {
      "isLimitedDelivery": false
    }
  },
  "adContent": {
    "caption": "acmecorp.com",
    "ctaText": "Shop Now",
    "ctaType": "SHOP_NOW",
    "displayFormat": "VIDEO",
    "linkUrl": "https://www.acmecorp.com/sale?utm_source=facebook",
    "linkDescription": "Save up to 50% on all products this week only.",
    "body": "Discover our latest collection. Quality products at unbeatable prices.",
    "title": "Acme Corp — End of Season Sale",
    "byline": "Sponsored",
    "isReshared": false,
    "images": [
      {
        "originalImageUrl": "https://example.cdn.net/images/acme_banner_original.jpg",
        "resizedImageUrl": "https://example.cdn.net/images/acme_banner_600x600.jpg"
      }
    ],
    "videos": [
      {
        "videoSdUrl": "https://example.cdn.net/videos/acme_promo_sd.mp4",
        "videoHdUrl": "https://example.cdn.net/videos/acme_promo_hd.mp4",
        "thumbnailUrl": "https://example.cdn.net/images/acme_promo_thumb.jpg"
      }
    ],
    "cards": [
      {
        "caption": "acmecorp.com",
        "title": "Product A",
        "body": "Best deal of the year",
        "linkUrl": "https://www.acmecorp.com/product-a",
        "ctaText": "Buy Now",
        "images": [
          {
            "originalImageUrl": "https://example.cdn.net/images/product_a_original.jpg",
            "resizedImageUrl": "https://example.cdn.net/images/product_a_600x600.jpg"
          }
        ]
      }
    ]
  },
  "advertiser": {
    "id": "987654321098765",
    "name": "Acme Corp",
    "alias": "acmecorp",
    "category": "Retail Company",
    "profileUri": "https://facebook.com/acmecorp",
    "profilePhoto": "https://example.cdn.net/images/acme_profile.jpg",
    "coverPhoto": "https://example.cdn.net/images/acme_cover.jpg",
    "entityType": "BRAND",
    "likes": 128400,
    "verification": "BLUE_VERIFIED",
    "isDeleted": false,
    "isRestricted": false,
    "isProfilePage": false,
    "igFollowers": 85200,
    "igUsername": "acmecorp_official",
    "igVerification": "BLUE_VERIFIED",
    "about": "Acme Corp is a global retailer of quality everyday products.",
    "spend": {
      "isPoliticalPage": false,
      "currentWeek": "500-999",
      "lifetimeByDisclaimer": [{ "disclaimer": "Acme Corp", "spend": "100000-499999" }],
      "weeklyByDisclaimer": [{ "disclaimer": "Acme Corp", "spend": "500-999" }]
    }
  },
  "aaaInfo": {
    "payerBeneficiaryData": [{ "payer": "Acme Corp", "beneficiary": "Acme Corp" }],
    "targetsEu": true,
    "hasViolatingPayerBeneficiary": false,
    "isAdTakenDown": false
  },
  "violationTypes": ["POLICY_VIOLATION"],
  "transparencyByLocation": {
    "euTransparency": {
      "targetsEu": true,
      "locationAudience": [
        { "name": "Germany", "numObfuscated": 0, "type": "countries", "excluded": false },
        { "name": "France", "numObfuscated": 0, "type": "countries", "excluded": false }
      ],
      "genderAudience": "All",
      "ageAudience": { "min": 18, "max": 65 },
      "euTotalReach": 34200,
      "ageCountryGenderReachBreakdown": [
        {
          "country": "DE",
          "ageGenderBreakdowns": [
            { "ageRange": "18-24", "male": 4200, "female": 3800, "unknown": 120 },
            { "ageRange": "25-34", "male": 8100, "female": 6500, "unknown": 210 }
          ]
        }
      ]
    },
    "brTransparency": null,
    "ukTransparency": null
  },
  "isViolatingEuSiep": false,
  "url": "https://www.facebook.com/ads/library/?id=123456789012345"
}

Meta Ad Library Scraper data output

The output from Meta Ad Library Scraper is stored in the dataset. After the run is finished, you can download the dataset in various data formats (JSON, CSV, XML, RSS, HTML Table).

❓FAQ

Do I need proxies to scrape ads from Meta Ad Library?

Proxy for this scraper is already preconfigured for optimal performance.

Support

For more custom/simplify outputs or Bug report please contact the developer (support (at) getmediumdata.com) or report an issue.