Pull API \ Retrieve the pins posted on a Pinterest board

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 groups /pull/identities/<identity_token>/facebook/groups.json Retrieve Groups
Facebook · Retrieve a user's group posts /pull/identities/<identity_token>/facebook/group/<pageid>/posts.json Retrieve Group 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
Facebook · Retrieve a user's page post reactions /pull/identities/<identity_token>/facebook/page/<pageid>/posts.json Retrieve Page Post Reactions
LinkedIn · Retrieve a user's posts /pull/identities/<identity_token>/linkedin/user/posts.json Retrieve User 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
Twitch · Retrieve all broadcaster's subscriptions /pull/identities/<identity_token>/twitch/broadcaster/subscriptions.json Retrieve Broadcaster's subscriptions
Twitch · Retrieve channels information /pull/identities/<identity_token>/twitch/channels.json Retrieve Channels
Twitch · Retrieve clips information /pull/identities/<identity_token>/twitch/clips.json Retrieve Clips
Twitch · Retrieve games information /pull/identities/<identity_token>/twitch/games.json Retrieve Games
Twitch · Retrieve most viewed games /pull/identities/<identity_token>/twitch/games/top.json Retrieve Top Games
Twitch · Retrieve live streams /pull/identities/<identity_token>/twitch/streams.json Retrieve Streams
Twitch · Retrieve users information /pull/identities/<identity_token>/twitch/users.json Retrieve Users
Twitch · Retrieve follow relationships between two users /pull/identities/<identity_token>/twitch/users/follow.json Retrieve Users Follows
Twitch · Retrieve videos information /pull/identities/<identity_token>/twitch/videos.json Retrieve Videos
Twitter · Retrieve a user's followers /pull/identities/<identity_token>/twitter/followers.json Retrieve Followers
Twitter · Retrieve a user's followings /pull/identities/<identity_token>/twitter/followings.json Retrieve Followings
Twitter · Retrieve a user's tweets /pull/identities/<identity_token>/twitter/tweets.json Retrieve Tweets
Twitter · Retrieve a user /pull/identities/<identity_token>/twitter/user.json Retrieve User
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
YouTube · Retrieve a user's channel sections /pull/identities/<identity_token>/youtube/channel/sections.json Retrieve Channel Sections

Workflow

Request: the code to send to the API

Send an API request to this endpoint to retrieve all Pins from a user's Pinterest board:

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

The <identity_token> is obtained whenever one of your users connects using his Pinterest account. The <board_id> must be the identifier of a board owned by the same user.

To be able to use this endpoint Pinterest must be fully configured for your OneAll Site. You can use the Pull API to retrieve the boards of a user and the Push API to publish new pins on a 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/board/352969758234765041/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/"
          },
          {
            "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/"
          }        
        ]
      }
    }
  }
}

User Contributed Notes