Profile Photos

GET/v1/facebook/profile/photos1 credit

Returns the photos of a Facebook page or profile, 8 per page.

01Query parameters

Name	Type	Description
urloptional	string	A Facebook page or profile URL, e.g. `https://www.facebook.com/NASA`. One of `url` or `next_page_id` is required.
next_page_idoptional	string	The `next_page_id` from the previous page. One of `url` or `next_page_id` is required.
cursoroptional	string	The `cursor` from the previous page; send it together with the `next_page_id` it came with.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/profile/photos?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/photos?url=https%3A%2F%2Fwww.facebook.com%2FNASA

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "photos": [
    {
      "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTY2NTIyNDYwMTYzOTU3Ng==",
      "photo_id": "1665224601639576",
      "accessibility_caption": "Dynamic, textured clouds swoop across the scene. Their color ranges from deep, steely blue to bright silver. Pink and white stars of varying sizes decorate the clouds.",
      "immersive_photo_encodings": [],
      "viewer_image": {
        "uri": "https://scontent.fist4-1.fna.fbcdn.net/v/t39.99422-6/861422087_1689398352779407_6512216750936510542_n.png?stp=dst-jpg_tt6&cstp=mx1041x941&ctp=s1041x941&_nc_cat=101&ccb=1-7&_nc_sid=127cfc&_nc_ohc=Gz-y5C-tjo4Q7kNvwFc-7-m&_nc_oc=Adr36AbgP7uHqnNNXSFzhYQCuLTAsTGvcf4jdyiFw-fIeVXDgh4Y4Rbks9Fvf8cw1ek&_nc_zt=14&_nc_ht=scontent.fist4-1.fna&_nc_gid=q52zW5pwDtgI-Hv2SQ2Ofw&_nc_ss=7b289&oh=00_AQOVs2wWbks6xloRc1…",
        "height": 941,
        "width": 1041
      },
      "photo_cix_screen": null,
      "thumbnail": "https://scontent.fist4-1.fna.fbcdn.net/v/t39.99422-6/861422087_1689398352779407_6512216750936510542_n.png?stp=c50.0.941.941a_dst-jpg_tt6&cstp=mx941x941&ctp=s552x414&_nc_cat=101&ccb=1-7&_nc_sid=714c7a&_nc_ohc=Gz-y5C-tjo4Q7kNvwFc-7-m&_nc_oc=Adr36AbgP7uHqnNNXSFzhYQCuLTAsTGvcf4jdyiFw-fIeVXDgh4Y4Rbks9Fvf8cw1ek&_nc_zt=14&_nc_ht=scontent.fist4-1.fna&_nc_gid=q52zW5pwDtgI-Hv2SQ2Ofw&_nc_ss=7b289&oh=00_AQOlv…",
      "url": "https://www.facebook.com/photo.php?fbid=1665224601639576&set=pb.100044561550831.-2207520000&type=3"
    },
    {
      "id": "YXBwX2l0ZW06MTAwMDQ0NTYxNTUwODMxOjIzMDUyNzI3MzI6NTo6MTY2NDQ3Nzg2MTcxNDI1MA==",
      "photo_id": "1664477861714250",
      "accessibility_caption": "A composite image of a radio wave formation that looks a lot like a treble clef musical symbol, hovering in the midst of two colliding galaxy clusters. There are many specks of light set against the blackness of space; those are galaxies and stars. At the center of the image is a large, oval, blue-purple cloud with ragged edges. In the middle of the purple field, tilting slightly to our left, is w…",
      "immersive_photo_encodings": [],
      "viewer_image": {
        "uri": "https://scontent.fist4-1.fna.fbcdn.net/v/t39.99422-6/861317101_1588286389118062_8708388213258835284_n.png?stp=dst-jpg_tt6&cstp=mx2048x1525&ctp=s2048x1525&_nc_cat=110&ccb=1-7&_nc_sid=127cfc&_nc_ohc=2ZOVyen9iQgQ7kNvwF-6HSD&_nc_oc=Adrv0HcBKc8ZmZODImq1acLsclKMuTTDRkRe3-atsFOjXSviCCoGFivABtJQVmZF6fA&_nc_zt=14&_nc_ht=scontent.fist4-1.fna&_nc_gid=q52zW5pwDtgI-Hv2SQ2Ofw&_nc_ss=7b289&oh=00_AQNCQ-0rFtNLCgm3…",
        "height": 1525,
        "width": 2048
      },
      "photo_cix_screen": null,
      "thumbnail": "https://scontent.fist4-1.fna.fbcdn.net/v/t39.99422-6/861317101_1588286389118062_8708388213258835284_n.png?stp=c262.0.1525.1525a_dst-jpg_tt6&cstp=mx1525x1525&ctp=s552x414&_nc_cat=110&ccb=1-7&_nc_sid=714c7a&_nc_ohc=2ZOVyen9iQgQ7kNvwF-6HSD&_nc_oc=Adrv0HcBKc8ZmZODImq1acLsclKMuTTDRkRe3-atsFOjXSviCCoGFivABtJQVmZF6fA&_nc_zt=14&_nc_ht=scontent.fist4-1.fna&_nc_gid=q52zW5pwDtgI-Hv2SQ2Ofw&_nc_ss=7b289&oh=00_…",
      "url": "https://www.facebook.com/photo.php?fbid=1664477861714250&set=pb.100044561550831.-2207520000&type=3"
    }
  ],
  "cursor": "AQHT64ui0V2-3Q7Juo7ALRSY7WeC_QhXydJnEoGQ-ePm9CcsgbXoC40E-z72ETg-hyfQAq37V4f9yM-J6G2a1MIwag",
  "next_page_id": "YXBwX2NvbGxlY3Rpb246cGZiaWQwM21xNFA5eFNIYmFTY1JOSzdFUWFqTUY4UmhMUnI4RUxjVXpTb0x1dnp1Z0RWQTRhSEpxOWllbjY5VGc4R2tzYUNMdFo0NDl1WmR0MkdYQTZDREJVdE5mYWtzd3Ns"
}

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

For the next page, pass back both `next_page_id` and `cursor` from the response. A profile without a photos tab returns an empty list for 0 credits. A `next_page_id` that did not come from a previous answer is rejected with a free 400.

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.