Pull API \ Retrieve the posts published on a Facebook page

Workflow

Request: the code to send to the API

Send an API request to this endpoint to retrieve the posts that have been published on a Facebook page:

The <identity_token> is obtained whenever one of your users connects using Facebook. The <page_id> must be part of the pages that the identity is currently configured to be an administrator of.

The following URL parameters can optionally be used with this endpoint:

In order to use this endpoint the permission Manage Pages (manage_pages) must be enabled in the Facebook settings in your OneAll account and the user must have granted that permission when he logged in with Facebook.

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Wed, 30 Jan 2019 09:04:33  0100",
      "resource": "/pull/identities/2dbac3f7-0bd8-4e75-8def-7de12851b348/facebook/page/213995091781405/posts.json?num_posts=5&page=1",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 5,
        "entries": [
          {
            "id": "10216617594006061",
            "canonical": "1234567890_10216617594006061",            
            "url": "https://www.facebook.com/1234567890/posts/10216617594006061",            
            "type": "photo",
            "action": "added_photos",
            "text": "Hello world!",
            "date_created": "Mon, 24 Dec 2018 14:30:19  0100",
            "date_updated": "Tue, 25 Dec 2018 20:14:59  0100",
            "image": "https://scontent.xx.fbcdn.net/v/t1.0-9/45454545_10216617616806631_3315147954267881472_n.jpg?_nc_cat=101&_nc_ht=scontent.xx&oh=7fbf86081aedca60dffc9f2ae6dc1e71&oe=5CFC5B02",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t1.0-0/s130x130/45454545_10216617616806631_3315147954267881472_n.jpg?_nc_cat=101&_nc_ht=scontent.xx&oh=80dd10ee3fb1ed3dc9fa665fb689cfac&oe=5CB9A7E4",
            "attachments": [
                {
                    "title": "Share Icons · User Engagement Solutions | www.oneall.com",
                    "description": "Let your users share comments, purchases, reviews and other activities directly from your app or website to their friends on multiple social networks. Our share icons are fully customizable and seamlessly integrate into your website.",
                    "unshimmed_url": "http://oal.lu/IzAUW",
                    "media_type": "link"
                },
            ],
            "place": {
              "name": "La Bella Vita Ristorante",
              "location": {
                "city": "New York",
                "country": "USA",
                "street": " 163 Mulberry St",
                "zip": "NY 10013",
                "latitude": 40.719981,
                "longitude": -73.997367
              }
            },
            "num_shares": 0,
            "num_likes": 4,
            "is_published": true
          },
          {
            "id": "1234567890_10216515282248331",
            "url": "https://www.facebook.com/1234567890/posts/10216515282248331",
            "type": "video",
            "action": "mobile_status_update",
            "date_created": "Mon, 10 Dec 2018 09:05:27  0100",
            "date_updated": "Mon, 10 Dec 2018 09:05:27  0100",
            "image": "https://scontent.xx.fbcdn.net/v/t15.5256-10/47474747_311666506104769_6623145964808962048_n.jpg?_nc_cat=107&_nc_ht=scontent.xx&oh=cc242670625e93bd46e45b7155fee792&oe=5CF1A1C8",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/p130x130/47474747_311666506104769_6623145964808962048_n.jpg?_nc_cat=107&_nc_ht=scontent.xx&oh=f7e43219fe7f4b39eba92f775ba3b483&oe=5CEF4429",
            "num_shares": 1,
            "num_likes": 7,
            "is_published": true
          },
          {
            "id": "1234567890_10216465559725299",
            "url": "https://www.facebook.com/1234567890/posts/10216465559725299",
            "type": "video",
            "action": "mobile_status_update",
            "text": "User Integration as a service",
            "date_created": "Mon, 03 Dec 2018 19:41:58  0100",
            "date_updated": "Mon, 03 Dec 2018 19:41:58  0100",
            "image": "https://scontent.xx.fbcdn.net/v/t15.5256-10/34682314_2548015535423518_1824029429010006016_n.jpg?_nc_cat=110&_nc_ht=scontent.xx&oh=f8dd41183038a8b054fa277ea5f35aa0&oe=5CB37B31",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t15.5256-10/s130x130/34682314_2548015535423518_1824029429010006016_n.jpg?_nc_cat=110&_nc_ht=scontent.xx&oh=abf63b42397888ebed021d230f0d3241&oe=5CBCF577",
            "num_shares": 2410,
            "num_likes": 42355,
            "is_published": true
          },
          {
            "id": "1234567890_10216457544524924",
            "url": "https://www.facebook.com/1234567890/posts/10216457544524924",
            "type": "photo",
            "action": "added_photos",
            "text": "Increase your business productivity by reducing development time and eliminating maintenance costs or data protection issues.",
            "date_created": "Sun, 02 Dec 2018 18:27:39  0100",
            "date_updated": "Sun, 02 Dec 2018 22:33:13  0100",
            "image": "https://scontent.xx.fbcdn.net/v/t1.0-9/s720x720/43434343_10216457451322594_1828994926600257536_n.jpg?_nc_cat=109&_nc_ht=scontent.xx&oh=6c014c76c052a1d54a539a8abaa20a77&oe=5CF8298C",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t1.0-0/s130x130/43434343_10216457451322594_1828994926600257536_n.jpg?_nc_cat=109&_nc_ht=scontent.xx&oh=3673b293264319ffe467b21679d4c3f2&oe=5CC43A81",
            "num_shares": 130,
            "num_likes": 6434,
            "is_published": true
          },
          {
            "id": "1234567890_10216432798386286",
            "url": "https://www.facebook.com/1234567890/posts/10216432798386286",
            "type": "photo",
            "action": "added_photos",
            "date_created": "Thu, 29 Nov 2018 14:47:19  0100",
            "date_updated": "Fri, 30 Nov 2018 06:46:37  0100",
            "image": "https://scontent.xx.fbcdn.net/v/t1.0-9/s720x720/56565656_10216432687583516_2254042224700424192_n.jpg?_nc_cat=101&_nc_ht=scontent.xx&oh=b933d19436276cade534466a290b7858&oe=5CFED0B7",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t1.0-0/s130x130/56565656_10216432687583516_2254042224700424192_n.jpg?_nc_cat=101&_nc_ht=scontent.xx&oh=dbc092349661f41f31e2cb600e5d6c1b&oe=5CBC66BA",
            "num_shares": 0,
            "num_likes": 4,
            "is_published": false
          }
        ]
      }
    }
  }
}