Facebook Ad Library Scraper - Meta Ads Spy Tool avatar

Facebook Ad Library Scraper - Meta Ads Spy Tool

Pricing

from $3.50 / 1,000 results

Go to Apify Store
Facebook Ad Library Scraper - Meta Ads Spy Tool

Facebook Ad Library Scraper - Meta Ads Spy Tool

Facebook Ad Library scraper & API alternative. Scrape Facebook + Instagram ads with no login, get creative, media, spend; export to CSV/JSON.

Pricing

from $3.50 / 1,000 results

Rating

0.0

(0)

Developer

Logiover

Logiover

Maintained by Community

Actor stats

0

Bookmarked

65

Total users

6

Monthly active users

5 days ago

Last modified

Features

Limited permissions

Share

Facebook Ad Library Scraper โ€” Meta Ads Spy Tool, Creatives & Spend (No API Key)

Facebook Ad Library Scraper โ€” Meta Ads Spy Tool

Apify Actor No login No API key Pay per result Ad Intelligence Export

Scrape Facebook and Instagram ads from the Meta Ad Library by keyword or advertiser Page โ€” every running and past ad with full creative text, image & video URLs, platforms, lifecycle dates, status and (for political & issue ads) spend, impressions and reach. Give it keywords or exact Page IDs and get analysis-ready records back. No login, no cookies, no developer API key.

๐Ÿ† Why this Meta Ad Library scraper?

No login, no cookies, no account risk ยท Facebook + Instagram creatives (images, videos & every carousel card) ยท thousands of ads per search ยท political-ad spend, impressions & reach ยท export to JSON / CSV / Excel. The unofficial Facebook Ad Library API alternative for competitor ad spy, creative research and market intelligence.


โœจ What this Actor does / Key features

  • ๐Ÿ•ต๏ธ Competitor ad spy โ€” swipe winning creatives and angles from any competitor's Page.
  • ๐Ÿ”“ No login, no cookies, no API key โ€” reads the public Meta Ad Library over residential proxies; no account is ever used or risked.
  • ๐Ÿ”Ž Keyword or Page-ID search โ€” pass a brand/product/topic term, exact advertiser Page IDs, or both.
  • ๐Ÿ–ผ๏ธ Full creative & media โ€” body text, title, caption, carousel card texts, CTA text/type, landing URL, plus every image and video URL (including each carousel card).
  • ๐Ÿ“ฑ Platform breakdown โ€” Facebook, Instagram, Messenger and Audience Network per ad.
  • โฑ๏ธ Ad lifecycle โ€” start date, end date, total active time, isActive and status.
  • ๐Ÿ’ธ Political-ad transparency โ€” spend range, currency, impressions and reach estimate for political & issue ads.
  • ๐ŸŽ›๏ธ Powerful filters โ€” country, ad type (political/housing/employment/credit), active status and media type.
  • ๐Ÿงฑ Clean structured output โ€” one row per ad, de-duplicated by ad ID, ready for JSON, CSV, Excel or the Apify API.

๐Ÿš€ Quick start (3 steps)

  1. Configure โ€” enter keywords in searchTerms (a brand, product or topic) and/or exact advertiser Page IDs in pageIds. Set country and any filters. Keep the residential proxy on (required by Meta).
  2. Run โ€” click Start. The Actor opens the public Ad Library for each search, paginates the results and streams ads into your dataset.
  3. Get your data โ€” open the Output tab and export to JSON, CSV, Excel or HTML, or pull it via the Apify API.

๐Ÿ“ฅ Input

Provide at least one value in searchTerms or pageIds. Everything else is optional.

Example โ€” keyword sweep across a brand & product term

{
"searchTerms": ["nike", "running shoes"],
"country": "US",
"adType": "all",
"activeStatus": "active",
"maxResults": 500
}

Example โ€” a single advertiser's complete ad history

{
"pageIds": ["15087023444"],
"country": "US",
"activeStatus": "all",
"maxResults": 1000
}

Example โ€” political & issue ads with spend & impressions

{
"searchTerms": ["climate"],
"country": "US",
"adType": "political_and_issue_ads",
"maxResults": 500
}
FieldTypeDescription
searchTermsarrayKeywords or advertiser names (nike, crypto, real estate).
pageIdsarrayOptional. Exact Facebook Page IDs to pull all ads from one advertiser.
countrystringTwo-letter country code (US, GB, DEโ€ฆ) or ALL. Default US.
adTypestringall, political_and_issue_ads, housing_ads, employment_ads, credit_ads.
activeStatusstringall, active, or inactive.
mediaTypestringall, image, video, meme, image_and_meme, none.
maxResultsintegerTotal ads to collect across all searches. 0 = unlimited. Default 200.
proxyConfigurationobjectResidential proxy (required by Meta). Pre-configured for you.

