Facebook

Photo

Download a Facebook photo, or every photo of a multi-photo post.

Endpoint

GET
/s/facebook/post

Send your API key in the X-API-Key header. facebook is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
urlrequired
Link to the photo. You can pass the numeric ID as id instead.Example: https://www.facebook.com/photo/?fbid=1122334455667788

Accepted links

  • https://www.facebook.com/photo/?fbid=<id>
  • https://www.facebook.com/<page>/photos/a.<album>/<id>
  • https://www.facebook.com/share/p/<code>/ (multi-photo posts come back as type "carousel")
  • Post links: /<page>/posts/<id>, /permalink.php?story_fbid=…

Example request

curl '/s/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Fphoto%2F%3Ffbid%3D1122334455667788' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "platform": "facebook",
    "id": "1122334455667788",
    "url": "https://www.facebook.com/photo/?fbid=1122334455667788",
    "type": "photo",
    "text": "Team day 🎉",
    "createdAt": "2026-10-21T11:00:00Z",
    "author": {
      "id": "100064000000000",
      "username": "",
      "name": "Example Page",
      "avatar": "https://cdn.example/avatar.jpg",
      "verified": false
    },
    "media": [
      {
        "type": "image",
        "url": "https://scontent.fbcdn.example/photo.jpg",
        "width": 2048,
        "height": 1365
      }
    ],
    "stats": {
      "likes": 412,
      "comments": 18,
      "shares": 6
    }
  }
}

Notes