Web scrapers

Ad Library API

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.

Get your API key Every scraper

9 endpoints
3 platforms
from $1.49 per 1,000 calls
One key, one JSON shape

Ad Library API

9 endpoints across 3 platforms.

Live competitor creatives, advertisers and spend ranges.

Facebook Ad Library DetailPull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran.$1.49 per 1,000 Facebook Ad Library SearchSearch the Facebook Ad Library by keyword and get the live ads back with creatives, advertiser, spend range and run dates.$1.49 per 1,000 Facebook Company AdsPull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run.$1.49 per 1,000 Facebook Ad Library Company SearchFind the advertiser page behind a brand name in the Facebook Ad Library, so you can pull its live ads by ID.$1.49 per 1,000 LinkedIn Ad Library SearchSearch the LinkedIn ad library by keyword and get live ad creatives back with the advertiser and the dates each ran.$1.49 per 1,000 LinkedIn Ad DetailPull one LinkedIn ad in full: creative, copy, format, targeting signals where disclosed and the window it has run.$1.49 per 1,000 Google Ad Library Company AdsPull every ad a company is running in the Google Ads Transparency Center, with creatives, formats and the dates each ran.$37.25 per 1,000 Google Ad DetailPull one ad from the Google Ads Transparency Center in full: creative, format, advertiser and the window it has run.$1.49 per 1,000 Google Advertiser SearchFind the verified advertiser behind a brand name in Google's Ads Transparency Center, so you can pull its live ads by ID.$1.49 per 1,000

In every response

The same JSON, whichever platform you ask.

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.

curl "https://hproxy.com/api/v1/scrape/facebook/ad-search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"

Response · Facebook Ad Library Search200 OK · JSON

{
  "advertiser": { "name": "Brand Inc", "pageId": "104..." },
  "creatives": [
    { "format": "video", "body": "Shop the new drop", "media": "https://.../ad.mp4" }
  ],
  "spend": { "min": 5000, "max": 10000, "currency": "USD" },
  "dates": { "firstSeen": "2026-06-30", "lastSeen": "2026-07-17" }
}

What people build with it

Where ad library api earns its keep.

See every ad a competitor is running right now, with the creative and the copy.
Track when a rival launches or kills a campaign, by watching first-seen and last-seen dates.
Build a swipe file of creatives that are still live in your category.
Estimate a competitor's spend from the disclosed ranges rather than from guesswork.

Ad Library API questions

Answered before you ask.

The scraper docs

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.

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.

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.

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.

Docs and AI

Connect your scraper to an AI, any time.

The whole Scraper API is published as markdown, so an assistant reads every endpoint, every parameter and a real response without a key and writes your integration. And because a scrape is one GET that answers in JSON, an agent can run the scraper itself, on its own schedule, with your key.

Read the scraper docs Set up your assistant

Claude, ChatGPT, Cursor, Gemini, Copilot, Windsurf, Perplexity, Ollama and any assistant that speaks MCP.

The API as markdown

Paste /llms/scraper-api.txt into Claude, ChatGPT, Cursor or Copilot: every endpoint and the whole catalog, in one file. No key and no account to read it.

Open the markdown

An agent can call it

One GET with your key returns structured JSON, so an agent scrapes on its own schedule. No browser to drive, no parser to keep alive between runs.

See the endpoints

MCP server and CLI

Built by us for the free tools and hosted at mcp.hproxy.com: the proxy list, the checker and the IP lookup as tools in Claude, ChatGPT, Cursor or any assistant that speaks MCP. Nothing to install, no key.

Add it to your assistant

API docs

Every scraper endpoint documented end to end, with the parameters it takes and the response it really returns.

Read the docs

Other kinds of data

The catalog, by what you need rather than by platform.

Every platform

The same key works on all 23.

The whole catalog

More on ad library api

What ads covers

9 endpoints across 3 platforms: Facebook Ad Library Detail, Facebook Ad Library Search, Facebook Company Ads, Facebook Ad Library Company Search, LinkedIn Ad Library Search, LinkedIn Ad Detail, Google Ad Library Company Ads, Google Ad Detail and Google Advertiser Search. They are separate scrapers behind one API key, and they answer in the same JSON shape, so the code that reads one reads all of them.

Why the shape matters

Live competitor creatives, advertisers and spend ranges. Working platform by platform means a second integration for every network you add. Here the field names, the pagination and the error codes are the same wherever the data came from, so adding another platform is a change of URL rather than a rewrite.

What it costs

Calls in this group start at $1.49 per 1,000 and are billed from one balance, per call, with no subscription. Blocked, errored and timed-out calls are not charged, and each endpoint prices itself: a heavier lookup costs more than a simple one, and the page for each endpoint prints its own rate.

Ready when you are.

Your dashboard is ten seconds away. No sales call, no subscription, no minimum.

Get started See every scraper Talk to us