Finding a Page ID: open any of the advertiser's ads in the Meta Ad Library and copy the value of view_all_page_id=... from the URL. Add many keywords or Page IDs and raise maxResults to assemble a large ad-creative dataset in one run.

๐Ÿ“ค Output

One row per ad โ€” de-duplicated by ad ID, exportable to JSON, CSV, Excel or HTML. Here is a trimmed sample record:

{
"adArchiveId": "1289230176685703",
"adLibraryUrl": "https://www.facebook.com/ads/library/?id=1289230176685703",
"pageId": "15087023444",
"pageName": "Nike",
"pageCategories": ["Sportswear store"],
"pageLikeCount": 38000000,
"status": "active",
"isActive": true,
"startDate": "2026-05-14T00:00:00.000Z",
"endDate": "2026-06-04T00:00:00.000Z",
"publisherPlatform": ["FACEBOOK", "INSTAGRAM"],
"bodyText": "Run through summer with gear that can take the heat.",
"title": "Nike Summer Collection",
"ctaText": "Shop now",
"ctaType": "SHOP_NOW",
"linkUrl": "https://www.nike.com/",
"media": [
{ "type": "image", "url": "https://scontent.../ad-image.jpg" },
{ "type": "video", "url": "https://video.../ad-video.mp4" }
],
"spend": null,
"currency": null,
"impressions": null,
"reachEstimate": null,
"searchedFor": "nike",
"scrapedAt": "2026-07-06T10:00:00.000Z"
}

Additional output fields

These fields are also present in the dataset:

FieldTypeDescription
pageProfilePicturestringAdvertiser Page profile picture URL.
linkDescriptionstringDescription shown under the link.
displayFormatstringCreative format (image, video, carousel, DCO...).
bylinestringPaid-for-by byline (political ads).
disclaimerLabelstringAd disclaimer label.
spendLowerBoundnumberLower bound of estimated spend.
spendUpperBoundnumberUpper bound of estimated spend.
reachLowerBoundnumberLower bound of estimated reach.
reachUpperBoundnumberUpper bound of estimated reach.
targetedOrReachedCountriesโ€”Countries targeted or reached.
categoriesโ€”Ad category codes.
containsSensitiveContentbooleanWhether the ad is flagged as sensitive.
collationCountnumberNumber of ads collated together (near-duplicate variants).

๐Ÿ’ก Use cases

  • Competitor ad spy โ€” swipe winning ad creatives and angles from any competitor's Page.
  • Ad-creative research โ€” build an analysis-ready dataset of body text, headlines, CTAs and media.
  • Market & competitive intelligence โ€” track who's advertising what, where, and for how long.
  • Agency creative decks โ€” monitor client competitors automatically and assemble swipe files.
  • Political ad transparency โ€” analyse political & issue advertising with spend, impressions and reach.
  • Landing-page enrichment โ€” pipe linkUrl into a contact scraper to enrich advertiser landing pages with leads.

๐Ÿ‘ฅ Who uses it

Performance marketers & DTC brands ยท ad agencies & creative studios ยท competitive-intelligence analysts ยท market researchers ยท political-transparency journalists & watchdogs ยท growth teams building swipe files.

๐Ÿ’ฐ Pricing

This Actor runs on a simple pay-per-result model โ€” you pay for the ads you extract, with no separate Apify platform fees to calculate. Try it on the free tier first, then scale up. See the Pricing tab on this page for the current rate.

โ“ Frequently Asked Questions

Do I need a login, cookies or API key? No โ€” the Meta Ad Library is public. The Actor reads it over residential proxies with no account, so there's zero risk to any account.

Can I get an advertiser's complete ad history? Yes โ€” search by their exact Page ID and raise maxResults to pull every active and inactive ad the Ad Library exposes for that Page.

Do I get spend and impressions? For political & issue ads Meta publishes spend ranges, impressions and reach, and the Actor captures them. For ordinary commercial ads Meta does not disclose these (they come back null).

Are image and video URLs included? Yes โ€” every creative's image and video URLs are captured, including each card of carousel ads.

Is this a Facebook Ad Library API alternative?

Yes โ€” it's a no-API-key alternative to the Meta Ad Library API. It reads the public Ad Library directly, so you don't need a developer app, access token or review process to pull ad data.

How do I scrape Facebook ads without a login?

Just enter keywords or advertiser Page IDs and run it. The Actor reads the public Ad Library over residential proxies with no login, no cookies and no account, then returns every matching ad.

How do I export Meta Ad Library data to CSV or JSON?

Every ad is saved as a structured record you can export to CSV, JSON, Excel or HTML from the dataset, or pull via the Apify API and webhooks for ad-creative research at scale.

How do I see all ads a competitor is running on Facebook?

Enter the advertiser's exact Facebook Page ID and raise maxResults to pull every active and inactive ad the Ad Library exposes for that Page, with full creative.

