Facebook Ads Library Scraper - Spy on Competitor Ads avatar

Facebook Ads Library Scraper - Spy on Competitor Ads

Pricing

Pay per usage

Go to Apify Store
Facebook Ads Library Scraper - Spy on Competitor Ads

Facebook Ads Library Scraper - Spy on Competitor Ads

Facebook Ads Library scraper - search the Facebook Ad Library by keyword, country and ad type. Get advertiser, ad copy, creative images, status, start date and library ID. No login. Spy on competitor ads.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Hasnain Nisar

Hasnain Nisar

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

0

Monthly active users

19 days ago

Last modified

Share

Facebook Ads Library Scraper — Free Facebook Ad Library Scraper (No API Key)

The Facebook Ads Library Scraper pulls competitor ads at scale from the public Facebook Ads Library / Facebook Ad Library — ad creative copy, images, status (active/inactive), start dates, target location, and Meta's unique Library ID. Search the Ads Library (Facebook) by keyword, brand, or advertiser and get clean JSON with no API key, no login, and no rate-limit headaches. This Facebook Ad Library scraper is the go-to tool for competitor ad research, building a swipe file of winning creative, and market intelligence across any niche.

What does the Facebook Ads Library Scraper Actor do?

The Facebook Ads Library Scraper is a no-code tool that collects publicly available ads from Facebook's Ad Library transparency platform and exports them as JSON, CSV, or Excel. Pass a keyword, brand name, or advertiser and the actor returns a structured list of ads — the exact creative and metadata Meta serves in its own UI. Filter by country, ad type, and status to narrow results to your jurisdiction or category.

  • Spy on competitor Facebook ads — see every ad a rival brand is currently running
  • Extract ad creative copy — the actual ad body text Meta publishes
  • Get ad creative images — the first creative image URL per ad
  • Filter by ad statusactive, inactive, or ALL
  • Filter by country — any ISO 2-letter code or ALL worldwide
  • Filter by ad type — all ads, or political/issue, housing, employment, and credit categories
  • Capture impressions range and start dates — when Meta publishes them
  • Bulk-friendly — up to 200 ads per query, scriptable into batch runs

What data can I extract from the Facebook Ads Library?

Each ad record contains the following fields:

FieldDescription
advertiserAdvertiser name
page_nameFacebook Page running the ad
ad_textAd creative copy (body text)
ad_creative_bodyAd creative body (full text)
image_urlFirst creative image URL
ad_creative_image_urlCreative image URL
platformPlatform the ad runs on (e.g. Facebook)
statusAd status (active / inactive)
ad_delivery_statusDelivery status reported by Meta
start_dateDate the ad first ran
impressionsImpressions range (lower_bound / upper_bound) when published
target_locationGeographic targeting
library_idFacebook's unique Ad Library ID

How to scrape the Facebook Ads Library (step-by-step)

  1. Open the Facebook Ads Library Scraper on Apify and click Try for free.
  2. Enter a query — a keyword, brand, or advertiser name (e.g. "marketing software").
  3. Set the country (ISO 2-letter code or ALL) and ad type filter.
  4. Choose a status: active, inactive, or ALL, and set Max ads (1–200).
  5. Click Start and let the actor harvest ads from the public Ad Library.
  6. Export results to JSON, CSV, Excel, or Google Sheets, or pull them via the Apify API.
  7. To cover several keywords, run the actor once per keyword and merge the datasets.

Input

FieldTypeDefaultDescription
querystringKeyword or advertiser name to search the Ads Library (e.g. "crypto wallet", "Nike"). Required.
countrystringALLTwo-letter ISO country code (e.g. US, DE, GB) or ALL for worldwide.
adTypestring (enum)ALLALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, EMPLOYMENT_ADS, or CREDIT_ADS.
statusstring (enum)activeFilter by active, inactive, or ALL.
maxResultsinteger20Maximum ads to return (1–200).
proxyConfigurationobjectApify proxyRoutes through Apify Proxy; US residential recommended for English-locale content.

Example input:

{
"query": "marketing software",
"country": "US",
"adType": "ALL",
"status": "active",
"maxResults": 50
}

Output example

