Paste Facebook Ad Library URLs to scrape directly. The actor will parse each URL and run the search automatically. If provided, URLs are processed first, followed by any Search Keywords and Advertisers below.

💡 How it works:

Copy a URL from Facebook Ad Library and paste it here
All filters from the URL (country, language, date range, media type, etc.) are extracted automatically
Max Results Per Search controls how many ads are collected per URL
You can mix URLs with manual search fields — all run sequentially

📌 Single ad links supported:

URLs like ?id=xxxxxxxxxxxx will fetch that specific ad directly
Works with the enrichment toggle to get full ad details

Type:array

🔍 Search Keywords

searchQueries

Optional

Search terms to find Facebook ads 🎯

Enter keywords, phrases, or brand names to search for in Facebook's Ad Library:

Examples:

Brand names: "Nike", "Apple", "Coca-Cola"
Product categories: "fitness app", "crypto wallet", "online course"
Industry terms: "digital marketing", "e-commerce", "SaaS"
Campaign themes: "Black Friday", "back to school", "summer sale"

💡 Tips:

Use specific terms for better results
Mix broad and specific keywords
Each query runs separately and results are combined
Empty queries will be skipped

Type:array

🏢 Search Advertisers

searchAdvertisers

Optional

Search by specific advertiser/page names or Page IDs 🎯

Enter advertiser names or Facebook Page IDs to fetch ads from specific pages:

Examples:

Advertiser names: "Nike", "Nike Football", "Apple"
Page IDs: "15087023444", "51212153078"
Mixed: ["Nike", "15087023444"]

💡 How it works:

Name match: If you enter "Nike Football", the scraper will find ALL Facebook pages with exactly that name and fetch ads from each
Page ID: If you enter a numeric ID like "15087023444", it goes directly to that page
Multiple matches: Some names like "Nike Football" may match multiple pages - ads will be fetched from ALL matching pages

⚠️ Important:

Each advertiser query uses your maxResultsPerQuery limit per matching page
Example: "Nike Football" matches 3 pages + maxResults=100 = 300 ads total
Names must match exactly (case-insensitive)

🔍 Tips:

Use specific names for better matching
Check Facebook Ad Library to verify exact page names
Use Page IDs for precise targeting
Leave empty to skip advertiser search

Type:array

📊 Max Results Per Search

maxResultsPerQuery

Optional

Maximum ads to collect per search 📈

This limit applies to every search source in your run:

📌 Per URL — each Ad Library URL collects up to this many ads
🔍 Per keyword — each search query collects up to this many ads
🏢 Per advertiser page — each resolved advertiser page collects up to this many ads

Example: 2 URLs + 3 keywords + 2 advertisers with maxResultsPerQuery = 50 → Up to 50 ads × 7 sources = up to 350 ads total

Default: 10 — Good for quick tests
50–200 — Recommended for most use cases
💡 Note: Actual results may be lower if Facebook has fewer matching ads

Type:integer

Minimum:10

Default:10

🔍 Enrich with Ad Details

enrichWithAdDetails

Optional

Fetch full ad details for each result 📊

When enabled, the scraper makes an additional request per ad to fetch rich advertiser and targeting data:

Extra data included:

🏢 Advertiser info: page about text, category, likes, profile photo, cover photo, verification status
📷 Instagram: username, followers, verification
🎯 Targeting (EU): location audience, age/gender breakdown, total reach
💰 Payer/Beneficiary: who paid for and benefits from the ad
⚠️ Violations: any policy violation types

⚠️ Note: Enabling this will slow down scraping since each ad requires an extra API call. Recommended for smaller result sets (< 200 ads).

Type:boolean

Default:false

📊 Sort Results By

sortBy

Optional

Order search results 📈

Impressions (High to Low): Most viewed ads first (recommended)
Most Recent: Newest ads first

💡 Tip: Sort by impressions to see the most successful/popular ads

Type:string

Default:SORT_BY_TOTAL_IMPRESSIONS

Options:

SORT_BY_TOTAL_IMPRESSIONSSORT_BY_RELEVANCY_MONTHLY_GROUPED

🌍 Target Countries

countries

Optional

Filter ads by country targeting 🗺️

Popular Options:

US - United States (largest ad market)
CA - Canada
GB - United Kingdom
AU - Australia
DE - Germany
FR - France
ES - Spain
IT - Italy
BR - Brazil
IN - India
JP - Japan

💡 Use ISO 2-letter country codes (e.g., US, CA, GB)

Type:string

Options:

ALLAXALDZASADAOAIAQAGARAMAWAUATAZBHBDBBBYBEBZBJBMBTBOBQBABWBVBRIOVGBNBGBFBIKHCMCACVKYCFTDCLCNCXCCCOKMCKCRCIHRCUCWCYCZCDDKDJDMDOECEGSVGQEREEETFKFOFJFIFRGFPFTFGAGMGEDEGHGIGRGLGDGPGUGTGGGNGWGYHTHMVAHNHKHUISINIDIRIQIEIMILITJMJPJEJOKZKEKIKPKRKWKGLALVLBLSLRLYLILTLUMOMKMGMWMYMVMLMTMHMQMRMUYTMXFMMDMCMNMEMSMAMZMMNANRNPNLNCNZNINENGNUNFMPNOOMPKPWPSPAPGPYPEPHPNPLPTPRQARERORURWBLSHKNLCMFPMVCWSSMSTSASNRSSCSLSGSXSKSISBSOZAGSSSESLKSDSRSJSZSECHSYTWTJTZTHTLTGTKTOTTTNTRTMTCTVUGUAAEGBUSUMUYUZVUVEVNVIWFEHYEZMZWAF

