🎯 Meta Ad Library Winning Creatives & Advertisers Scraper

Scrape active ads, winning creatives, running days, primary ad copy, CTA buttons, and landing page URLs from Meta Ad Library across Facebook, Instagram, Messenger, and Audience Network.

---

⚡ What Does Meta Ad Library Scraper Do?

This Actor extracts live competitor ad intelligence from Meta:

• Winning Ad Discovery: Find ads running for 30+, 60+, or 90+ consecutive days (the ultimate proof of a profitable, winning creative).
• Creative Analytics: Extract primary text copy, headlines, CTA button types (SHOP_NOW, LEARN_MORE, SIGN_UP), and media format (Video vs Image).
• Funnel & Landing Page Intelligence: Extract destination URLs and clean landing page domains to spy on competitor sales funnels.
• Global & Regional Targeting: Filter by country (IN, US, GB, CA, AU, or worldwide) and brand keywords.
• Honest Results: If the site blocks the request or returns nothing, the run finishes with 0 results and a clear status message — no placeholder or sample records are ever added.

---

💼 Ideal Use Cases

• D2C Founders & Media Buyers: Uncover winning video angles, hooks, and copy formulas from top brands in your niche.
• Performance Marketing Agencies: Audit prospective clients' ad libraries before pitch meetings and generate creative gap reports.
• Affiliate & Dropshipping Marketers: Identify high-converting offers with validated long-running ads.

---

📥 Input Parameters

Parameter	Type	Default	Description
searchQuery	String	"Shopify"	Brand name or competitor to spy on
country	String	"IN"	2-letter ISO country code (e.g. IN, US, GB)
activeStatus	String	"ACTIVE"	ACTIVE ads only or ALL
mediaType	String	"ALL"	ALL, VIDEO, or IMAGE
maxItems	Integer	5	Maximum number of ad creatives to extract
proxyConfiguration	Object	{ "useApifyProxy": true }	Apify proxy configuration

---

📤 Sample Output JSON

{
  "adArchiveId": "1489201938472911",
  "pageName": "Shopify",
  "pageId": "17246534281",
  "searchQuery": "Shopify",
  "country": "IN",
  "isActive": true,
  "startDate": "2026-08-15",
  "runningDays": 71,
  "platforms": ["facebook", "instagram", "audience_network", "messenger"],
  "adCreativeBody": "Turn your ideas into a business. Build your online store with Shopify for ₹20/month for your first 3 months. Everything you need to sell online.",
  "ctaText": "Start Free Trial",
  "ctaType": "SIGN_UP",
  "landingPageUrl": "https://www.shopify.com/in/free-trial",
  "landingDomain": "shopify.com",
  "mediaType": "VIDEO",
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=1489201938472911",
  "scrapedAt": "2026-10-25T07:34:00.000Z"
}