Pull API \ Retrieve the pages of a Facebook user

Resource/URI HTTP 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
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 the following endpoint in order to retrieve the Facebook pages that the user is currently configured to be an administrator of:

GET /pull/identities/<identity_token>/facebook/pages.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_pages
integer
Indicates how many pages should be included in the resultset. The valid range is between 1 an 200.
Default: 25
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

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. You can publish content to a page using our Push API.

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Fri, 31 Aug 2018 11:02:08  0200",
      "resource": "/pull/identities/2dbac3f7-0bd8-4e75-8def-7de12851b348/facebook/pages.json",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 2,
        "entries": [
          {
            "id": "1111111111111111",
            "access_token": "EAACgkGpLn7MBAO6hmFDeY9x8wExYmDHyqq3ZCEKPJFghZBjmyOsrBSZA5ZBu14iqSRxMEqOAIpH9ejthptOml2rQ9B3gPP4kVPqjRgZAzOqRZBOlosgNDmSay1uvRsPzTDTxNFjdXPkboVVvZBFW0ZCSsWx2mxjOoFm8DMsLJQkEnAZDZD",
            "is_published": true,
            "is_permanently_closed": false,
            "name": "Example Company 1",
            "category": "Business Service",
            "link": "https://www.facebook.com/example-company-1/",
            "cover": "https://scontent.xx.fbcdn.net/v/t31.0-8/s720x720/27710182_1111111111111111_7596317803109516070_o.jpg?_nc_cat=0&oh=28f73d9015ef09b47b0a68b4719321ff&oe=5C3A489B",
            "fans": 2362
          },
          {
            "id": "2222222222222222",
            "access_token": "EAACgkGpLn7MBABN3c5SNqWxUP64d1re0pXygezMZCbYBZCTiD95MFZCUWaCjzYBV9NZCWk38ZA32qh1GgDiXPVFtRi7jCWUvk7yEi93rpuL3AE3FGtNadcsmD5qRnYdtMzx8QFMuZA5ir2FpT29nwVzK6vUV70UvB2FuZCRpZC96CgZDZD",
            "is_published": false,
            "is_permanently_closed": false,
            "name": "Example Company 2",
            "category": "Community",
            "link": "https://www.facebook.com/example-company-2/",
            "cover": "https://scontent.xx.fbcdn.net/v/t31.0-8/s720x720/27710182_2222222222222222_7596317803109516070_o.jpg?_nc_cat=0&oh=28f73d9015ef09b47b0a68b4719321ff&oe=5C3A489B",            
            "fans": 1231
          }
        ]
      }
    }
  }
}

User Contributed Notes