Developer guidelines

Our mission

  • At Pinterest, our mission is to bring everyone the inspiration to create a life they love. As a developer, you can play an important role in making that happen. These are guidelines for what we do and don’t allow when building Pinterest-related apps and services. At a high level, please make sure you:

    • Follow our rate limits and don’t spam Pinterest.
    • Be open about the functions and features of your service.
    • In general, only use API data to help users succeed on Pinterest.
    • Respect our open endpoints and only use supported APIs to access Pinterest.

Our tools

  • We currently provide the following tools for developers:

    • Developer Features (widgets such as the “Save it” button, or any Pinterest tag);
    • Our API; and
    • Related tools, such as Pin publication and scheduling utilities.

Our use cases

  • We currently provide the API and other developer tools for two categories of integrations:

  • Consumer

    • These are direct-to-consumer integrations that bring everyone the inspiration to create a life they love.
    • Developers can apply for and create direct-to-consumer integrations directly through our developers page.
  • Marketing and Advertising

    • In contrast to direct-to-consumer integrations, these integrations are intended to be between Pinterest and marketers, advertisers, businesses, or individuals with financial motivations for marketing purposes.
    • This includes (but isn’t limited to) services that are meant to help marketers, advertisers or digital publishers (e.g. bloggers) report on, manage, distribute or optimize the digital marketing for paid or organic media.
    • If you are planning to use our API for one of these purposes or are unsure if this is relevant to you, you can start by learning more about our Pinterest Partners program, or apply for an integration directly through our developers page.

Accessing APIs

  • When you're accessing information from our APIs:

    • Maintain data accuracy. For example, if someone deletes a Pin from their board, you must delete it too.
    • Provide people with clear, conspicuous ways to share content on Pinterest. For example, if you use Pin data for personalization or recommendations, make it easy for people to save content back to Pinterest.
    • Don’t use content from Pinterest to target people with advertising outside of Pinterest, whether directly or bundled with third party data.  For example, do not bundle or sell content or data from Pinterest on other advertising networks, via data brokers, or through any other advertising or monetization services.

Publishing content or reporting

  • When you're reporting, publishing content or taking actions on a user’s behalf:

    • Link Pins back to their source or Pin URLs. Also, make sure it’s clear that a Pin’s image and data come from Pinterest.
    • Don’t cover or obscure content from Pinterest.
    • Don’t create new content from Pins that can be distributed on your app or service.
    • Let people know and agree to anything you do on their behalf, like adding content to Pinterest, changing their Pinterest profile, or following and unfollowing profiles or boards.

Providing an advertising service

  • If you use information from any Pinterest API to provide an advertising service, follow the guidelines above as well as our Ad Data Terms and Advertising guidelines, and also do the following:

    • Don't reverse engineer our targeting options.
    • If you report last-click attribution metrics, next to them with equal prominence you must show multi-touch metrics that divide attribution equally among each attributed service.
    • Clearly and separately show the fees you charge for Pinterest advertising and the fees we charge (both the absolute amount and by our billing metrics, like CPM or CPC), and don't combine your fees with ours.

    To be respectful of people's accounts while providing an advertising service:

    • Only access someone's account with their permission.
    • Only use information from their account to provide services to them.
    • Don't combine their account information with information from other people's accounts or other services.
    • Don't use information from our API except to serve and evaluate the performance of that person's ads on Pinterest.
    • Don't share information from our API with a third party, including another advertising service (it's okay to share with the person whose account it's from).

    If you provide audience onboarding as part of your advertising service, you must comply with the user consent obligations and data restrictions in the Ad Data Terms and Advertising guidelines. If advertisers will use data you’ve provided to them for online behavioral advertising you’ll also need to:

    • Give clear and prominent notice to everyone you collect data from letting them know that their information will be shared with third parties for online behavioral advertising.
    • Give instructions on how to opt out of the use of their information for online behavioral advertising, through the AdChoices website
    • Don't send us information about people who've opted out.
    • Regularly update data to remove people who've opted out.