Developer guidelines

Our mission
  • At Pinterest, our mission is to help people discover and do what 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 that you:

Permitted use cases
  • We currently provide the following tools for developers:

    Our developer API should only be used for direct-to-consumer integrations that help people discover and do what they love. And, to avoid confusion with our Marketing Partners programme, we don’t allow marketing platforms to use our developer API. 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 optimise the digital marketing for paid or organic media.

    In short, you shouldn’t use our developer API if your integration is intended to be authenticated by marketers, advertisers, businesses or individuals with financial motivations for marketing purposes. You also can’t use our APIs to save, print or edit photos. If you are planning to use our API for one of these purposes or are unsure whether this is relevant to you, let us know before building out your integration.

     

Accessing APIs
  • When you're accessing information from our APIs:

  • 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.
Publishing content or reporting
  • When you're reporting, publishing content or taking actions on a user’s behalf:

Providing an advertising service
  • If you access our Ads API or use information from a Pinterest API to provide an advertising service, follow the guidelines above and also do the following:

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).