UnifAPI Docs

Get a Facebook profile or Page

Returns a public Facebook profile or Page by username: name, category, intro, follower and like counts, contact details and business information. Returns `not_found` when it does not exist or is not public.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/facebook/profiles/{username}

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

username*string

Facebook profile or Page username (or numeric id), as in facebook.com/{username}.

Length1 <= length <= 500

Query Parameters

include_business_hours?string

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

Value in

  • "true"
  • "false"

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/facebook/profiles/string"
{  "request_id": "string",  "data": {    "platform": "string",    "profile_type": "string",    "display_name": "string",    "profile_url": "string",    "avatar_url": "string",    "cover_image_url": "string",    "platform_user_id": "string",    "gender": "string",    "like_count": 0,    "follower_count": 0,    "rating_count": 0,    "contact": {      "address": "string",      "email": "string",      "phone": "string",      "website": "string"    },    "business": {      "intro": "string",      "category": "string",      "services": "string",      "price_range": "string",      "rating_text": "string",      "is_active": true,      "created_date_text": "string",      "ad_library_status": "string",      "ad_library_page_id": "string",      "hours": {        "monday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "tuesday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "wednesday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "thursday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "friday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "saturday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        },        "sunday": {          "open": "string",          "close": "string",          "intervals": [            {              "open": "string",              "close": "string"            }          ],          "text": "string"        }      }    }  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}