Pull API \ Retrieve the pages a Facebook user has liked

Resource/URI HTTP GET
Facebook · Retrieve a user's likes /pull/identities/<identity_token>/facebook/likes.json Retrieve
Likes
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve
Pages
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve
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 videos /pull/identities/<identity_token>/youtube/videos.json Retrieve
Videos

Workflow

Request: the code to send to the API

Send a GET request to the endpoint /pull/identities/<identity_token>/facebook/likes.json to retrieve the pages that a Facebook user has liked. The <identity_token> is obtained whenever one of your users connects using Facebook.

In order to use this endpoint the permission User Likes (user_likes) 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.

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

URL Parameter Description
num_likes
integer
Indicates how many entries 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

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Wed, 13 Mar 2019 15:55:13 +0100",
      "resource": "/pull/identities/95681432-e02d-4a0b-ac6a-5c59d0e1fdfd/facebook/likes.json?num_likes=2&page=1",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 10,
        "entries": [
          {
            "id": 123456789023456,
            "name": "Harry's Bar",
            "description": "The flamboyant spot known among music lovers and urban dwellers alike has made a reputation on a wide range of events featuring live concerts, screenings, lectures, electronic nights and performances.",
            "category": "Pub",
            "cover": "https://scontent.xx.fbcdn.net/v/t1.0-9/s720x720/12345678_1324048584416319_5126871030664527872_o.jpg?_nc_cat=106&_nc_ht=scontent.xx&oh=d943614945eb1d828e1dbd01c1f5de72&oe=5D25C487",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/12345678_1324048204416357_1603760948902887424_n.png?_nc_cat=111&_nc_ht=scontent.xx&oh=9d6d44224fe668af67319b9085ff08fc&oe=5D158F0F",
            "link": "https://www.facebook.com/harrys-bar/",
            "email": "info@harrys-bar.com",
            "phone": "+33 12 34 56 78",
            "place": {
              "name": "17, rue du Saint Esprit\nParis, France",
              "location": {
                "city": "Paris",
                "country": "France",
                "street": "17, rue du Saint Esprit",
                "zip": "1475",
                "latitude": 49.609363089026,
                "longitude": 6.1334585990778
              }
            },
            "fans": 9720,
            "checkins": 3200,
            "is_published": true,
            "is_permanently_closed": false
          },
          {
            "id": 9876543210987654,
            "name": "Computer Corp Inc.",
            "description": "Founded en 2001, Computer Corp is the leading provider of mainframe, midrange and desktop computers.",
            "category": "Computer Company",
            "cover": "https://scontent.xx.fbcdn.net/v/t31.0-8/s720x720/98765432_1862221244102052_1388364081980079851_o.jpg?_nc_cat=100&_nc_ht=scontent.xx&oh=b0de66392f7920613672ec6a2d19b343&oe=5D03EAC5",
            "thumbnail": "https://scontent.xx.fbcdn.net/v/t1.0-1/p50x50/98765432_1495888707401976_6125281998314578052_n.jpg?_nc_cat=106&_nc_ht=scontent.xx&oh=fd9ec15253e9edd6c376cddf76b92efe&oe=5D18413E",
            "link": "https://www.facebook.com/computer-corp/",
            "email": "contact@example.com",
            "phone": "+1-541-754-3010",
            "place": {
              "name": "228 Park Avenue\nNew York, United States",
              "location": {
                "city": "New York",
                "country": "United States",
                "street": "228 Park Avenue",
                "zip": "10001",
                "latitude": 49.63988,
                "longitude": 6.00897
              }
            },
            "fans": 862,
            "checkins": 0,
            "is_published": true,
            "is_permanently_closed": false
          },
    }        
    }
  }
}

User Contributed Notes