Facebook Profile Photos

Fetches photos from a public Facebook page with pagination support.

1 credit / request

GET /v1/facebook/profile/photos Try it

Facebook Profile Photos
GET /v1/facebook/profile/photos

Fetches photos from a public Facebook page with pagination support.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......

Parameters:
- url (query · string · required) = https://www.facebook.com/Spurs
- next_page_id (query · string · optional) = YXBwX2NvbGxlY3Rpb2......
- cursor (query · string · optional) = AQHSRM68MZ-AJKGSgRb0......

Overview

WakeScrap exposes this Facebook endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Fetches photos from a public Facebook page with pagination support. Each photo includes photo_id, accessibility_caption, viewer_image with uri, height, and width, plus a thumbnail and direct url. Pagination requires passing both next_page_id and cursor from the previous response.

Required params: url.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

url string required

Facebook page URL

Example:

https://www.facebook.com/Spurs

next_page_id string

To paginate through to the next page

Example:

YXBwX2NvbGxlY3Rpb2......

cursor string

To paginate through to the next page

Example:

AQHSRM68MZ-AJKGSgRb0......


              curl 'https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/facebook/profile/photos?url=https%3A%2F%2Fwww.facebook.com%2FSpurs&next_page_id=YXBwX2NvbGxlY3Rpb2......&cursor=AQHSRM68MZ-AJKGSgRb0......"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "credits_remaining": 1000,
  "photos": [
    {
      "id": "YXBwX2l0ZW06MTAwMDQ0NjM0NDUwMjA4OjIzMDUyNzI3MzI6NTo6MTQyODEwNjQwMjAyMDQ5NQ==",
      "photo_id": "1428106402020495",
      "accessibility_caption": "May be an image of basketball and text",
      "immersive_photo_encodings": [],
      "viewer_image": {
        "uri": "https://scontent-sea5-1.xx.fbcdn.net/v/t51.82787-15/622604539_18555344569004556_8789920462640292891_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=127cfc&_nc_ohc=YhJA3Uo9mQwQ7kNvwF-U78r&_nc_oc=...",
        "height": 1800,
        "width": 1440
      },
      "photo_cix_screen": null,
      "thumbnail": "https://scontent-sea5-1.xx.fbcdn.net/v/t51.82787-15/622604539_18555344569004556_8789920462640292891_n.jpg?stp=c0.119.1440.1440a_dst-jpg_s206x206_tt6&_nc_cat=105&ccb=1-7&_nc_sid=714...",
      "url": "https://www.facebook.com/photo.php?fbid=1428106402020495&set=pb.100044634450208.-2207520000&type=3"
    }
  ],
  "cursor": "AQHSRM68MZ-AJKGSgRb0....",
  "next_page_id": "YXBwX2NvbGxlY3Rpb24...."
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}