How do I get spend and impressions for political ads?

Set adType to political_and_issue_ads: for these Meta publishes spend ranges, impressions and reach, and the scraper captures them in each record.

๐Ÿ”— More ad-intelligence & research scrapers by logiover

Building a full cross-platform ad-intelligence stack? Pair the Meta Ad Library scraper with the rest of the suite:

ActorWhat it does
LinkedIn Jobs ScraperLinkedIn job listings by keyword & location (no login)
Google Ads Transparency ScraperAdvertiser creatives & reach from Google's Ad Transparency Center
Competitor Ad IntelligenceMonitor rivals' live ad campaigns across networks
News Intelligence ScraperTrack brand mentions across the news
Google News ScraperReal-time headlines by keyword, topic or brand
SERP Keyword ResearchSearch-demand and keyword intelligence
Website Contact ScraperEnrich advertiser landing pages with contact details
GitHub Repository ScraperOpen-source momentum & competitor repo tracking

๐Ÿ‘‰ Browse all logiover scrapers on Apify Store โ€” 180+ actors across real estate, jobs, crypto, social media & B2B data.

โฐ Scheduling & integration

Schedule this Actor on Apify to monitor competitor Pages daily and catch new creatives within hours. Export results to JSON, CSV or Excel, sync to Google Sheets, or push to your database, BI tools and webhooks through the Apify API. Connect it to Make, n8n or Zapier to auto-route new ads into a Slack channel or an Airtable/Notion swipe file.

๐Ÿค– AI Agents, MCP & RAG Integration

Facebook Ad Library Scraper works natively as an on-demand data tool for AI assistants and autonomous workflows.

Connect this Actor directly to Apify AI, Claude Desktop, Cursor, VS Code, Windsurf, LangChain, or LlamaIndex via the official Apify MCP Server โ€” no custom wrapper code needed:

{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com?tools=logiover/meta-ad-library-scraper"
}
}
}
  • Schema-typed inputs & outputs: Clean JSON records with explicit .actor/input_schema.json and .actor/output_schema.json definitions so LLM agents infer parameters and parse fields accurately without HTML noise.
  • Bounded & predictable runs: Built-in volume caps and pay-per-result budget guards prevent runaway agent tool loops.
  • RAG & automation ready: Stream run datasets straight into vector stores, n8n, Make, Zapier, or webhook pipelines.

๐Ÿ’ฌ Support, Issues & Reviews

  • Bug reports & target-site changes: Hit an unexpected empty result or selector change? Open a ticket in the Issues tab with your Run ID or sample input โ€” we actively monitor issues and ship fixes fast.
  • Feature & field requests: Need an additional data attribute or filter? Request it in the Issues tab.
  • Enjoying this Actor? If it saved you engineering time, please consider leaving an honest review on Apify Store or bookmarking logiover/meta-ad-library-scraper โ€” organic developer feedback helps others discover reliable tools and keeps maintenance prioritized.

This Actor collects publicly available Meta Ad Library data only and is intended for legitimate ad-creative research, competitive analysis and transparency use. You are responsible for compliance with Meta's Terms and applicable laws, including bulk-access limits. Not affiliated with Meta Platforms, Inc.


Keywords: facebook ad library scraper, meta ads scraper, competitor ad spy, facebook ad library api alternative, scrape facebook ads without login, meta ad library export csv, facebook ad creative scraper, instagram ads scraper, political ad spend impressions, facebook advertiser scraper.


How much Facebook data can you extract in one run?

A single run returned 1,000 rows in 242 seconds on the example input, and it was still going when the measurement stopped โ€” raise the result limit and it keeps paginating. That is roughly 247 rows a minute.

There is no hard ceiling built into this Actor. What bounds a run is the result limit you set, the breadth of the input you give it, and how much Facebook itself publishes. Because billing is per result, a wider run costs proportionally more and a narrow one costs almost nothing โ€” so it is worth starting small and scaling once the output looks right.

Facebook scraping โ€” frequently asked questions

Do I need a Facebook API key, account or login?

No. This Actor reads publicly available pages and feeds, so there is nothing to register for and no credentials to manage.

How do I export Facebook data to CSV, Excel, JSON or Google Sheets?

Open the Storage tab after a run and pick the format you want โ€” CSV, Excel, JSON, XML or an HTML table. For Google Sheets, Airtable or a database, use the dataset URL or the Apify API so the sheet refreshes itself on every run.

Can I schedule this Facebook scraper to run daily or hourly?

Yes. Use the Schedules tab and pick a cadence. Daily is enough for most tracking work; pick hourly only if the rows you care about really do change that fast.

How many rows can I get, and what does it cost?

See the volume section above for a measured figure. Billing is per result, so you pay for the rows you actually receive and a run that finds nothing costs nothing.

