pinterest api documentation [closed]

Question

Update Aug 2015: Pinterest provides it here now https://dev.pinterest.com/

Is there official or unofficial documentation on the v2 Pinterest API?

Things I know:

• JSON api is in version 2. https://api.pinterest.com/v2 gives you a json response
• People are programming against it because there is a mobile app and beta dev
• Pintrest authentication question on SO
• PHP wrapper for v1 with updates for v2 on Github by Kellan with methods: upload, pin, repin, boards, activity, popular - reading Kellan's code is the best information I could find
• More info on Kellan's work with responses from Pinterest team
• Private unofficial Facebook Pinterest Dev group
• Here are some of the stars behind Pinterest

Update Mar 4 2014 Pinterest has unveiled a beta v3 API which you can request access to. Scroll down the page and you'll see the endpoints listed in the left column. https://developers.pinterest.com/api_docs/

Update Jan 9 2013 Since https://api.pinterest.com/v2 gives a 404, it seems to have been moved to v3. https://api.pinterest.com/v3

{ "status": "failure", "code": 11, "host": "053", "generated_at": "Wed, 09 Jan 2013 10:25:27 +0000", "message": "API method not found.", "data": null }

Update Nov 19, 2012 The unofficial api documentation at http://tijn.bo.lt/pinterest-api is gone, along with their entire website. I'm leaving the link in this post because it may come back online. Still no word from Pinterest to developers on their api status.

Update May 22, 2012 Pinterest has still not provided a public api. People are connecting to the api endpoints as the iPhone user agent, which is available to the iOS app

Update Apr 17, 2012 Thanks to tijn, we have unofficial version 1(now v2) Pinterest api docs, and reports that only read endpoints are currently available so RSS style feeds are possible within rate limits.

Update Apr 3, 2012 The unofficial Facebook group has some quality info on it and several people asking questions and posting fairly useful responses

Answer 1

There is no Official API Docs available for Pinterest as of today.

But there is the unofficial documentation for v2 here: http://tijn.bo.lt/pinterest-api

Answer 2

It seems that https://api.pinterest.com/v3/pins/jphellemons/

gives this message:

{
    "status": "failure", 
    "code": 2, 
    "host": "ngapi-10430284",  
    "generated_at": "Wed, 26 Jun 2013 14:56:44 +0000", 
    "message": "Authentication failed.", 
    "data": null
}

and url https://api.pinterest.com/v3/pins/ gives

{
    "status": "failure", 
    "code": 5, 
    "host": "ngapi-70bcb1cc", 
    "generated_at": "Wed, 26 Jun 2013 15:01:07 +0000", 
    "message": "Method not allowed", 
    "data": "405 Method Not Allowed"
}

So the upcoming API will be at that url I guess. Just authenticate with oAuth I guess. Because they hired John Yi recently

• http://allthingsd.com/20130612/the-pinterest-api-is-coming-head-of-marketing-developer-partnerships-joins-up/
• http://www.businessinsider.com/pinterest-hires-john-yi-to-launch-api-2013-6

if you cannot wait for the official api: http://pinterestapi.co.uk/

update 18 june http://readwrite.com/2013/06/18/the-disappointing-tale-of-pinterests-long-awaited-api#awesm=~oeF8IxscKLvPhN

update 31 july http://allthingsd.com/20130731/about-that-pinterest-api-its-not-ready-yet/

Answer 3

As of June 11, 2012 there is no officially released or documentation API for Pinterest. A Pinterest support page has a link to a form to be notified when it is officially released.

Answer 4

Check Pinterest API for a scraper for the time being.