Social Fetch
Start for freeStart free
Facebook hub

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Facebook Profile API 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.

Other Facebook endpoints