This Actor collects only information that Facebook publishes publicly. It does not log in, does not defeat access controls and does not touch private data. You remain responsible for how you use the output, including under GDPR and similar rules where personal data is involved.

What happens if Facebook blocks the run or changes its layout?

A refused exit IP is swapped for a fresh one within a quarter of a second and retried, and rate limiting is waited out rather than fought. If nothing gets through, the run fails with the reason instead of reporting success with zero rows โ€” so an empty result always means "no matches", never "the source would not answer".

Can I use this with an AI agent, LangChain or an MCP client?

Yes. The Actor is callable over the Apify API and through Apify's MCP server, so an agent can run it and read the dataset back as a tool call.

๐Ÿ“ Changelog

2026-11-14

  • Verified live production health run (2026-11-14): extracted 35 structured records in 21.9s with valid schema output.
  • Hardened internal proxy stall fallback and pay-per-event dataset instance budget protection.

2026-11-11

  • Added reliable terminal run status telemetry and structured Apify AI / MCP Server (mcp.apify.com) tool configuration.
  • Added direct Issues & Reviews support links and refreshed live maintenance verification.

2026-11-01

  • Monthly health check (2026-11-01): a live run on the current build completed successfully and returned data. Input options, output fields and pricing are unchanged.
  • README refreshed: 3 links to retired Actors removed; documented 13 additional output fields.

2026-10-15

  • Every request now has a hard time limit, so a proxy connection that stalls can no longer hold up the run or push it past its timeout.
  • A run that reaches its maximum cost per run now stops cleanly with its results saved and a status message, instead of ending as aborted.
  • A proxy group your account cannot use no longer stops the run at start-up; it falls back to the default Apify Proxy.
  • Runs with a short timeout (API and AI-agent calls) now finish inside it with what they collected, instead of being cut off.
  • Memory is managed within the run's own limit, which removes a rare out-of-memory crash on large pages.
  • The prefilled example for maxResults is now 200 (was 30).
  • The default used when the field is left out for maxResults is now 4,958 (was 200).

2026-09-23

  • Fleet-wide quality audit. Verified end to end against live data and re-checked the input schema, the output columns and the run configuration.
  • Output verified on a live run: 40 columns returned, 64.8% of cells populated.
  • Run reliability reviewed: 97.7% of public runs succeeded in the last 30 days.
  • Input schema, output schema and pricing configuration reviewed.
  • Noted that 12 column(s) came back empty in this sample (totalActiveTime, byline, disclaimerLabel, spend, spendLowerBound, spendUpperBound and others); these are under review.

2026-09-01

  • Fleet-wide health check. Verified against this Actor's real run history: 30-day success rate, output row counts, per-field fill rates, and peak memory against the configured memory limit.
  • Reviewed for the failure patterns that have cost this fleet runs โ€” unguarded proxy setup, retry loops that can outlast the run's own time budget, and full-page HTML parsing that can exhaust a small container.
  • No change to input, output fields or scraping logic.

2026-08-11

  • Maintenance release: refreshed the build and dependencies.
  • Re-verified live execution, non-empty structured output and dataset field/type integrity.
  • Reviewed reliability (retries, pagination) and output quality as part of a full-fleet QA pass.

2026-08-01

  • Completed the August 2026 full health check: verified empty/programmatic default, Console UI default, and two source-informed alternative inputs on Apify.
  • Confirmed successful live execution, non-empty structured output, dataset-field/type integrity, and logical sample quality within the 5-minute quality window.

2026-07-06

  • โœจ README overhaul: shields badge row, green highlight callout, richer trimmed output sample, collapsible full field reference, extra ready-to-run examples, ad-intelligence suite cross-links and clearer quick-start.

2026-07-01

  • Maintenance pass: re-verified end-to-end on live data and confirmed successful runs within the 5-minute quality window on the default input.
  • Sharpened Store metadata (SEO title & description) and expanded the FAQ with high-intent, long-tail questions for easier discovery in Google and Apify Store search.
  • Added ready-to-run example tasks that cover common real-world use cases.

2026-06-15

  • Reliability pass: re-verified end-to-end on live data with real-world inputs. Routine maintenance build.

2026-06-07

  • Docs: added coverage for using this as a Facebook Ad Library API alternative, scraping Facebook ads without login, and exporting Meta Ad Library data to CSV/JSON.

2026-06-05

  • ๐Ÿ›ก๏ธ Reliability fix: results are no longer dropped by strict output validation โ€” runs now complete cleanly even at high volume (thousands of results).
  • โšก Stability & performance hardening; fresh rebuild.

2026-06-04

  • Initial release โ€” keyword & Page ID search, full creative + media, lifecycle, platform breakdown and political-ad spend/impressions.

*Maintained: last verified 2026-11-14 โ€” checked end-to-end against live run history (reliability, output fields and types, and time/memory budgets).