Facebook Ad Library Scraper

Scrape Facebook and Instagram ads from the Meta Ad Library by keyword or advertiser Page. This Facebook Ad Library scraper — also a Meta ads scraper and competitor ad spy tool — pulls every running and past ad with full creative, media and lifecycle data, with no login, no cookies and no API key.

Give it keywords (a brand, product or topic) or exact advertiser Page IDs, and it returns the ad creative text, image and video URLs, dates, platforms, status and — for political and issue ads — spend and impressions. Export to CSV, JSON or Excel for ad creative research and competitor intelligence at scale.

No login · No cookies · No API key · Thousands of ads per search · Facebook + Instagram

Facebook Ad Library API alternative · Scrape Facebook ads without login · Meta Ad Library export CSV · Facebook ad creative scraper · Instagram ads scraper

---

What you get

Each ad is saved as one structured record with these fields:

• pageName / pageId / pageUrl — the advertiser behind the ad
• pageCategories / pageLikeCount — advertiser context
• bodyText / title / caption / cardTexts — all ad creative text
• ctaText / ctaType / linkUrl — call-to-action and landing page
• media — every image & video URL in the ad (including each carousel card)
• publisherPlatform — Facebook / Instagram / Messenger / Audience Network
• startDate / endDate / totalActiveTime — ad lifecycle
• isActive / status — whether the ad is currently running
• spend / currency / impressions / reachEstimate — transparency data for political & issue ads
• adArchiveId / adLibraryUrl — stable ad ID and a direct link to the ad

Export every field to CSV, JSON, Excel or HTML, or pull it via the Apify API and webhooks.

---

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.

---

How to use

No code required:

1. Open the actor on Apify and click Try for free.
2. Enter keywords in searchTerms (a brand, product or topic) and/or exact advertiser Page IDs in pageIds.
3. (Optional) Set country, adType, activeStatus, mediaType and maxResults. Keep the residential proxy on (required by Meta).
4. Click Start.
5. Export to CSV, Excel or JSON, or pull via the Apify API.

Tip: add many keywords or Page IDs and raise maxResults to assemble a large ad-creative dataset in a single run. Find a Page ID in any ad's Ad Library URL (view_all_page_id=...).

Input fields

Field	Type	Description
searchTerms	array	Keywords or advertiser names (nike, crypto, real estate).
pageIds	array	Optional. Exact Facebook Page IDs to pull all ads from one advertiser.
country	string	Two-letter country code (US, GB, DE…) or ALL. Default US.
adType	string	all, political_and_issue_ads, housing_ads, employment_ads, credit_ads.
activeStatus	string	all, active, or inactive.
mediaType	string	all, image, video, meme, image_and_meme, none.
maxResults	integer	Total ads to collect across all searches. 0 = unlimited. Default 200.
proxyConfiguration	object	Residential proxy (required by Meta). Pre-configured for you.

Provide at least one value in searchTerms or pageIds.

Example input

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

Target a single advertiser by Page ID:

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

Example output

{
  "adArchiveId": "1289230176685703",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=1289230176685703",
  "pageId": "15087023444",
  "pageName": "Nike",
  "status": "active",
  "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.",
  "ctaText": "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,
  "impressions": null,
  "searchedFor": "nike",
  "scrapedAt": "2026-06-04T10:00:00.000Z"
}

---

How it works

You provide keywords and/or advertiser Page IDs plus a target country. The actor opens the public Meta Ad Library for each search to establish a valid session, then paginates the results, parsing every ad into a clean record. Filters (ad type, active status, media type) are applied and results stream to your dataset, de-duplicated by ad ID. It reads only the public Ad Library over residential proxies — no login, no cookies, no developer API key, and no account is ever used or risked.

---

FAQ

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.

---

Works great with

• Website Contact & Email Scraper — enrich advertiser landing pages with contact details.
• Instagram Profile Scraper — pair ad creatives with the advertiser's organic presence.

---

Pricing & support

Pay-per-result. Collects publicly available Ad Library data only — you are responsible for compliance with Meta's Terms and applicable laws, including bulk-access limits. Need a specific field or country coverage? Open an issue on the actor's page.

📝 Changelog

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.