Skip to main content

Python wrapper around the Pinterest developer APIs

Project description

Build Automation Test Coverage Python Versions Documentation Status Requirements Status Package Format Download Count Apache License 2.0


User friendly Python wrapper for the Pinterest developer APIs. This project is currently in very early development, with only a bare minimum of functionality, intended for some of my personal projects. I’m sharing it here in case someone finds the implementation helpful for their projects. Also, if anyone would like to contribute to this pet project feel free to fork it and send me pull requests for any changes you may like.

Comments, suggestions and bugs may be reported to the project maintainer

Full API documentation can be found on

Development Environment

In order to make use of this library, you will need a private access token to use when instantiating the main api class. This token authenticates you as a specific Pinterest user, giving access to that users’ profile, boards and pins. Typically this token would be generated by an application, but for testing purposes you can manually generate a token as described below. These steps are loosley based on the steps described on the Developer API under the “Postman” app section.

  1. Navigate to the Pinterest developer website and sign up for a free account:
  2. Under your personal profile, click the “Create App” button
  3. Name your app something appropriate like “My Test App”
  4. Once you create your test app, you’ll need to set up a “Platform”. Under the “Web” platform enter:
  5. Download and install Postman app for your platform:
  6. When you launch the app, you’ll be prompted to set up a free account. Either set up a free account or choose the “skip” link at the bottom of the page.
  7. Click the “new request” button on the wizard that pops up
  8. enter a name for your config (ie testing)
  9. click create collection and give it a name (ie my collection)
  10. click save
  11. in the “get” field enter a Pinterest rest api endpoint url like:
  12. under “Authorization -> type” select oauth 2.0
  13. under “Add authorization data to” select “request url”
  14. click “get new access token”
  15. fill out the form that pops up as follows:
  16. click request token
  17. you’ll be redirected to pinterest web site. Log in as yourself.
  18. when prompted, click “okay”to allow your test app access to your pinterest account
  19. click “use token”
  20. The token will appear in the collection configuration. Copy the token from there and paste it into your script or pass it along to the calls to fpins on the console.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

friendlypins-1.0.4-py2.py3-none-any.whl (21.0 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page