Social Fetch
Facebook

Get Facebook profile

Get a Facebook profile or page.

GET/v1/facebook/profiles
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
url*stringquery

Facebook public profile or page URL to look up.

min 1 chars · max 4096 chars

includeBusinessHoursbooleanoptionalquery

Optional: include structured business hours in the response when available.

Response fields
84

Endpoint-specific response payload.

datalookupStatus
string

Whether the profile was resolved.

one of: found, private, not_found

Profile details when available.

dataprofileplatform
string

Social platform for this profile.

one of: facebook

dataprofileprofileType
string

Whether the lookup resolved to a personal profile or business page.

one of: person, business

dataprofiledisplayName
stringnullable

Public display name shown on the Facebook profile or page.

dataprofileprofileUrl
string

Canonical public Facebook profile or page URL.

min 1 chars

dataprofileavatarUrl
stringnullable

Best available avatar image URL.

dataprofilecoverImageUrl
stringnullable

Best available cover image URL.

dataprofileplatformUserId
stringoptional

Facebook profile or page id when available.

dataprofilegender
stringnullableoptional

Gender label when available for personal profiles.

one of: female, male, unknown, null

Profile metrics when available.

datametricslikes
integernullable

Page likes count when available.

≥ 0

datametricsfollowers
integernullable

Page follower count when available.

≥ 0

datametricsratingCount
integernullable

Number of public ratings or reviews when available.

≥ 0

Public contact information when available.

datacontactaddress
stringnullable

Public business address when available.

datacontactemail
stringnullable

Public contact email when available.

datacontactphone
stringnullable

Public phone number when available.

datacontactwebsite
stringnullable

Primary public website URL when available.

Business-page-specific details when available.

databusinessintro
stringnullable

Short public introduction shown on the page when available.

databusinesscategory
stringnullable

Primary category label when available.

databusinessservices
stringnullable

Service summary when available.

databusinesspriceRange
stringnullable

Displayed price range when available.

databusinessratingText
stringnullable

Public rating summary text when available.

databusinessisActive
booleanoptional

Whether the page is marked as an active business page.

databusinesscreatedDateText
stringnullableoptional

Human-readable page creation date when available.

databusinessadLibraryStatus
stringnullableoptional

Advertising activity summary when available.

databusinessadLibraryPageId
stringnullableoptional

Facebook page id shown in the ad library when available.

Structured business hours when requested and available.

Business hours for one weekday.

databusinesshoursmondayopen
stringnullable

Opening time for the first interval when available.

databusinesshoursmondayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshoursmondayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshoursmondayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshoursmondaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshourstuesdayopen
stringnullable

Opening time for the first interval when available.

databusinesshourstuesdayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshourstuesdayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshourstuesdayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshourstuesdaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshourswednesdayopen
stringnullable

Opening time for the first interval when available.

databusinesshourswednesdayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshourswednesdayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshourswednesdayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshourswednesdaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshoursthursdayopen
stringnullable

Opening time for the first interval when available.

databusinesshoursthursdayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshoursthursdayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshoursthursdayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshoursthursdaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshoursfridayopen
stringnullable

Opening time for the first interval when available.

databusinesshoursfridayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshoursfridayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshoursfridayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshoursfridaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshourssaturdayopen
stringnullable

Opening time for the first interval when available.

databusinesshourssaturdayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshourssaturdayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshourssaturdayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshourssaturdaytext
string

Human-readable business-hours text for the day.

Business hours for one weekday.

databusinesshourssundayopen
stringnullable

Opening time for the first interval when available.

databusinesshourssundayclose
stringnullable

Closing time for the last interval when available.

Structured opening intervals for the day.

databusinesshourssundayintervals[]open
stringnullable

Start time for one business-hours interval when available.

databusinesshourssundayintervals[]close
stringnullable

End time for one business-hours interval when available.

databusinesshourssundaytext
string

Human-readable business-hours text for the day.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/facebook/profiles?url=https://www.facebook.com/profile.php?id=61575098504636" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.

On this page

No Headings