Profile

GET/v1/facebook/profile1 credit

Returns the public details of a Facebook page or profile: name, category, contact details, follower and like counts, profile and cover photos, creation date and whether it is running ads.

01Query parameters

Name	Type	Description
urlrequired	string	A Facebook page or profile URL, e.g. `https://www.facebook.com/NASA`.
get_business_hoursoptional	boolean	Set to `true` to add `businessHours` when the page shows opening hours.Default: `false`
include_gated_profileoptional	boolean	Accepted for compatibility; it has no effect.
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh and billed normally. A value outside the list is rejected with a free 400.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FNASA" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2FNASA

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "adLibrary": {
    "adStatus": "This Page isn't currently running ads.",
    "pageId": "54971236771"
  },
  "creationDate": "March 4, 2009",
  "id": "100044561550831",
  "name": "NASA - National Aeronautics and Space Administration",
  "url": "https://www.facebook.com/NASA",
  "gender": "NEUTER",
  "coverPhoto": {
    "focus": {
      "x": 0.5,
      "y": 0.75161812297735
    },
    "photo": {
      "id": "1629624498532920",
      "image": {
        "uri": "https://scontent.fasr1-2.fna.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_tt6&cstp=mx2047x1487&ctp=s2047x1487&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=Bbm8iHSal8oQ7kNvwHMMFGv&_nc_oc=AdorrB9vyArTJhgLJpxahkUpjZBPfTNRCGI8TfYjk9At9E_B78e7WGa6VZA7BSy50Fo&_nc_zt=14&_nc_ht=scontent.fasr1-2.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b…",
        "width": 2047,
        "height": 1487
      },
      "viewer_image": {
        "height": 1487,
        "width": 2047
      },
      "blurred_image": {
        "uri": "https://scontent.fasr1-2.fna.fbcdn.net/v/t39.99422-6/809146614_4484013928506139_3181913787670602881_n.png?stp=dst-jpg_fb50_s320x320_tt6&_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=Bbm8iHSal8oQ7kNvwHMMFGv&_nc_oc=AdorrB9vyArTJhgLJpxahkUpjZBPfTNRCGI8TfYjk9At9E_B78e7WGa6VZA7BSy50Fo&_nc_zt=14&_nc_ht=scontent.fasr1-2.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00_AQN-Iftb…",
        "width": 320,
        "height": 232
      },
      "url": "https://www.facebook.com/photo/?fbid=1629624498532920&set=a.416660999829282"
    }
  },
  "isBusinessPageActive": false,
  "profilePhoto": {
    "url": "https://www.facebook.com/photo/?fbid=423033359192046&set=a.416661003162615",
    "viewer_image": {
      "height": 800,
      "width": 800
    },
    "id": "423033359192046"
  },
  "profilePicLarge": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s480x480&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "profilePicMedium": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s320x320&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "profilePicSmall": "https://scontent.fasr1-4.fna.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=CbwQIU3wAgMQ7kNvwFBrtUa&_nc_oc=AdrE4IqXRDcy0CcQztkxXG16qTOLCOMvmp4iKp64fTDMdUmYjfskaYgNWx-i7qbWZyE&_nc_zt=24&_nc_ht=scontent.fasr1-4.fna&_nc_gid=hs2lO4UREgzbNbTyrbFwgA&_nc_ss=7b289&oh=00…",
  "pageIntro": "Explore the universe and discover our home planet. \nThere's space for everybody. ✨",
  "category": "Government organization",
  "email": "[email protected]",
  "links": [],
  "website": "https://www.nasa.gov/nasa-app/",
  "ratingCount": null,
  "likeCount": 28742792,
  "talkingAboutCount": 100611,
  "followerCount": 28000000
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

An unknown page returns a free 404 with `accountDoesNotExist: true`. Address, phone, services, price range, rating and business hours appear only when the page has them; `links` only when the page's intro lists them. `ratingCount` is always null.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.