Social Media · Facebook Scraper

Facebook Ad Library Detail Scraper API

Pull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran. No headless browsers, no captchas, proxies included.

$3.50per 1k callsJSONevery response1required parameter

Start scraping Facebook API reference

// Facebook · Ad Library Detail

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

"https://hproxy.com/api/v1/scrape/facebook/ad?url=https%3A%2F%2Fwww.facebook.com%2Fnasa"

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

Platform

Facebook

What you scrape

Everything17 Profiles1 Posts and media5 Transcripts1 Comments2Ads4Events4

From Request to Clean JSON

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

You send

One API call

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

We handle

Proxies · captchas · parsing

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

You get

Clean JSON

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

The Facebook Ad Library Detail endpoint is one API call: send either an ID or a URL with your HProxy key and get back a clean, structured JSON object. Pull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when Facebook changes its markup. You only ever touch the JSON.

What the Facebook Ad Library Detail API returns

creatives[]

Each active ad's media, copy and format.

advertiser

The page or advertiser running the ad.

spend / impressions

Spend range and reach where disclosed.

dates

First-seen and last-seen run dates.

Example response

200 OK · application/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" }
}

Trimmed for brevity. Every call returns the full object with all fields listed here.

The Facebook ad library detail endpoint

Full Facebook reference

GET/api/v1/scrape/facebook/ad

Send at least one of: id or url. Every parameter below is individually optional, so a call with none of these is rejected.

Otherwise the call returns 400 id or url required.

Parameters

idstringoptional

Identifier from a previous response.

urlurloptional

Target URL (profile, post or video).

get_transcriptbooleanoptional

Also include transcript in the response.

trimbooleanoptional

Return a slimmed-down payload (drops verbose fields).

cache_max_agestringoptional

Accept a cached result up to this old (1d, 3d, 7d, 14d or 30d) and pay nothing for it. Omit for a live scrape. Allowed values: `1d`, `3d`, `7d`, `14d`, `30d`.

Example request

cURL

curl "https://hproxy.com/api/v1/scrape/facebook/ad?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "X-API-Key: hpx_your_key_here"

POST with a JSON body works too. Errors, timeouts and rate limits are never billed; a target that does not exist counts as a call.

Scraping Facebook ad library detail in three steps

Create a free account

Grab your API key

One key from the dashboard authenticates every scraper, Facebook ad library detail included.

Call the endpoint

Send the target to the Facebook Ad Library Detail endpoint and read the JSON. That is the whole integration.

No captchas, ever

Anti-bot walls, JS rendering and rate limits are handled server-side. You call an API, that is the whole job.

Residential-backed

Every request exits through HProxy's own residential network, so it looks like a real user on a real device.

Pay per call

No subscription, no seat licenses. Calls are billed from your balance and the balance never expires.

Fresh on every call

Responses are scraped live at request time, no stale cache dressed up as data.

Errors are free

Blocked, errored or timed-out calls are not charged. A target that does not exist counts as a call, because the platform still had to be asked.

Scales with you

From one call to millions: same endpoint, same price curve, volume discounts as you grow.

What people build with it

Spy on competitor ad creatives and messaging.

Track ad spend and campaign timing in your niche.

Build a swipe file of what is running right now.

Facebook Ad Library Detail pricing

$3.50

per 1,000 calls · 0.35¢ each

Pay per call, no subscription

Errors and timeouts are not charged

Proxies included in the price

This endpoint is priced above Facebook's $3.00/1k entry rate

Get started free

Facebook Ad Library Detail scraper FAQ

How do I scrape Facebook ad library detail?

Send one authenticated HTTPS request to the Facebook Ad Library Detail endpoint with either an ID or a URL and your HProxy API key. Pull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

What does the Facebook ad library detail scraper return?

A structured JSON object with the full ad library detail data Facebook exposes publicly. See the fields listed above. The schema is consistent across calls, so you integrate once and rely on it.

How much does it cost to scrape Facebook ad library detail?

This endpoint is 0.35¢ per successful call, which is $3.50 per 1,000. It bills from your HProxy balance with no subscription and no monthly minimum. Errors are retried and never charged; a lookup whose target does not exist counts as a call.

Do I need my own proxies to scrape Facebook?

No. Every call runs on HProxy's own residential network behind the scenes, so requests look like real users. The proxy layer is already included in the per-call price.

Is scraping Facebook ad library detail allowed?

The API only accesses publicly available Facebook data, the same pages anyone can open in a browser. You are responsible for using the data in line with applicable laws and Facebook's terms for your use case.

The same data on other platforms

All Ad Library API endpoints

LinkedIn Ad Library Search

LinkedIn Ad Detail

Google Ad Library Company Ads

Google Ad Detail

More Facebook scrapers

All Facebook endpoints

Facebook Ad Library Search Facebook Company Ads Facebook Ad Library Company Search Facebook Profile Facebook Profile Reels Facebook Profile Photos Facebook Profile Posts Facebook Profile Events

HProxy.

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

Get Started Talk to us

Or talk to us at support@hproxy.com

HProxy