Facebook/Meta Ads Library Scraper API $0.5/1k

Facebook / Meta Ads Library Scraper & API

Extract public advertisements from the Meta Ad Library across Facebook, Instagram, Threads, Messenger, WhatsApp, and Audience Network in seconds—with no login credentials required.

Search by keyword, Facebook Page URL, Instagram @handle, pasted Meta Ad Library URL, or Ad Archive ID, and export a clean flat dataset ready for Excel, CSV, Google Sheets, Pandas, or AI workflows.

---

Key Capabilities & Extracted Data

• Flexible Multi-Input Discovery:
  • Keywords & Exact Phrases: Search broad or exact-phrase keywords across any country or ALL worldwide.
  • Facebook Page URLs: Pass any brand page URL (https://www.facebook.com/nike, https://www.facebook.com/shopify)—automatically resolves the advertiser's Page ID and extracts its entire ad catalog.
  • Instagram Profiles & Handles: Pass @gymshark or https://www.instagram.com/gymshark/ to resolve the linked advertiser account and collect its active creatives.
  • Pasted Ad Library URLs & Single Ad IDs: Paste filtered facebook.com/ads/library/?... URLs or individual adArchiveId strings directly.
• Complete Creative & Funnel Intelligence:
  • Direct HD & SD .mp4 video URLs, high-resolution creative images, video thumbnails, and multi-card Carousel / Dynamic Product (carouselCards) breakdowns.
  • Unwrapped destination linkUrl (automatically strips l.facebook.com redirect wrappers), clean linkDomain, ctaText (Shop Now, Learn More), ctaType, headline title, and full bodyText.
  • activeDays, isLongRunningWinner (30+ days active signal), and collationCount (number of active variations running the same creative).
• Advertiser & Linked Instagram Enrichment:
  • Facebook pageId, pageName, pageCategory, pageLikes, pageAbout, plus linked igUsername, igFollowers, and igVerified.
• EU DSA Reach Demographics & Political Spend Transparency:
  • EU / UK Regulated Ads: Extracts euTotalReach, payer, beneficiary, target age/gender/locations, and per-country euAgeGenderBreakdown matrices when provided by Meta's transparency disclosures.
  • Political & Social Issue Ads: Extracts spendText (spendLower / spendUpper), impressionsText (impressionsLower / impressionsUpper), currency, and byline disclaimers.

Upstream Data Availability Note: Meta provides creative assets, placements, active duration, variant counts, and advertiser/Instagram profile stats on all public ads. Exact euTotalReach and age/gender/location breakdowns are published by Meta on ads delivered to EU / EEA and UK (GB) audiences (country: "DE", "FR", "NL", "GB", etc.; declared payer and beneficiary entities apply to EU DSA jurisdictions), while spendText and impressionsText ranges are published by Meta on Political, Election & Social Issue ads.

---

Transparent Pay-Per-Event Pricing

Pay strictly for successfully extracted ads—$0.00 result fee on empty searches:

Apify Plan Tier	Price per Ad	Price per 1,000 Ads
Free	$0.00075	$0.75 / 1K
Bronze	$0.00065	$0.65 / 1K
Silver	$0.00055	$0.55 / 1K
Gold / Platinum / Diamond	$0.00050	$0.50 / 1K

(Includes a one-time $0.0005 Actor start event per run.)

---

Quick Start Input Examples

1. Scrape Competitor Ads by Brand Facebook Page URL & Instagram Placement

{
  "urls": [
    "https://www.facebook.com/nike",
    "https://www.facebook.com/shopify"
  ],
  "country": "US",
  "activeStatus": "active",
  "mediaType": "video",
  "publisherPlatforms": ["instagram", "facebook"],
  "scrapeAdDetails": true,
  "maxItems": 50
}

2. Search Keyword Ads in Germany with EU DSA Reach & Demographics

{
  "queries": ["Zalando"],
  "country": "DE",
  "activeStatus": "active",
  "sortBy": "impressions",
  "scrapeAdDetails": true,
  "maxItems": 30
}

3. Political & Issue Ad Spend Research

{
  "queries": ["energy"],
  "country": "US",
  "adType": "political_and_issue_ads",
  "activeStatus": "all",
  "startDateMin": "2026-01-01",
  "maxItems": 50
}

---

Flat Output Sample

Every dataset item uses a flat root-level schema for 1-click CSV/Excel exports:

{
  "adArchiveId": "990123456789012",
  "adUrl": "https://www.facebook.com/ads/library/?id=990123456789012",
  "collationId": "440987654321000",
  "collationCount": 6,
  "isActive": true,
  "startDate": "2026-02-10T08:00:00+00:00",
  "endDate": null,
  "startTimestamp": 1770710400,
  "endTimestamp": null,
  "activeDays": 48.5,
  "isLongRunningWinner": true,
  "monitorStatus": "snapshot",
  "pageId": "100200300400",
  "pageName": "Acme Sportswear",
  "pageUrl": "https://www.facebook.com/acmesportswear/",
  "pageAlias": "acmesportswear",
  "pageCategory": "Apparel & clothing",
  "pageLikes": 412900,
  "pageAbout": "Performance running apparel and footwear.",
  "igUsername": "acmesportswear",
  "igUrl": "https://www.instagram.com/acmesportswear/",
  "igFollowers": 285400,
  "igVerified": true,
  "displayFormat": "VIDEO",
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
  "publisherPlatformsText": "FACEBOOK, INSTAGRAM",
  "title": "Spring Marathon Collection",
  "bodyText": "Engineered for race day comfort. Free express shipping on orders over $75.",
  "ctaText": "Shop Now",
  "ctaType": "SHOP_NOW",
  "linkUrl": "https://shop.example.com/collections/marathon",
  "linkDomain": "shop.example.com",
  "primaryImageUrl": null,
  "primaryVideoHdUrl": "https://video.example.com/v/creative_hd.mp4",
  "videoCount": 1,
  "cardCount": 0,
  "payer": "Acme Sportswear GmbH",
  "beneficiary": "Acme Sportswear GmbH",
  "euTargetsEu": true,
  "euTotalReach": 184250,
  "euGenderAudience": "All",
  "euAgeMin": 18,
  "euAgeMax": 65,
  "euTargetLocations": ["Germany", "Austria"],
  "euLocationCountriesText": "Germany, Austria",
  "euAgeGenderBreakdown": [
    {
      "country": "DE",
      "ageRange": "25-34",
      "male": 31200,
      "female": 42800,
      "unknown": 310,
      "total": 74310
    }
  ],
  "countryFilter": "DE",
  "searchQuery": "Acme Sportswear",
  "inputSource": "keyword",
  "detailLevel": "full",
  "scrapedAt": "2026-03-30T12:00:00+00:00"
}

---

Multi-Batch Pagination, CSV Export & Support

• Clean CSV / Excel Exports: Select the Meta Ads Library Overview view in the Console Output tab (or append ?view=overview&format=csv via API) for a 24-column flat spreadsheet free of nested carousel/demographic arrays.
• Zero-Duplicate Resumption: When maxItems (>20) or a run spending limit is reached before exhausting results, the Actor saves a compact RESUMPTION_TOKEN record in the run's default Key-Value Store. Pass resumptionToken into your next run to continue seamlessly without duplicate records.
• Issues & Feature Requests: Need help or have a feature request? Open a ticket directly in the Issues tab on this Actor page in Apify Console.