> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/facebook/profiles>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/facebook/profiles.mdx>

---

# Facebook Profile API

Resolve a public Facebook page or profile URL to structured JSON — display name, avatar, likes and followers, contact and business fields — without a Meta Graph app for assets you do not own.

`GET /v1/facebook/profiles` takes a public Facebook profile or page `url` query param and returns the shared Social Fetch envelope. Branch on `data.lookupStatus` before you write a row — `found`, `private`, and `not_found` are explicit outcomes. On `found`, read `data.profile` (including `profileType` of `person` or `business`), plus `metrics`, `contact`, and `business` when present. Pass `includeBusinessHours=true` when you need structured opening hours for a page that publishes them.

This route returns the page or profile card only. Posts, reels, and photos are separate paths on the Facebook hub. Bill from `meta.creditsCharged`.

## Request

- **Endpoint:** `GET /v1/facebook/profiles`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by profile URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/facebook/profiles/get)
- **Platform page:** [/platforms/facebook](https://www.socialfetch.dev/platforms/facebook)

## FAQ

### How do I look up a Facebook page or profile via API?

Call `GET /v1/facebook/profiles` with your Social Fetch API key (`x-api-key`) and a public Facebook `url` query param. Read `data.lookupStatus` and the profile payload in the JSON response. See the API docs for parameters and examples.

### How much does the Facebook Profile API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

### What fields does the Facebook profile response include?

When `lookupStatus` is `found`, the payload can include profile identity (`profileType`, display name, profile URL, avatar, cover, platform user id), metrics such as likes, followers, and rating count, public contact fields (address, email, phone, website), and business-page fields such as category, intro, services, price range, and optional structured hours when you request them.

### Does this work for both personal profiles and business Pages?

Yes. The same route accepts public profile and Page URLs. Check `data.profile.profileType` — `person` or `business` — and treat `business` fields as optional. Coverage follows what Facebook shows publicly on that URL.

### Do I need Meta Graph API access or page admin rights?

No. Social Fetch returns publicly visible page and profile data for enrichment-style lookups. Meta's Graph and Marketing APIs are for assets and ads accounts you control or that authorize your app — not arbitrary public competitor pages.

### What happens for private or missing Facebook profiles?

The call still returns a typed `lookupStatus`. Private targets resolve as `private`; unknown or removed URLs as `not_found`. Do not invent likes, bios, or contact lines. Keep `meta.requestId` if you need support on a failed enrichment row.

### Facebook profile lookup vs posts or reels endpoints?

Use `GET /v1/facebook/profiles` for the page or profile card. For content lists use `GET /v1/facebook/profiles/posts`, `GET /v1/facebook/profiles/reels`, or `GET /v1/facebook/profiles/photos`. See the Facebook platform hub for the full list.