Facebook Ads Library Scraper v2
Pricing
$0.75 / 1,000 ads
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
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
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
| Field | Type | Default | What it does |
|---|---|---|---|
query | string[] (required) | — | Keywords (crochet), page handles (@ZapierApp), page URLs, or full Ad Library URLs. Mix freely. |
country | string | ALL | Two-letter ISO country code (US, GB, DE, …) or ALL. |
activeStatus | enum | active | all · active · inactive. |
adType | enum | all | all · political_and_issue_ads. |
mediaType | enum | all | all · image · video · meme · image_and_meme · none. |
period | enum | all | all · last24h · last7d · last14d · last30d. |
sortBy | enum | impressions_desc | impressions_desc · most_recent. |
maxAds | integer | 100 | Total cap across all searches. Empty for no cap. |
maxAdsPerQuery | integer | unlimited | Cap per item in query. |
scrapeAdDetails | boolean | false | Fetch extra ad details (e.g. EU reach). Slower and more expensive. |
runTag | string | — | Stamped onto every output row's runTag field. |
proxy | proxy | Apify Proxy | Override 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 intoquerycount→maxAdslimitPerSource→maxAdsPerQueryscrapePageAds.countryCode→countryscrapePageAds.activeStatus→activeStatusscrapePageAds.period→periodscrapePageAds.sortBy→sortBy
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 adposition— index within the run (1-based)query— which input item produced the rowrunTag— copy of the inputrunTag
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.