Pull API \ Retrieve the likes 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 pages that a Facebook user has liked:

GET /pull/identities/<identity_token>/facebook/likes.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_likes
integer
Indicates how many likes 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

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.

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