Scraping the Facebook Ads Library at Scale (2026 Guide)

Why people scrape the Facebook Ads Library

Meta's Ads Library is a transparency database containing every active (and recently inactive) ad running across Facebook, Instagram, Messenger, and the Audience Network. Originally introduced as a political advertising transparency tool, it now covers all ad categories — and the data it holds about competitor ad strategy is unmatched by any commercial intelligence platform.

Every brand running Meta ads is effectively publishing their creative strategy, messaging angles, landing page tests, and seasonal campaign patterns into the Ads Library. Unlike most competitive intelligence sources, this data is current, verified (it reflects actual live or recently paused ads), and covers creative and copy simultaneously.

Competitor ad creative research

Performance marketers and creative strategists use Ads Library data to understand what their competitors are currently running — not just what worked historically. When a competitor launches 15 ad variants in a week, that is a signal about a campaign test or product push. When they run the same creative unchanged for 90 days, that is a signal it is converting. The Ads Library gives you a window into this without any guesswork.

Ad copy and angle analysis

Copywriters and growth teams use the Ads Library to audit the messaging angles competitors lean on across their active ad portfolio. Which emotional hooks appear repeatedly? Which product benefits lead the headline? Which CTAs are most common? Aggregate ad copy from 50 competitors in a category and you get a map of the messaging landscape — useful both for differentiation and for identifying proven angles worth testing.

Political and regulatory research

Journalists, academics, and policy researchers use the Ads Library as a primary source for studying political advertising patterns, messaging segmentation, and campaign spending. The political ad subset includes mandated spend disclosures and demographic targeting data that makes it particularly valuable for election research and accountability reporting.

Why the Ads Library is hard to extract at scale

Meta offers an official Ads Library API — but with significant limitations that make it impractical for most use cases that need breadth or speed:

API rate limits and access restrictions

The official Meta Ads Library API imposes strict rate limits: 10 requests per hour on the free tier, with a maximum of 1,000 results per request regardless of tier. Extracting even a modest dataset of 10,000 ads for a single brand across a 90-day window can require days of queued requests at the free tier. Developer apps require Meta review and approval, which can take weeks and may be rejected without clear rationale.

Filtering limitations in the official API

The official API's filtering is limited to keyword search, country, ad type, and date range. More granular filtering — by page category, ad format, impression volume, or active status — requires either post-processing massive result sets or using the web interface manually. Neither is practical at scale.

Web interface anti-scraping protections

The Ads Library website itself employs bot detection, dynamic content rendering via JavaScript, and session-based pagination that makes direct web scraping technically complex. Even though the data is intended to be publicly accessible, Meta's infrastructure treats automated access to the web interface the same as scraping any other Meta property — with CAPTCHA challenges and session invalidation for traffic patterns that deviate from human browsing.

Creative asset retrieval

Ad creative — images, video thumbnails, carousel assets — is served from CDN URLs that expire. Capturing and preserving creative assets at scale requires downloading them during extraction, not after, which adds infrastructure requirements beyond what a simple data scraper handles.

What data you can extract

A well-built Facebook Ads Library scraper returns structured records for each ad, including creative and metadata. Core fields:

Actor input

The Facebook Ads Library Scraper takes search parameters that mirror the Ads Library interface. No Meta developer app or API credentials needed.

{
  "searchTerms": ["running shoes", "athletic wear"],
  "pageNames": ["Nike", "Adidas", "Under Armour"],
  "country": "US",
  "adType": "all",
  "adStatus": "active",
  "maxAdsPerSearch": 200
}

Key input parameters:

• searchTerms — Keywords to search across ad copy and page names. Accepts multiple terms.
• pageNames — Specific Facebook Page names or IDs to pull all ads for. Ideal for competitor monitoring.
• country — ISO country code (e.g., US, GB, DE) or ALL for global results.
• adType — Filter by format: all, image, video, carousel, collection.
• adStatus — active for currently running ads, inactive for recently stopped, or all.
• maxAdsPerSearch — Cap on ads to return per search term or page. Set to 0 for unlimited.

Actor output

Each result is a flat JSON record for a single ad. Here is a representative example:

{
  "adId": "1234567890123456",
  "pageName": "SampleBrand",
  "pageId": "987654321",
  "adBody": "Tired of shoes that fall apart after 3 months? Our reinforced sole technology lasts 3x longer — guaranteed or your money back.",
  "adTitle": "Built to Last. Finally.",
  "adDescription": "Free shipping on orders over $75. 60-day returns.",
  "callToAction": "Shop Now",
  "adType": "image",
  "creativeUrl": "https://scontent.fb-cdn.net/ads/sample-creative.jpg",
  "startDate": "2026-03-15",
  "isActive": true,
  "countries": ["US", "CA"],
  "impressions": "1,000,000 - 2,000,000",
  "spend": null,
  "landingPageUrl": "https://samplebrand.com/collections/running"
}

Use cases

1. Competitor creative audits

Growth teams and creative agencies run Ads Library audits before launching new campaigns. The workflow: pull all active ads for 5–10 competitors in a category, analyze ad format distribution (image vs. video vs. carousel), identify the most-used CTAs, extract recurring headline patterns, and note which landing page destinations are being tested. This audit — which takes hours manually — becomes a 20-minute data extraction when the structured records are available in bulk. The result is a competitive creative brief grounded in what competitors are actually investing in, not anecdote.

2. Ad copy research and angle testing

Performance copywriters use bulk Ads Library data to map the messaging landscape in a category. Extract 1,000 ads from brands in your vertical, cluster the ad body text by theme (price appeals, social proof, product features, fear/urgency, identity), and calculate the distribution. Categories that are over-indexed on price appeals leave room for differentiation on other angles. Patterns that appear repeatedly across many competitors are either proven to work or represent herd behavior — both are actionable insights for copy testing.

3. Media buying intelligence

Media buyers and agency planners use Ads Library data to calibrate spend estimates and campaign pacing. The impression range data, while disclosed in ranges rather than exact figures, gives a relative signal: an ad with 5–10M impressions that has been running for 60 days is working. An ad that launched and stopped within two weeks likely did not. Tracking ad start and end dates across a competitor's portfolio over time reveals seasonal patterns, product launch timing, and promotional cadences that inform your own media planning calendar.

4. Political ad monitoring and research

Journalists, academic researchers, and advocacy organizations use the Ads Library to monitor political advertising patterns. The political and issue-based ad subset includes mandated spend disclosures and estimated reach data. Tracking which candidates or organizations are running ads, where, and with what messaging gives verifiable, primary-source data for election coverage and political analysis. Unlike third-party reporting, Ads Library data comes directly from Meta's transparency infrastructure.

Pricing

The Facebook Ads Library Scraper runs on Apify's pay-per-result model. You pay only for successfully extracted ad records.

For teams running ongoing competitive monitoring — weekly creative pulls for a set of competitor pages, monthly category sweeps, or campaign-timed competitor tracking — the actor integrates with Apify's scheduling system for automated recurring runs without infrastructure management on your end.

Conclusion

The Facebook Ads Library contains the most comprehensive public view of competitor advertising strategy available anywhere — but the official API's rate limits and the web interface's anti-automation protections make extracting it at scale impractical without a managed solution.

For growth teams, agencies, and researchers that need structured Ads Library data in bulk, the Facebook Ads Library Scraper handles the extraction complexity and returns clean JSON records with ad copy, creative URLs, active status, impression ranges, and landing page destinations.

If you are building competitive creative intelligence tools, ad monitoring pipelines, or research datasets that depend on Meta advertising data at scale, it is a practical starting point. Start a free run on Apify →