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/<playlist_id>/videos.json Retrieve
Playlist Videos

Workflow

Request: the code to send to the API

Send a GET request to the endpoint /pull/identities/<identity_token>/facebook/pages.json to retrieve the pages that the user is currently configured to be an administrator of. The <identity_token> is obtained whenever one of your users connects using Facebook.

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.

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

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