Pull API \ Retrieve the pages a Facebook user has liked

Facebook · Retrieve a user's likes /pull/identities/<identity_token>/facebook/likes.json Retrieve
Facebook · Retrieve a user's posts /pull/identities/<identity_token>/facebook/posts.json Retrieve
Facebook · Retrieve a user's pages /pull/identities/<identity_token>/facebook/pages.json Retrieve
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
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
Steam · Retrieve a user's games /pull/identities/<identity_token>/steam/games.json Retrieve
Twitter · Retrieve a user's tweets /pull/identities/<identity_token>/twitter/tweets.json Retrieve
YouTube · Retrieve a user's channels /pull/identities/<identity_token>/youtube/channels.json Retrieve
YouTube · Retrieve a user's playlists /pull/identities/<identity_token>/youtube/playlists.json Retrieve
YouTube · Retrieve a user's playlist videos /pull/identities/<identity_token>/youtube/playlist/<playlist_id>/videos.json Retrieve
Playlist Videos


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
Indicates how many entries should be included in the resultset. The valid range is between 1 an 200.
Default: 50
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