Social Media · Web scrapers
Facebook Scraper API
- 17 endpoints
- $1.49 per 1,000 calls
- Structured JSON every response
- Errors and timeouts are not charged
For developers
One GET, and Facebook comes back as JSON.
This is the Facebook profile endpoint, $1.49 per 1,000 calls. Your key goes in one header; the answer is the object below it.
- Proxies, sessions and captchas handled on our side
- Failed calls are retried and not charged
- The same JSON shape on every call
curl "https://hproxy.com/api/v1/scrape/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
-H "X-API-Key: hpx_your_key_here"{
"id": "1092...",
"username": "@handle",
"displayName": "Real Name",
"bio": "Founder. Building things.",
"isVerified": true,
"counts": { "followers": 90421, "following": 312, "posts": 1840 },
"links": ["https://example.com"],
"avatar": "https://.../avatar.jpg"
}Endpoint catalog
17 Facebook scrapers, ready to call.
One REST call each, billed per call from 0.15¢, with structured JSON back every time.
What you scrape
Pull a public Facebook page or profile from its URL: name, category, follower counts, contact details and business hours.
Pull every reel a Facebook page has posted, page by page, with caption, view and reaction counts and a direct media URL.
Pull every photo a Facebook page has posted, page by page, with captions, alt text, full-resolution URLs and engagement.
Pull everything a Facebook page publishes, page by page, with text, media, reactions, comment and share counts and timestamps.
Pull the events a Facebook page has listed, with title, venue, start time, ticket links and going and interested counts.
Pull a single Facebook post from its URL: full text, attached media, author, reactions, comments and share count.
Pull the full timestamped transcript of the video in any Facebook post, every spoken line with its start and end time.
Pull every comment on a Facebook post, page by page, with author, text, reaction count, reply count and timestamp.
Pull the full nested reply thread under any Facebook comment, so you can rebuild the conversation rather than just the top level.
Pull the posts inside a public Facebook group, page by page, with author, text, media and engagement on every one.
Search Facebook events by keyword and get ranked results back with title, venue, start time and attendance counts.
Pull the Facebook events happening in any city, with venue, start time, ticket links and how many people are going.
Pull one Facebook event in full: description, venue and coordinates, start and end time, ticket links and attendance.
Pull one ad from the Facebook Ad Library in full: every creative, the advertiser behind it, spend range and the dates it ran.
Search the Facebook Ad Library by keyword and get the live ads back with creatives, advertiser, spend range and run dates.
Pull every ad a company is running on Facebook right now, with creatives, copy, format, spend range and how long each has run.
Find the advertiser page behind a brand name in the Facebook Ad Library, so you can pull its live ads by ID.
The same data on every other platform: Profile Scraper API, Post Scraper API, Transcript API, Comment Scraper API, Ad Library API, Event Scraper API.
How it works
Scraping Facebook, in three steps.
You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.
- 1
Create a free account
Sign up and top up any amount. The balance pays for every HProxy product. - 2
Grab your API key
One key from the dashboard authenticates every scraper. - 3
Call the endpoint
Send the GET you need and read the JSON. That is the entire integration.
Why it holds up
What you do not have to build.
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.
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.
- Pay per call from one balance, no subscription and no monthly minimum.
- Blocked, errored and timed-out calls are not charged.
- Proxies, retries and parsing are included in the price.
- The same endpoint from one call to millions.
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.
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.
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.
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.
API docs
Every scraper endpoint documented end to end, with the parameters it takes and the response it really returns.
Facebook questions
Facebook scraping, answered.
You send one HTTPS request to the endpoint you need with your API key, and HProxy handles the rest server-side: proxies, sessions, retries and parsing. The response is clean, structured JSON. No headless browser, no captcha solving, no parser maintenance on your side.
Pricing starts at $1.49 per 1,000 calls (0.15¢ per call), billed from your HProxy balance. There is no subscription and no monthly minimum. You top up once.
The API only accesses publicly available 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.
17 ready-made endpoints cover the public Facebook surface: profiles, content, engagement, search and more. Every endpoint returns the full structured object, not a stripped-down summary.
No. The scraper runs on HProxy's own residential network behind the scenes, so requests look like real users. You only make one API call, and the proxy layer is included in the per-call price.
Calls typically return in a few seconds. Errors are retried automatically, and unrecoverable errors and timeouts are not charged. A lookup whose target does not exist counts as a call, because the platform still had to be asked.
Every platform
116 scrapers, 23 platforms, one key.
The same REST call, the same JSON shape and the same balance behind all of them. Pick where you need data from.
Social Media
10 platforms, 86 endpoints
Streaming
4 platforms, 9 endpoints
Marketplace
2 platforms, 6 endpoints
Business / B2B
1 platform, 6 endpoints
Link in Bio
5 platforms, 5 endpoints
Ad Libraries
1 platform, 4 endpoints
More on the Facebook Scraper API
What the Facebook Scraper API is
The Facebook Scraper API is 17 ready-made endpoints behind one REST base URL: Profile, Profile Reels, Profile Photos, Profile Posts, Profile Events, Post, Post Transcript, Post Comments, Comment Replies, Group Posts, Events Search, Events by City, Event Details, Ad Library Detail, Ad Library Search, Company Ads and Ad Library Company Search. Each one is a single GET with your API key, and each one answers with a structured JSON object rather than a page of HTML, so nothing on your side has to parse markup or keep a selector alive. The proxies, sessions, retries, rendering and anti-bot handling all run on our side, which is the part of a Facebook scraper that normally breaks.
What you can scrape from Facebook
The catalog covers 6 kinds of Facebook data: profiles (1 endpoint: Profile), posts and media (5 endpoints: Profile Reels, Profile Photos, Profile Posts, Post and Group Posts), transcripts (1 endpoint: Post Transcript), comments (2 endpoints: Post Comments and Comment Replies), ads (4 endpoints: Ad Library Detail, Ad Library Search, Company Ads and Ad Library Company Search) and events (4 endpoints: Profile Events, Events Search, Events by City and Event Details). Every endpoint returns the full object it describes, not a trimmed summary, and the JSON keeps the same shape from the first call to the millionth, so a script written today still parses next month.
What scraping Facebook costs
Calls are billed from your HProxy balance at 0.15¢ each, $1.49 per 1,000, with no subscription and no monthly minimum. Blocked, errored and timed-out calls are not charged. A lookup whose target does not exist does count as a call, because Facebook still had to be asked before we could tell you.
Scraping Facebook yourself
Writing the request is the easy part. What costs the time is everything around it: residential addresses that do not get blocked, sessions that survive a login wall, a captcha path, a headless browser for the parts that render in JavaScript, and a parser rewritten every time Facebook moves its markup. This API is that work, kept running by us, priced per call, and it answers in the same JSON whether you send one request a day or a hundred a second.
Ready when you are.
Your dashboard is ten seconds away. No sales call, no subscription, no minimum.