Pinterest provide a restful service (json) to access every pins in the of all users.


Pinterest API v3

https://api.pinterest.com/v3/pidgets/boards/[USERNAME]/[BOARDNAME]/pins https://api.pinterest.com/v3/pidgets/users/USERNAME/pins/


another version

• I've added paging support for all endpoints (I don't think boards works, not tested). 
• For each request just add the querystring parameter page on the end:

Pins: /{username}/pins

Returns an array of the specified user's pins. Limited to 50 results.

Example: http://pinterestapi.co.uk/jwmoz/pins from http://pinterest.com/jwmoz/pins/

Request $ curl http://pinterestapi.co.uk/jwmoz/pins Response

 1 {
 2     "body": [
 3         {
 4             href: "/pin/82190761922627506/",
 5             src: "http://media-cache-ec3.pinimg.com/236x/8f/89/c5/8f89c589227d78a9f2781eb1c2e79ee6.jpg",
 6             desc: "Iguazu Falls",
 7             board: {
 8                 href: "/jwmoz/take-me-there/",
 9                 name: "Take me there"
10             },
11             domain: "famouswonders.com",
12             attrib: false
13         },
14         {
15             href: "/pin/82190761920945513/",
16             src: "http://media-cache-ak2.pinimg.com/236x/d5/43/85/d543854261c0323e813ef0f991d9089a.jpg",
17             desc: "Samui lake by jwmoz, via Flickr",
18             board: "Been & Seen Thailand",
19             board: {
20                 href: "/jwmoz/been-seen-thailand/",
21                 name: "Been & Seen Thailand"
22             },
23             domain: "flickr.com",
24             attrib: {
25                 attrib: "by jwmoz",
26                 href: "http://www.flickr.com/photos/jwmoz/",
27                 source: "Flickr",
28                 img: "http://passets-ak.pinterest.com/images/api/attrib/flickr.png"
29             }
30         }
31     ],
32     "meta": {
33         "count": 2
34     }
35 }

Boards: /{username}/boards Returns an array of the specified user’s boards. Limited to 50 results.

Example: http://pinterestapi.co.uk/jwmoz/boards from http://pinterest.com/jwmoz/boards/

Request

$ curl http://pinterestapi.co.uk/jwmoz/boards

Response

 1 {
 2     "body": [
 3         {
 4             name: "JMOZ",
 5             href: "/jwmoz/jmoz/",
 6             src: "http://media-cache-ec0.pinimg.com/216x146/dc/ab/56/dcab566549e1d626110af92bf321f.jpg"
 7         },
 8         {
 9             name: "Take me there",
10             href: "/jwmoz/take-me-there/",
11             src: "http://media-cache-ak0.pinimg.com/216x146/e2/d6/15/e2d615ac2ff7a43213d6c7a6bca21.jpg"
12         },
13     ],
14     "meta": {
15         "count": 2
16     }
17 }

Usage

  • http://media-cache-ec3.pinimg.com/236x/8f/89/c5/8f89c589227d78a9f2781eb1c2e79ee6.jpg –> replace “236x” with “originals”

  • http://media-cache-ec3.pinimg.com/originals/8f/89/c5/8f89c589227d78a9f2781eb1c2e79ee6.jpg



Published

06 July 2014

Category

SHU

Tags