Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Ads overview

The Pinterest API (v5) enables advertisers to manage ads on Pinterest. This includes running ad campaigns, setting up targeting, and reporting on campaign performance.

Before you begin

  • Pinterest Ads are only available in select countries
  • You need to have Business Access enabled on your account to use the API
To start advertising, the user will need to:
  • Set up a business account
  • Create an ad account
  • Agree to the Pinterest Advertising Services Agreement
  • Set up a business profile and billing
Not all of these steps can be accomplished via the API, so for some of them, you will need to redirect the user to Pinterest. See Managing Ads

Overview of Ads

Ads Overview
The image above illustrates the strict parent-child relationships between the different components of our ad system. Each entity must be contained inside the other.
To learn about how these concepts fit in the context of user accounts and pins, please read about Pinterest Entities.
To learn more about the definitions of campaigns, ad groups, and ads, please read this Help Center article.
To start creating ads:
  1. Make sure your account has business access
  2. Create a campaign
  3. Create ads Managing Ads

Analytics & reporting

To use the API for ad performance and reporting, see Ads Reporting section.
Was this page helpful?