Skip to main content
Scrape an advertiser's Meta (Facebook) ads

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

advertiser
string
required

Advertiser to pull ads for: a Facebook Page name (keyword search) or a numeric Page ID (that advertiser's whole set).

country
string
default:US

Ad Library country (ISO-2, e.g. 'US', 'GB', 'DE'). Meta scopes the library by country.

active_status
string
default:active

Which ads to return: 'active', 'inactive', or 'all'.

media_type
string
default:all

Creative type filter: 'all', 'image', 'video', or 'meme'.

max_ads
integer
default:50

Upper bound on ads returned (the scraper paginates until it reaches this or runs out).

Required range: 1 <= x <= 500

Response

JSON with a results array of ads (may be empty if the advertiser has no ads for the given filters).