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

⚠️ Note: Enabling this will slow down scraping since each ad requires an extra API call.

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 Ads Library Scraper

apify/facebook-ads-scraper

Extract advertising data from Facebook, Instagram, WhatsApp, Threads. Get ads, publishers, prices, reach estimates, impressions, links, images, IDs, timestamps, product info, and more from Facebook Ad Library. Export ad data, schedule runs via API, and integrate with other tools or AI workflows.

Apify

45K

4.0

(59)

Facebook Ad Library Scraper

curious_coder/facebook-ads-library-scraper

Scrape ads from facebook ads library search results and facebook pages. Cost: $0.75 per 1K ads

Curious Coder

46K

4.8

(113)

Meta (Facebook) Ad Library Scraper - Fast & Reliable

whoareyouanas/meta-ad-scraper

Scrape Meta ads in seconds - no fluff, just instant access to the ad data and insights you need. Get detailed ad information including title, description, images, videos, CTA, Social platform and metadata

Anas Nadeem

3.7K

5.0

(14)

Facebook (Meta) Ads Library Scraper

igolaizola/facebook-ad-library-scraper

Extract powerful ad insights from Meta's Facebook Ads Library. Scrape comprehensive data including IDs, ad text, images, links, and page details to fuel digital marketing strategies and competitive research. Optimize and boost campaigns with current, actionable ad data for maximum impact.

Iñigo Garcia Olaizola

4.1K

3.9

(11)

Facebook Ads Library Scraper

automation-lab/facebook-ads-library

Scrape Facebook / Meta Ad Library for competitor ad monitoring. Search by keyword, Page URL, pasted Ads Library URL, country, status, and media type. Extract creatives, copy, links, media, platforms, spend. No login or Meta API token required.

Automation Lab

3.5K

4.5

(3)

Facebook Ads Library Scraper [Reach Included] (Richest output)

memo23/facebook-ads-library-scraper-cheerio

Facebook Ads Library Scraper — search the Meta Ad Library by keyword or page URL and export every ad: creatives, copy, spend & impressions, EU reach & transparency, advertiser pages, run dates. Richest schema on the Store. Filter by country, status & media type. Free trial.

Muhamed Didovic

980

4.8

(9)

LinkedIn Ad Library Scraper

ivanvs/linkedin-ad-library-scraper

Extract details about ads from LinkedIn Ad Library. Scrape ad details like when it was run, ad targeting, advertiser and content of ad. Download ad data in JSON, XML, Excel format.

Gen First

489

3.6

(3)

Youtube Transcript

dz_omar/youtube-transcript-metadata-extractor

🎥Extract complete transcripts with precise timestamps ⏱️ and comprehensive video metadata from any YouTube video —> ⚡Fast, reliable, and ready to use.

FlowExtract API

5.0

(15)

Facebook Ads Library Scraper — Meta & Instagram Ads

brilliant_gum/facebook-ads-library-scraper

Extract ads from the Meta Ads Library (Facebook & Instagram). Get ad copy, running days, EU spend data, carousel cards, and landing page URLs. The only scraper that tracks how long each ad has been running — your key signal for finding competitor winning ads.

Yuliia Kulakova

1.8K

5.0

(1)

LinkedIn Ads Scraper

dz_omar/linkedin-ads-scraper

🔍 Extract comprehensive LinkedIn ads data from the Ad Library. Get ad creatives, headlines, copy, advertiser info, and targeting details. Perfect for competitive intelligence, 📈 market research, and ad campaign analysis. Supports keyword search, date filtering, and multi-country targeting.

FlowExtract API

177

5.0

(4)