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.
// 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": … }
TikTok
YouTube
Instagram
LinkedIn
Twitter / X
Reddit
Threads
Google
Pinterest
Twitch
Bluesky
Truth Social
Spotify
Snapchat
SoundCloud
Kick
Linktree
Komi
Pillar
Linkbio
Linkme
AmazonFrom 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
{
"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 →/api/v1/scrape/facebook/ad-companySend 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
pageIdstringoptionalIdentifier from a previous response.
companyNamestringoptionalThe companyName parameter.
countrystringoptionalTwo-letter region/country code, e.g. US.
statusstringoptionalThe status parameter. Allowed values: `ALL`, `ACTIVE`, `INACTIVE`.
languagestringoptionalTwo-letter language code, e.g. en.
cursorstringoptionalPagination token from the previous response.
media_typestringoptionalThe media type parameter. Allowed values: `ALL`, `IMAGE`, `VIDEO`, `MEME`, `IMAGE_AND_MEME`, `NONE`.
sort_bystringoptionalOrdering to apply to the results. Allowed values: `total_impressions`, `relevancy_monthly_grouped`.
start_datestringoptionalFilter by date, as YYYY-MM-DD.
end_datestringoptionalFilter by date, as YYYY-MM-DD.
trimbooleanoptionalReturn a slimmed-down payload (drops verbose fields).
Example request
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. Failed calls, timeouts and rate-limited calls are never billed.
Scraping Facebook company ads in three steps
Create a free account
Sign up and top up any amount. The balance pays for every HProxy product and never expires.
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.
Failures are free
Automatic retries first; if an extraction still fails, the call is not charged.
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
$3.50
per 1,000 calls · 0.3¢ each
Pay per call, no subscription
Failed extractions are not charged
Proxies included in the price
This endpoint is priced above Facebook's $3.00/1k entry rate