Social Media · Facebook Scraper

Facebook Company Ads Scraper API

Pull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run. No headless browsers, no captchas, proxies included.

$1.49per 1k callsJSONevery response1required parameter

Start scraping Facebook API reference

// Facebook · Company Ads

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

"https://hproxy.com/api/v1/scrape/facebook/ad-company?pageId=1234567890"

// → { "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 Company Ads endpoint is one API call: send either a page ID or a companyName with your HProxy key and get back a clean, structured JSON object. Pull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run. 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. Longer result sets come back page by page with a cursor, so you can walk the whole set without holding it in memory.

What the Facebook Company Ads 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 company ads endpoint

Full Facebook reference

GET/api/v1/scrape/facebook/ad-company

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

Otherwise the call returns 400 pageId or companyName required.

Parameters

pageIdstringoptional

Identifier from a previous response.

companyNamestringoptional

The companyName parameter.

countrystringoptional

Two-letter region/country code, e.g. US.

statusstringoptional

The status parameter. Allowed values: `ALL`, `ACTIVE`, `INACTIVE`.

languagestringoptional

Two-letter language code, e.g. en.

cursorstringoptional

Pagination token from the previous response.

media_typestringoptional

The media type parameter. Allowed values: `ALL`, `IMAGE`, `VIDEO`, `MEME`, `IMAGE_AND_MEME`, `NONE`.

sort_bystringoptional

Ordering to apply to the results. Allowed values: `total_impressions`, `relevancy_monthly_grouped`.

start_datestringoptional

Filter by date, as YYYY-MM-DD.

end_datestringoptional

Filter by date, as YYYY-MM-DD.

trimbooleanoptional

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

Example request

cURL

curl "https://hproxy.com/api/v1/scrape/facebook/ad-company?pageId=1234567890" \
  -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 company ads in three steps

Create a free account

Grab your API key

One key from the dashboard authenticates every scraper, Facebook company ads included.

Call the endpoint

Send the target to the Facebook Company Ads 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 Company Ads pricing

$1.49

per 1,000 calls · 0.15¢ each

Pay per call, no subscription

Errors and timeouts are not charged

Proxies included in the price

Get started free

Facebook Company Ads scraper FAQ

How do I scrape Facebook company ads?

Send one authenticated HTTPS request to the Facebook Company Ads endpoint with either a page ID or a companyName and your HProxy API key. Pull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

What does the Facebook company ads scraper return?

A structured JSON object with the full company ads 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 company ads?

This endpoint is 0.15¢ per successful call, which is $1.49 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.

Can I pull more than one page of Facebook company ads?

Yes. The response carries a cursor; pass it back on the next call to continue from where you stopped. Each page is one billable call, so you only pay for the depth you actually pull.

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 company ads 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 Detail Facebook Ad Library Search 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