Pull API \ Retrieve the posts of a Facebook user

Resource/URI GET
Facebook · Retrieve a user's likes /pull/identities/<identity_token>/facebook/likes.json Retrieve Likes
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve Posts
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve Pages
Facebook · Retrieve a user's page posts /pull/identities/<identity_token>/facebook/page/<pageid>/posts.json Retrieve Page Posts
LinkedIn · Retrieve a user's companies /pull/identities/<identity_token>/linkedin/companies.json Retrieve Companies
LinkedIn · Retrieve a user's company posts /pull/identities/<identity_token>/linkedin/company/<companyid>/posts.json Retrieve Company Posts
Pinterest · Retrieve a user's boards /pull/identities/<identity_token>/pinterest/boards.json Retrieve Boards
Pinterest · Retrieve a user's board pins /pull/identities/<identity_token>/pinterest/board/<boardid>/pins.json Retrieve Board Pins
Pinterest · Retrieve a user's pins /pull/identities/<identity_token>/pinterest/pins.json Retrieve Pins
Steam · Retrieve a user's games /pull/identities/<identity_token>/steam/games.json Retrieve Games
Twitter · Retrieve a user's tweets /pull/identities/<identity_token>/twitter/tweets.json Retrieve Tweets
YouTube · Retrieve a user's channels /pull/identities/<identity_token>/youtube/channels.json Retrieve Channels
YouTube · Retrieve a user's playlists /pull/identities/<identity_token>/youtube/playlists.json Retrieve Playlists
YouTube · Retrieve a user's playlist videos /pull/identities/<identity_token>/youtube/playlist/<playlistid>/videos.json Retrieve Playlist Videos

Workflow

Request: the code to send to the API

Send an API request to this endpoint in order to retrieve the posts shared on a user's Facebook timeline:

GET /pull/identities/<identity_token>/facebook/posts.json

The <identity_token> is obtained whenever one of your users connects using Facebook. The following URL parameters can optionally be used with this endpoint:

URL Parameter Description
num_posts
integer
Indicates how many posts should be included in the resultset. The valid range is between 1 an 200.
Default: 50
page
integer
Indicates the page that should be retrieved. To paginate the resultset, simply start with page 1 and make subsequent requests to this endpoint while incrementing the page number with each call.
Default: 1
limit_own_posts
boolean
Per default all posts and links published by this person, or by others on this person's timeline are returned. Set the value to true to only retrieve posts made by the person herself.
Default: false

In order to use this endpoint the permission User Posts (user_posts) 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/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": "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",
            "attached_link": {
              "link": "https://www.facebook.com/1234567890/posts/10216617594006061"
            },
            "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",
            "attached_link": {
              "link": "https://www.facebook.com/1234567890/posts/10216515282248331",
              "name": "OneAll",
              "description": "Integrate 35+ social networks with our web-delivered tools. Reunite your existing user data in a state-of-the-art security environment that is 100% compliant with all US & EU data protection laws."
            },
            "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",
            "attached_link":{
              "link": "https://www.facebook.com/1234567890/posts/10216465559725299",
              "name": "OneAll",
              "description": "Standardized JSON/REST API to work with multiple social networks at once and store your CIAM user information in a state-of-the-art security environment."
            },
            "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",
            "attached_link":{
              "link": "https://www.facebook.com/1234567890/posts/10216457544524924"
            },
            "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",
            "attached_link":{
              "link": "https://www.facebook.com/1234567890/posts/10216432798386286",
              "name": "Photos from John Doe's post"
            },
            "num_shares": 0,
            "num_likes": 4,
            "is_published": false
          }
        ]
      }
    }
  }
}

User Contributed Notes