Facebook

Story

Download a Facebook story from its link.

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 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