Get Facebook profile
Looks up a Facebook public profile or page by full URL. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.
Operation
/v1/facebook/profilesHeaders
API key (`sfk_...`)
Parameters
Facebook public profile or page URL to look up.
min 1 chars · max 4096 chars
Optional: include structured business hours in the response when available.
Response fields
Endpoint-specific response payload.
Whether the profile was found, private, or not found.
one of: found, private, not_found
Profile details when available.
Social platform for this profile.
one of: facebook
Whether the lookup resolved to a personal profile or business page.
one of: person, business
Public display name shown on the Facebook profile or page.
Canonical public Facebook profile or page URL.
min 1 chars
Best available avatar image URL.
Best available cover image URL.
Facebook profile or page id when available.
Gender label when available for personal profiles.
one of: female, male, unknown, null
Profile metrics when available.
Page likes count when available.
≥ 0
Page follower count when available.
≥ 0
Number of public ratings or reviews when available.
≥ 0
Public contact information when available.
Public business address when available.
Public contact email when available.
Public phone number when available.
Primary public website URL when available.
Business-page-specific details when available.
Short public introduction shown on the page when available.
Primary category label when available.
Service summary when available.
Displayed price range when available.
Public rating summary text when available.
Whether the page is marked as an active business page.
Human-readable page creation date when available.
Advertising activity summary when available.
Facebook page id shown in the ad library when available.
Structured business hours when requested and available.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Business hours for one weekday.
Opening time for the first interval when available.
Closing time for the last interval when available.
Structured opening intervals for the day.
Start time for one business-hours interval when available.
End time for one business-hours interval when available.
Human-readable business-hours text for the day.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.
Error codes
Community tweets
Returns tweets for a single X community by URL. Check `data.lookupStatus` for `found` vs `not_found`. A `found` result may still include an empty `data.tweets` array when the community resolves but no tweets are returned in this response.
Profile posts
Lists public posts for a Facebook profile or page identified by `url` or `pageId`, with cursor-based pagination. Private profiles, missing pages, and profiles with no public posts can all surface as HTTP `200` with an empty `data.posts` page—this route does not expose `lookupStatus`. Call `GET /v1/facebook/profiles` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.