Pull API \ Retrieve the pins posted by a Pinterest user
Pull API Resources
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 |
LinkedIn · Retrieve a post
/pull/identities/<identity_token>/linkedin/post.json
|
Retrieve Post |
LinkedIn · Retrieve post comments
/pull/identities/<identity_token>/linkedin/post/comments.json
|
Retrieve Post Comments |
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 |
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 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" } } ] } } } }