Facebook

Video

Download a public Facebook video in HD, with SD as a variant.

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 video. You can pass the numeric ID as id instead.Example: https://www.facebook.com/watch/?v=1234567890123456

Accepted links

  • https://www.facebook.com/watch/?v=<id>
  • https://www.facebook.com/<page>/videos/<id>
  • https://www.facebook.com/share/v/<code>/
  • https://fb.watch/<code>/
  • A numeric video ID

Example request

curl '/s/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1234567890123456' \
  -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": "1234567890123456",
    "url": "https://www.facebook.com/watch/?v=1234567890123456",
    "type": "video",
    "text": "Behind the scenes of our new studio",
    "createdAt": "2026-11-01T15:30:00Z",
    "author": {
      "id": "100064000000000",
      "username": "",
      "name": "Example Page",
      "avatar": "https://cdn.example/avatar.jpg",
      "verified": false
    },
    "media": [
      {
        "type": "video",
        "url": "https://video.fbcdn.example/hd.mp4",
        "thumbnail": "https://scontent.fbcdn.example/thumb.jpg",
        "width": 1280,
        "height": 720,
        "duration": 94.2,
        "variants": [
          {
            "url": "https://video.fbcdn.example/sd.mp4",
            "contentType": "video/mp4"
          }
        ]
      }
    ],
    "stats": {
      "likes": 3200,
      "comments": 210,
      "shares": 95,
      "views": 120000
    }
  }
}

Notes