Facebook Ad Library Scraper - Competitor Ads, Creatives, No Login

Spy on any brand's live Facebook & Instagram ads. This scraper pulls structured data straight from the public Facebook Ad Library (the transparency database Meta is legally required to keep open) — no login, no cookies, no Facebook account needed.

Search by advertiser (e.g. Nike) or by keyword (e.g. skincare, black friday) in any country, and get back the full ad creative: copy, headline, images, video URLs, CTA, destination link, platforms, run dates, and how many variants the advertiser is testing.

Perfect for ad spying, competitor research, creative inspiration, and agency ad-intelligence reports.

---

What you get per ad

Field	Example
pageName / pageId	Nike / 15087023444
adArchiveId + adLibraryUrl	direct link to the ad in the Library
isActive, startDate, endDate	running since 2026-03-17
platforms	["FACEBOOK","INSTAGRAM","AUDIENCE_NETWORK","MESSENGER"]
mediaType	IMAGE / VIDEO / CAROUSEL / DPA
title, body, caption	full ad copy
ctaText, ctaType	Shop now / SHOP_NOW
linkUrl, linkDescription	destination landing page
imageUrls, videoUrls, videoPreviewUrls	downloadable creative assets
cards	every card of a carousel ad (image/video + copy + link)
variantCount	how many versions the advertiser is A/B testing
pageLikeCount, pageCategories, pageProfilePicture	advertiser profile
spend, impressions, currency	populated for political/issue ads
containsDigitalCreatedMedia	AI-generated creative flag

---

Example output

{
  "adArchiveId": "1869276447125570",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=1869276447125570",
  "pageName": "Nike",
  "pageId": "15087023444",
  "isActive": true,
  "startDate": "2026-03-17T07:00:00.000Z",
  "endDate": "2026-06-11T07:00:00.000Z",
  "platforms": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER"],
  "mediaType": "CAROUSEL",
  "title": "Nike: Shoes, Apparel, Stories",
  "body": "Celebrate your birthday with Nike and unlock exclusive products, free shipping and returns.",
  "ctaText": "Shop now",
  "ctaType": "SHOP_NOW",
  "linkUrl": "https://www.nike.com/...",
  "imageUrls": ["https://scontent.xx.fbcdn.net/.../creative.jpg"],
  "videoUrls": [],
  "variantCount": 6,
  "cards": [ { "title": "...", "body": "...", "imageUrl": "...", "linkUrl": "..." } ],
  "queriedCountry": "US",
  "scrapedAt": "2026-06-12T09:00:00.000Z"
}

---

Input

Field	Description	Default
searchQuery ✅	Brand/advertiser name or keyword (what you'd type in the Library search box)	Nike
country	Two-letter country code for ad delivery (US, GB, CA, AU, DE, BR…)	US
adType	all (commercial) or political_and_issue (adds spend & impressions)	all
activeStatus	active, inactive, or all	active
mediaType	all, image, video, meme, image_and_meme, none	all
maxResults	Max ads to return (1–2000)	50
proxyCountry	Residential proxy country (required — see below)	US

Minimal input

{ "searchQuery": "Nike", "country": "US", "maxResults": 50 }

---

Use cases

• Ad spying — see exactly what creatives a competitor is running right now, across FB & Instagram.
• Competitor research — track which offers, hooks and landing pages a brand pushes, and how many variants they test.
• Creative inspiration — build a swipe file of winning ad copy + creative for your niche.
• Agencies — generate ad-intelligence reports for clients in seconds; export to Sheets/Looker.
• Trend monitoring — schedule daily runs on a keyword to catch new advertisers entering a market.

---

Pricing

This actor uses pay-per-event pricing:

• $0.005 per actor start
• $0.01 per ad returned

A typical 50-ad run costs about $0.51. You only pay for ads actually returned.

---

How it works (and reliability notes)

The Facebook Ad Library is a public, login-free transparency tool. This actor:

1. Loads the public Library search page through a residential proxy.
2. Harvests the ads embedded in the page, then drives Facebook's own ad-search GraphQL query by cursor to paginate.

Residential proxy is required. Facebook rate-limits ad pagination from datacenter IPs. The actor uses Apify Residential proxy by default; pick the proxyCountry that matches your target market for best results. If a run is partially rate-limited, simply rerun — each run gets a fresh IP.

political_and_issue ads additionally expose spend ranges and impressions (Meta publishes these for political advertising); commercial ads do not include spend/impression numbers (Meta does not publish those publicly).

---

Not affiliated with or endorsed by Meta. Scrapes only the public, login-free Ad Library transparency data.

---

Frequently asked questions

Is the Facebook Ad Library scraper free to use without a Facebook login? Yes. This Facebook Ad Library scraper reads Meta's public ad transparency database directly, so you never log in, never connect a Facebook account, and never paste cookies. The Ad Library is a public resource Meta is legally required to keep open, and this actor scrapes only that public data.

Can I scrape competitor ads by brand name? Yes. Put the advertiser or brand name in searchQuery (for example Nike, Gymshark, or Shopify) and the scraper returns every active ad that brand is running across Facebook and Instagram, including ad copy, creatives, CTAs and the number of variants they are A/B testing.

Can I search Facebook ads by keyword instead of brand? Yes. Use a keyword like skincare, black friday or crypto in searchQuery to discover every advertiser running ads on that topic in your chosen country. This is ideal for ad spying across a whole niche rather than a single competitor.

Does the Facebook ad scraper return video and image creatives? Yes. Each ad record includes imageUrls, videoUrls, videoPreviewUrls and full carousel cards, so you can download the actual ad creatives and build a swipe file.

Can I see Facebook ad spend and impressions? Spend ranges and impressions are returned for political_and_issue ads, because Meta publishes those numbers publicly. Commercial ads do not include spend or impression data because Meta does not make it public.

Which countries does the Facebook Ad Library scraper support? Any country supported by the Ad Library. Set the two-letter country code (US, GB, CA, AU, DE, BR and more) to see the ads delivered in that market.

How much does it cost to scrape Facebook ads? Pricing is pay-per-event: $0.005 per run start plus $0.01 per ad returned. A typical 50-ad run costs about $0.51, and you only pay for ads actually delivered.