🗣️ Content Languages

contentLanguages

Optional

Filter ads by content language 🔤

Common Languages:

en - English
es - Spanish
fr - French
de - German
it - Italian
pt - Portuguese
ja - Japanese
ko - Korean
zh - Chinese
ar - Arabic

💡 Use ISO 2-letter language codes

Type:string[]

📱 Publisher Platforms

publisherPlatforms

Optional

Select which platforms to search for ads 🎯

Available Platforms:

Facebook - Main Facebook feed ads
Instagram - Instagram feed and story ads
Audience Network - Third-party apps and websites
Messenger - Facebook Messenger ads
WhatsApp - WhatsApp Business ads
Threads - Threads social platform ads

💡 Tips:

Leave empty to search all platforms
Select multiple platforms for broader coverage
Instagram and Facebook are the most common

Type:string[]

📊 Ad Status Filter

activeStatus

Optional

Filter by ad activity status 🔄

All: Both active and inactive ads (recommended)
Active: Only currently running ads
Inactive: Only stopped/ended ads

💡 'All' gives the most comprehensive data

Type:string

Default:ALL

Options:

ALLACTIVEINACTIVE

📂 Ad Category Filter

adType

Optional

Filter by Facebook ad category 🎯

All ads: Every type of advertisement (recommended)
Politics: Political and issue-based ads
Housing: Real estate and housing ads
Employment: Job and employment ads
Financial: Credit and financial service ads

💡 Different categories may have different data availability

Type:string

Default:ALL

Options:

ALLPOLITICAL_AND_ISSUE_ADSHOUSING_ADSEMPLOYMENT_ADSCREDIT_ADS

🎨 Media Type Filter

mediaType

Optional

Filter by ad media content 📱

All: Every ad type (recommended)
Video: Only video ads
Image: Only image ads
Meme: Images with text, e.g., 'marketing'
Image & Meme: Both image types
None: Text-only ads (no image or video)

💡 Video ads often have higher engagement data

Type:string

Default:ALL

Options:

ALLIMAGEMEMEIMAGE_AND_MEMEVIDEONONE

📅 From Date

startDate

Optional

Earliest date to search for ads 📆

Select the earliest publication date for ads in your search results.

Type:string

📅 To Date

endDate

Optional

Latest date to search for ads 📆

Select the latest publication date. Leave empty to include all ads up to today.

Type:string

Facebook Ad Library Scraper

curious_coder/facebook-ads-library-scraper

Scrape facebook ads from ad library search results and ads run by facebook pages - Fast and lightweight. $0.75 per 1000 results

Curious Coder

21K

4.8

Facebook Ads Library Scraper API

api_creators/facebook-ads-library-scraper-api

Scrape Facebook Ad Library: Extract ad data, copy & creatives from FB & Instagram. Powerful Facebook Ads Scraper for competitor research & ad intelligence. Search by keyword or Page ID. Export JSON, CSV, or Excel. Fast, reliable, and cheap Facebook Ad Library API.

API Creators

5.0

Facebook Ads Library Scraper

easyapi/facebook-ads-library-scraper

Extract detailed information about active Facebook ads including content, images, targeting data and more. Perfect for market research, competitor analysis and ad intelligence. Supports all countries and ad categories with anti-detection measures.

EasyApi

1.4K

2.2

Facebook Ad Library Scraper

agenscrape/facebook-ad-library-scraper

Extract ads from Facebook Ad Library instantly. Get complete ad details, images, videos, page info, impressions, and targeting data. Just paste the Ad Library URL and run. Fast, reliable extraction for competitor research and market analysis.

Agenscrape

191

Meta Ad Library Scraper Pro

webdatalabs/meta-ad-library-scraper

Extract competitor ads from Meta's Ad Library (Facebook, Instagram, Messenger, Audience Network). Get ad copy, creatives, targeting data, sentiment analysis, and track changes over time.

WebDataLabs

187

5.0

Facebook Ad Library Scraper

corner_cutter/facebook-ad-library-scraper

Comprehensive Meta ad library tool that fetches all ads for a given Facebook Ad Library URL or page URL. Extract ad creatives, copy, targeting info, and more.

ReactRuby

310

5.0

Facebook Ads Scraper

rigelbytes/facebook-ads-scraper

Facebook Ads Scraper lets you extract ads from the Facebook Ads Library using a search URL. Collect ad creatives, copy, platforms, targeting countries, spend & reach estimates, and timelines — ideal for ad research, competitor analysis, and market intelligence. Available for $20/month.

Rigel Bytes

Facebook Ad Library Scraper

apipi/facebook-ad-library-scraper

Ultra-fast Facebook Ads Library scraper with advanced filtering. Extract ads from Meta Ads Library in seconds! Perfect for competitor analysis, market research, and ad intelligence.

ApiPi

216

5.0

Facebook Ads Meta Ad library Scraper

bockmurat/facebook-ads-scraper-actor

Cheapest and fastest Facebook / Meta Ad library scraper on Apify. Scrape All ads per Ad library Url including creatives and collateral results. Scrapes Full Results for all Ads across Facebook, Instragram, Threads, Whatsapp, Messenger and Audience Network.

Murat

375

5.0

Facebook Ads Library Scraper

scraper-engine/facebook-ads-library-scraper

The Facebook Ads Library Scraper extracts ad data from Facebook’s Ad Library, including advertiser details, ad text, impressions, and targeting info. Ideal for ad research, marketing insights, and competitor analysis, it delivers clean, structured data for analysis or integration via API.