Facebook · Profiles

Facebook Profile Scraper API

The Facebook Profile endpoint is one API call: send a URL with your HProxy key and get back a clean, structured JSON object. Pull a public Facebook page or profile from its URL: name, category, follower counts, contact details and business hours. 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.

Get your API key Facebook API reference

0.15¢ per call
$1.49 per 1,000
Takes a URL
Errors and timeouts are not charged

On Facebook

Profiles1Posts and media5 Transcripts1 Comments2 Ads4 Events4

Profiles

Facebook

The call

One GET, and the profile comes back as JSON.

Your key goes in one header. 1 required parameter, and the answer is the object below it.

The full reference

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"

Response200 OK · JSON

{
  "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"
}

What comes back

The Facebook profile object.

bio / links: Public bio text and any linked URLs.
counts: Followers, following and post or video counts.
isVerified: Verification and account-type flags.
avatar: Profile image URL and display name.

What it takes

Parameters.

urlurlRequiredhttps://www.facebook.com/nasa

Target URL (profile, post or video).

get_business_hoursbooleantrue

Also include business hours in the response.

include_gated_profilebooleantrue

Optional flag (true or false).

cache_max_agestring1d

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`.

How it works

Scraping Facebook profile, in three steps.

You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.

Create a free account Every Facebook endpoint

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.

What people build with it

Where the Facebook profile endpoint earns its keep.

Enrich a CRM or lead list with live Facebook profile data.
Verify accounts and detect fakes at scale.
Track competitor profiles and bios for changes.

Facebook profile questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the Facebook Profile endpoint with a URL and your HProxy API key. Pull a public Facebook page or profile from its URL: name, category, follower counts, contact details and business hours. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

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.

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.

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

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.

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

Profiles elsewhere

The same data on 18 other platforms.

One key, one JSON shape, one balance. Move sideways without learning a second API.

Profile Scraper API

TikTok Profile23 endpoints on TikTok Instagram Profile11 endpoints on Instagram LinkedIn Profile6 endpoints on LinkedIn Twitter / X Profile6 endpoints on Twitter / X Threads Profile5 endpoints on Threads Twitch Profile4 endpoints on Twitch Bluesky Profile3 endpoints on Bluesky Truth Social Profile3 endpoints on Truth Social Snapchat Profile1 endpoint on Snapchat Linkme Profile1 endpoint on Linkme YouTube Channel13 endpoints on YouTube Reddit Subreddit Details5 endpoints on Reddit Spotify Artist3 endpoints on Spotify Komi Page1 endpoint on Komi Linkbio Page1 endpoint on Linkbio Linktree Page1 endpoint on Linktree Pillar Page1 endpoint on Pillar SoundCloud Artist1 endpoint on SoundCloud

17 Facebook endpoints, one key.

The Facebook catalog

Facebook Profile ReelsPosts and media Facebook Profile PhotosPosts and media Facebook Profile PostsPosts and media Facebook Profile EventsEvents Facebook PostPosts and media Facebook Post TranscriptTranscripts Facebook Post CommentsComments Facebook Comment RepliesComments Facebook Group PostsPosts and media

Every platform

The same key works on all 23.

The whole catalog

More on the Facebook Profile API

What the Facebook Profile endpoint returns

Pull a public Facebook page or profile from its URL: name, category, follower counts, contact details and business hours. The JSON object carries bio / links, counts, isVerified and avatar. Nothing is summarised away on our side, so what you read in the response is what the Facebook profile page itself holds.

What you send to the Facebook Profile API

The call takes a URL. Required: url. Optional: get_business_hours, include_gated_profile and cache_max_age. Your key travels in the X-API-Key header, the response is JSON, and the call is billed at 0.15¢, $1.49 per 1,000.

Profiles on other platforms

The same profiles data is available on 18 other platforms: TikTok Profile, Instagram Profile, LinkedIn Profile, Twitter / X Profile, Threads Profile, Twitch Profile, Bluesky Profile, Truth Social Profile, Snapchat Profile, Linkme Profile, YouTube Channel, Reddit Subreddit Details, Spotify Artist, Komi Page, Linkbio Page, Linktree Page, Pillar Page and SoundCloud Artist. They share this endpoint's JSON shape, its per-call billing and your one API key, so moving from Facebook to another network is a change of URL rather than a second integration.

Is scraping Facebook profile allowed?

The endpoint reads publicly available Facebook data, the same pages anyone can open in a browser without logging in. It does not touch private accounts or anything behind a password. How you then use the data is yours to keep lawful, under the rules that apply to you and to Facebook.

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