Facebook Ads Library Scraper v2 avatar

Facebook Ads Library Scraper v2

Pricing

$0.75 / 1,000 ads

Go to Apify Store
Facebook Ads Library Scraper v2

Facebook Ads Library Scraper v2

Search Meta's Ad Library by keyword, page handle, page URL, or full Ad Library URL. Pay-per-result.

Pricing

$0.75 / 1,000 ads

Rating

0.0

(0)

Developer

Arnas

Arnas

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Share

Facebook Ads Library Scraper

Search Meta's Ad Library and pull every matching ad. Pass a keyword, a Facebook page handle, a page URL, or a full Ad Library URL — they all work.

Quick start

The minimum viable input is a single field:

{
"query": ["crochet"]
}

Or mix searches in a single run:

{
"query": ["crochet", "@ZapierApp", "https://www.facebook.com/Nike"],
"country": "US",
"activeStatus": "active",
"maxAds": 500
}

Input

FieldTypeDefaultWhat it does
querystring[] (required)Keywords (crochet), page handles (@ZapierApp), page URLs, or full Ad Library URLs. Mix freely.
countrystringALLTwo-letter ISO country code (US, GB, DE, …) or ALL.
activeStatusenumactiveall · active · inactive.
adTypeenumallall · political_and_issue_ads.
mediaTypeenumallall · image · video · meme · image_and_meme · none.
periodenumallall · last24h · last7d · last14d · last30d.
sortByenumimpressions_descimpressions_desc · most_recent.
maxAdsinteger100Total cap across all searches. Empty for no cap.
maxAdsPerQueryintegerunlimitedCap per item in query.
scrapeAdDetailsbooleanfalseFetch extra ad details (e.g. EU reach). Slower and more expensive.
runTagstringStamped onto every output row's runTag field.
proxyproxyApify ProxyOverride proxy configuration.

Legacy fields (still accepted)

For drop-in compatibility with the original curious_coder/facebook-ads-library-scraper input, these older field names are also accepted:

  • urls (array of URL objects) → folded into query
  • countmaxAds
  • limitPerSourcemaxAdsPerQuery
  • scrapePageAds.countryCodecountry
  • scrapePageAds.activeStatusactiveStatus
  • scrapePageAds.periodperiod
  • scrapePageAds.sortBysortBy

Output

Each ad is pushed to the run's default dataset with the upstream Meta field names preserved (ad_archive_id, page_name, is_active, start_date_formatted, publisher_platform, snapshot, spend, reach_estimate, advertiser, insights, aaa_info, …) plus three convenience fields:

  • ad_library_url — direct link to the ad
  • position — index within the run (1-based)
  • query — which input item produced the row
  • runTag — copy of the input runTag

Pricing

Pay per event:

  • Event key: apify-default-dataset-item
  • Event title: ad
  • Event description: Single ad in the default dataset.
  • Event price: $0.00075

Displays as $0.75 / 1,000 ads.