← All scrapers

Ad Library API

Live competitor creatives, advertisers and spend ranges.

9endpoints3platforms$3.00per 1k calls

// Facebook · Ad Library Company Search

curl -H "X-API-Key: hpx_your_key_here" \

"https://hproxy.com/api/v1/scrape/facebook/ad-companies-search?query=coffee"

// → { "data": { … }, "records": 1, "costUsd": … }

PlatformPlatform

Every large ad platform is required to publish who is advertising and what they are running. Facebook, LinkedIn and Google each expose that as an ad library, and these endpoints turn all three into one JSON shape: the creatives themselves, the advertiser behind them, the spend and impression ranges where the platform discloses them, and the dates each ad started and stopped running. It is the cleanest competitive intelligence available anywhere, for the simple reason that the platforms publish it themselves.

In every response

creatives[]

Each active ad's media, copy and format.

advertiser

The page, company or advertiser account running the ad.

spend / impressions

Spend range and reach where the platform discloses them.

dates

First-seen and last-seen run dates for each creative.

platforms[]

Which surfaces the ad was served on, where the library reports it.

9 Ad Library API Endpoints,Across 3 Platforms

One REST call each, one API key for all of them, billed per call from your balance.

Facebook Ad Library Detail

Pull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran.

Facebook Ad Library Search

Search the Facebook Ad Library by keyword and get the live ads back with creatives, advertiser, spend range and run dates.

Facebook Company Ads

Pull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run.

Facebook Ad Library Company Search

Find the advertiser page behind a brand name in the Facebook Ad Library, so you can pull its live ads by ID.

LinkedIn Ad Library Search

Search the LinkedIn ad library by keyword and get live ad creatives back with the advertiser and the dates each ran.

LinkedIn Ad Detail

Pull one LinkedIn ad in full: creative, copy, format, targeting signals where disclosed and the window it has run.

Google Ad Library Company Ads

Pull every ad a company is running in the Google Ads Transparency Center, with creatives, formats and the dates each ran.

Google Ad Detail

Pull one ad from the Google Ads Transparency Center in full: creative, format, advertiser and the window it has run.

Google Advertiser Search

Find the verified advertiser behind a brand name in Google's Ads Transparency Center, so you can pull its live ads by ID.

From Request to Clean JSON

You write one line. We do everything between the request and the data.

01

You send

One API call

GET the Ad Library endpoint with your key. That's all your code does.

02

We handle

Proxies · captchas · parsing

Residential exit, anti-bot walls, JS rendering and extraction, all server-side, on us.

03

You get

Clean JSON

A structured object every time. No HTML, no scraping code, no maintenance.

Ad Library API at a glance

One key, 3 platforms

Every endpoint in this group answers to the same key, the same header and the same response shape, so covering a second platform is a URL change rather than an integration.

Endpoints
9
Platforms
3
Response
Structured JSON
Auth
One X-API-Key header
Billing
Per call, balance never expires

$3.00 /1k calls

cheapest endpoint in this group

What you never deal with

Handled on our side

  • No captchas, ever
  • Residential-backed
  • Pay per call
  • Fresh on every call
  • Failures are free
  • Scales with you

What people build with the Ad Library API

01

See every ad a competitor is running right now, with the creative and the copy.

02

Track when a rival launches or kills a campaign, by watching first-seen and last-seen dates.

03

Build a swipe file of creatives that are still live in your category.

04

Estimate a competitor's spend from the disclosed ranges rather than from guesswork.

Ad Library API pricing

$3.00

per 1,000 calls, cheapest endpoint in this group

One key covers all 3 platforms

No subscription, no monthly minimum

Failed extractions are not charged

Proxies included in the price

Ad Library API FAQ

Is this data legal to collect?
Ad libraries exist precisely so the public can inspect them. These endpoints read the same public transparency pages the platforms publish under their own advertising rules, and nothing behind a login.
How accurate are the spend numbers?
They are ranges, and they are the platform's own. We pass through exactly what the library discloses without smoothing or estimating, so a wide range in the response is a wide range in the source.
Can I search by company rather than by ad?
Yes. There are company and advertiser search endpoints for finding the right advertiser entity first, then a per-advertiser endpoint for pulling everything they are currently running.
How far back does the history go?
As far as each library retains it, which differs by platform and by ad category. Political and issue ads are typically kept far longer than commercial ones, because that is what the transparency rules require.
HProxy.

Ready when you are.Your dashboard is ten seconds away.

Get Startedor talk to us at support@hproxy.com
HProxy