pinterest api documentation [closed]

I want to offer an update on the current status of the Pinterest API.

There is still no public API available. Pinterest also does not seem to be approving anyone who applies for access on their site.

As of right now, the endpoints of the Pinterest v3 API are almost complete although there is no official documentation. Below is a brief list of the types of endpoints that are available:

https://api.pinterest.com/v3/users/
https://api.pinterest.com/v3/search/
https://api.pinterest.com/v3/domains/
https://api.pinterest.com/v3/categories/
https://api.pinterest.com/v3/oauth/
https://api.pinterest.com/v3/boards/
https://api.pinterest.com/v3/pins/
https://api.pinterest.com/v3/batch/
https://api.pinterest.com/v3/login/

You may discover many sub-endpoints to each of the endpoint above. I do have a list of many available endpoints, but since they’re not public, I’m not going to post them here (Hint: Most of them are easy to guess). All of the above endpoints require an access_token parameter except for the login endpoint.

To generate a valid access_token, the developer will need to be granted access to the API by Pinterest which we all know is currently almost impossible.

Another option is to write a script to simulate a log in action to the /v3/login endpoint with your Pinterest username and password. It will return an access_token if request is successful. I’m not going into details about how this is done, as this is never meant to be part of the public API and is meant only for users logging into Pinterest on their mobile app.

However, you can generate access token for your Pinterest account for existing apps that have been approved by Pinterest such as the Pinterest for iPhone:

https://www.pinterest.com/oauth/?consumer_id=1431594&response_type=token

You will see that the access_token is returned in the hash of the URL. You can now use this access_token to play with the endpoints and it is valid for one month. Have fun discovering them!

Endpoints that are public and do not require access_token:

Pins with a known username and known board name:

https://api.pinterest.com/v3/pidgets/boards/[username]/[board_name]/pins/

Pins with a known username:

https://api.pinterest.com/v3/pidgets/users/[username]/pins/

Retrieving the information of (a) particular pin(s):

http://api.pinterest.com/v3/pidgets/pins/info/?pin_ids=521150988102375972,10133167885969245

Count the number of pins:

http://api.pinterest.com/v1/urls/count.json?url=[urlEncodedLink]

Leave a Comment