Plain search terms, e.g. "online mba course". The full Meta Ad Library URL is generated automatically from these plus the country / sorting / media type fields below. Use this instead of Start URLs when your backend only has a keyword.

Type:array

Default:

[]

Search keyword (single)

keyword

Optional

Convenience alias for a single keyword. Merged with Search keywords.

Type:string

Default:

Country

country

Optional

Two-letter country code used when building the Ad Library URL from keywords.

Type:string

Default:IN

Search type

searchType

Optional

How the keyword is matched. Exact phrase automatically wraps the keyword in quotes.

Type:string

Default:keyword_unordered

Options:

keyword_unorderedkeyword_exact_phrase

Ad type

adType

Optional

Maps to ad_type in the Ad Library URL. Leave as All ads for normal commercial ads.

Type:string

Default:all

Options:

allpolitical_and_issue_adshousing_adsemployment_adscredit_ads

Media type

mediaType

Optional

Maps to media_type in the Ad Library URL, e.g. Video to only collect video creatives.

Type:string

Default:all

Options:

allimagememeimage_and_memevideonone

Only ads targeted at this country

isTargetedCountry

Optional

Maps to is_targeted_country in the Ad Library URL.

Type:boolean

Default:false

Sort direction

sortDirection

Optional

Maps to sort_data[direction] in the Ad Library URL.

Type:string

Default:desc

Options:

descasc

🔗 Meta Ad Library URL or Facebook Page URL

startUrls

Optional

Add a Facebook Page URL, a brand URL from Meta Ad Library, or a Meta Ad Library search URL. You can add multiple URLs using the Bulk edit option.

Type:array

💯 Results limit per URL

resultsLimit

Optional

Maximum ads to scrape per input URL. Leave empty to scrape as many as possible.

Type:integer

Minimum:1

Default:10

🖱️ Active status (if not specified within the Meta Ad Library URL)

activeStatus

Optional

Filter ads by whether they are currently running.

Type:string

Default:

Options:

activeinactive

🗂️ Sorting (if not set in the Meta Ad Library URL)

sorting

Optional

Sort order for scraped ads.

Type:string

Default:

Options:

total_impressionsrelevancy_monthly_grouped

Include extra ad details (reach & spend data, basic Instagram data)

isDetailsPerAd

Optional

Adds an ad_details object with advertiser page info.

Type:boolean

Default:false

Include page About details

includeAboutPage

Optional

Extracts About tab details (business address, admin locations, page history).

Type:boolean

Default:false

Get only the total ad count per page

onlyTotal

Optional

Returns only the total number of ads per page instead of scraping individual ads.

Type:boolean

Default:false

Scrape ads newer than

onlyAdsNewerThan

Optional

Only scrape ads with a start date newer than this date (e.g. 2025-01-01).

Type:string

Scrape ads older than

onlyAdsOlderThan

Optional

Only scrape ads with a start date older than this date (e.g. 2025-01-01).

Type:string

Proxy configuration

proxyConfiguration

Optional

Residential proxies are strongly recommended; Facebook blocks datacenter IPs.

Type:object

Default:

{
  "useApifyProxy": true,
  "apifyProxyGroups": [
    "RESIDENTIAL"
  ]
}

Facebook Ads Library Scraper

chenglianglin/fb-ad-library-actor

Scrape ads from Meta's public Facebook Ads Library by keyword or Page ID.

Chengliang Lin

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

39K

4.8

Facebook Ad Library Pro Scraper

scrapeai/facebook-ad-library-pro-scraper

Scrape ads from Facebook Ads Library search results and Facebook pages with dataset extraction.

ScrapeAI

Facebook Ad Library Pro Scraper

jobscrawler/facebook-ad-library-pro-scraper

Scrape ads from Facebook Ads Library search results and Facebook pages with dataset extraction.

Jobs Scraper

Facebook Ad Library Scraper

rastriq/fb-adlibrary-scraper

Scrapes ads from Facebook Ad Library. Select the brand and extract the historical ads.

Rastriq — Structured data from the world

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.