{
"advertiser": "Acme Corp",
"page_name": "Acme Corp",
"ad_text": "Try our new productivity tool — 50% off the first month!",
"ad_creative_body": "Try our new productivity tool — 50% off the first month!",
"image_url": "https://scontent.xx.fbcdn.net/...",
"ad_creative_image_url": "https://scontent.xx.fbcdn.net/...",
"platform": "Facebook",
"status": "active",
"ad_delivery_status": "active",
"start_date": "2024-08-15",
"impressions": { "lower_bound": 50000, "upper_bound": 100000 },
"target_location": "United States",
"library_id": "1234567890123456"
}

Use cases

  • Competitor ad research — enumerate every ad your top competitors are currently running.
  • Ad copy inspiration — surface high-frequency messaging in your category for new creative.
  • Creative swipe file — build a library of winning ad creative and images.
  • Compliance and due diligence — verify a brand's political or issue ad activity.
  • Market intelligence — measure share-of-voice and ad volume across a category.
  • PR and journalism — investigate political and issue ad spend and targeting.

Pricing

The Facebook Ads Library Scraper runs on Apify's usage-based pricing — you pay for the compute units and proxy traffic each run uses, with no separate subscription. A 20-ad scrape completes in 15–25 seconds and a 200-ad scrape in 30–50 seconds (memory ~1 GB for Chromium). See the actor's Pricing tab for current rates and free-tier credits.

Why this Facebook Ads Library Scraper?

Meta's official Ad Library API is limited and gated, and DOM-only scrapers break whenever the page markup changes. This actor uses both approaches: it intercepts the GraphQL responses that power Facebook's own Ad Library UI for the cleanest, most accurate metadata, and falls back to a DOM-based "Library ID"-anchored scraper when GraphQL isn't available. Combined with country, ad-type, and status filters, that makes it a reliable way to monitor competitor campaigns without tokens or approvals.

FAQ

The Facebook Ads Library is a transparency tool that Meta itself publishes for journalists, researchers, advertisers, and the public, so the data is public by design. Scraping public data is broadly permitted, but you remain responsible for complying with Meta's Terms of Service and applicable laws such as GDPR and CCPA.

Do I need a Facebook account or Ad Library API key?

No. The actor works on the public Ad Library pages with no login and no Meta Ad Library API token.

How much does it cost to scrape Facebook ads?

It runs on Apify's pay-as-you-go pricing, so cost scales with how many ads you scrape and the proxy traffic used. Small runs are inexpensive and the free tier covers testing. See the Pricing tab for exact figures.

How many ads can I scrape and how fast?

Up to 200 ads per query. A 20-ad scrape finishes in ~15–25 seconds and a 200-ad scrape in ~30–50 seconds.

Can I get spend and impression numbers?

Meta only publishes impressions and spend for political and issue ads. For commercial ads, those fields are typically empty.

Why do some queries return 0 ads?

Either no ads match, the country filter is too narrow, or Meta is rate-limiting. Try a broader query, switch country to ALL, or re-run.

Can I export the ads to CSV, Excel, JSON, or Google Sheets?

Yes. Every dataset can be exported to JSON, CSV, Excel, XML, or Google Sheets, or fetched via the Apify API.

How do I scrape ads for multiple keywords?

Run the actor once per keyword and merge the datasets, or trigger it through the Apify API in a loop for fully automated batch runs.

How do I scrape the Facebook Ad Library?

Open the actor, enter a query (keyword, brand, or advertiser name), set the country (ISO 2-letter code or ALL), ad type, and status (active, inactive, or ALL), choose Max ads (1–200), and click Start. It harvests ads straight from the public Ad Library — no login and no Meta Ad Library API token — and you export to JSON, CSV, Excel, or Google Sheets.

Can I spy on a competitor's Facebook ads?

Yes. Search by a rival brand, Page, or advertiser name to enumerate the ads they are currently running, with active/inactive/ALL status filtering. Each record includes the ad creative copy, the first creative image URL, start date, target location, and Library ID — everything you need for competitor ad research and a swipe file of winning creative.

What data can I get from the Facebook Ads Library?

Per ad you get the advertiser and Page name, ad creative copy/body text, the creative image URL, platform, status and delivery status, start date, target location, Meta's unique Library ID, and an impressions range when Meta publishes it. Note that impressions and spend are only published for political and issue ads; for commercial ads those fields are typically empty.

Support

Need an extra field, filter, or output format? Open an issue on the actor's Issues tab. Custom ad-intelligence solutions and integrations are available on request.