Pull API \ Retrieve the pins posted by a Pinterest 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 all pins posted by a Pinterest user:

GET /pull/identities/<identity_token>/pinterest/pins.json

The <identity_token> is obtained whenever one of your users connects using his Pinterest account.

To be able to use this endpoint Pinterest must be fully configured for your OneAll Site. You can use the Push API to publish new pins on behalf of a user and the Pull API to retrieve the pins of a specific board.

Result: the code returned by the API

Response Example

{
  "response": {
    "request": {
      "date": "Thu, 31 Oct 2019 17:17:40 +0100",
      "resource": "/pull/identities/2af20011-8965-471b-8f6b-8b66a611aae6/pinterest/pins.json",
      "status": {
        "flag": "success",
        "code": 200,
        "info": "Your request has been processed successfully"
      }
    },
    "result": {
      "data": {
        "count": 2,
        "entries": [
          {
            "id": "123456789012345678",
            "picture": "https://i.pinimg.com/originals/3e/85/6c/5ab46ceaf39eb5a8d21585a7bd7e43c2.jpg",
            "description": "This is a great pin!",
            "link": "https://www.oneall.com/",
            "location": "https://www.pinterest.com/pin/123456789012345678/",
            "board": {
              "url": "https://www.pinterest.com/user-name/board-name/",
              "id": "987654321098765432",
              "name": "board-name"
            }
          },
          {
            "id": "987654321098765432",
            "picture": "https://i.pinimg.com/originals/3e/85/6c/a3556ceaf39eb5a8d21585a7bd7e43c2.jpg",
            "description": "This is another great pin!",
            "link": "https://www.example.com/",
            "location": "https://www.pinterest.com/pin/987654321098765432/",
            "board": {
              "url": "https://www.pinterest.com/user-name/board-name/",
              "id": "987654321098765432",
              "name": "board-name"
            }
          }
        ]
      }
    }
  }
}

User Contributed Notes