Story
Download a Facebook story from its link.
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 story. You can pass the numeric ID as id instead.Example: https://www.facebook.com/stories/100064000000000/UzpfSTEwMDA2NDAwMDAwMDAwMDo0NTY3/ |
Accepted links
- https://www.facebook.com/stories/<bucket>/<story>/
Example request
curl '/s/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Fstories%2F100064000000000%2FUzpfSTEwMDA2NDAwMDAwMDAwMDo0NTY3%2F' \
-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": "4567",
"type": "story",
"author": {
"id": "100064000000000",
"username": "",
"name": "Example Page",
"avatar": "https://cdn.example/avatar.jpg",
"verified": false
},
"media": [
{
"type": "video",
"url": "https://video.fbcdn.example/story.mp4",
"thumbnail": "https://scontent.fbcdn.example/story.jpg",
"duration": 12
}
],
"stats": {}
}
}Notes
- Facebook only lets you open stories by link; there is no lookup by username.
- If the link points at one story, only that story is returned. Otherwise you get the first one, with the other stories’ media after it.
- Most stories need a signed-in session. When Facebook shows a login wall the API answers 502 and the request is not billed.