Meta Ads Library Scraper - Creative Intelligence

Collect public Meta ad intelligence from Ads Library URLs, keywords, Facebook Page IDs, and specific Ad Library IDs. The actor is built for competitor tracking, agency prospecting, creative research, and scheduled ad discovery with clean delivered-row output.

Built For

• Finding active ads by brand, niche, keyword, or advertiser page.
• Studying hooks, CTAs, creative-format signals, offers, platforms, and campaign timing.
• Building lead lists from advertisers already spending on Meta.
• Running scheduled checks for new or changed public ads.

Input Modes

• targetUrl: use the exact Meta Ads Library URL from your browser.
• searchQuery and searchQueries: search one or many brands, products, offers, or competitor terms.
• pageId: collect ads for one advertiser page.
• adId: inspect a single Ad Library ID.
• adLibraryUrls: process multiple copied Ads Library URLs in the same run.

Filters

• Country.
• Active, inactive, or all ads.
• Ad category: all, political/issue, housing, employment, or credit.
• Media type: all, image, video, or meme.
• Targeted-country mode.
• Content language filters.
• Sort mode and direction where Meta exposes those controls.

Data Delivered

• Ad Library ID, advertiser/page name, activity state, started-running date, CTA, creative format, and platform signals.
• Parsed visible ad text and optional raw text.
• Direct ad URL and original source URL for review.
• dataQualityScore, signalSummary, and timestamp.
• New-ad and updated-ad rows when change detection is enabled.

Proxy And Speed Controls

Use direct mode for cheap checks. Proxy quality is often the difference between a thin sample and a useful ad dataset. Use proxyUrl with a reliable residential or managed proxy for serious collection. In the input form, this is the Your proxy URL - recommended for highest fill rate field. If no custom proxy is supplied, Apify proxy modes can route direct, auto fallback, datacenter, or residential sessions.

Keep maxConcurrency at 1 for highest stability on large Meta searches. Increase it only when processing multiple keywords or URLs with enough memory. requestHandlerTimeoutSecs and maxRunMinutes protect the run from hanging pages.

Example Input

{
  "targetUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=shopify&search_type=keyword_unordered",
  "maxResults": 100,
  "maxConcurrency": 1,
  "requestHandlerTimeoutSecs": 900,
  "proxyMode": "auto",
  "monitorChanges": false
}

Example Output

{
  "resultType": "meta_ad",
  "libraryId": "123456789012345",
  "pageName": "Example Advertiser",
  "adStatus": "active",
  "platforms": ["Facebook", "Instagram"],
  "cta": "Learn more",
  "creativeFormat": "video",
  "adText": "Visible public ad copy",
  "adUrl": "https://www.facebook.com/ads/library/?id=123456789012345",
  "sourceUrl": "https://www.facebook.com/ads/library/",
  "dataQualityScore": 92,
  "scrapedAt": "2026-06-24T12:00:00.000Z"
}

Pricing

$10.00 / 1,000 delivered ads

Only valid ad rows written to the default dataset count as delivered ads. Empty searches, blocked pages, login/captcha pages, timeouts, and no-data cases are saved as notices outside the customer dataset.

Reliability

• Direct URL validation.
• Per-source and whole-run timeout guards.
• Browser cleanup after failures.
• Duplicate ad IDs removed before output.
• No paid error rows.
• Change snapshots stored outside the paid dataset.