Video
Download a public Facebook video in HD, with SD as a variant.
Endpoint
GET
/s/facebook/postSend 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
| Name | Description |
|---|---|
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
- media[0].url is HD when Facebook offers it; variants holds SD.
- Media URLs are signed by the platform and expire after a few hours. Download the files promptly instead of storing the links.