Understanding our access tiers
The Pinterest API v5 significantly increases the scope of what is possible for you to create as a developer. If approved for API use, your app receives Trial access, which is best for exploring our API features. If you want to offer Pinterest capabilities to your users, we recommend upgrading to Standard access to get the full functionality that our API offers.
There are a few notable differences between Trial and Standard access which are detailed below.
access tiers table| Activity Type | in Trial Access | in Standard Access |
|---|
| Pin Analytics | Yes | Yes |
| Reading ads | Yes | Yes |
| Reading audiences | Yes | Yes |
| Reading boards | Yes | Yes |
| Reading Pins | Yes | Yes |
| Reading catalogs | Yes | Yes |
| Creating ads | Yes | Yes |
| Creating audiences | Yes | Yes |
| Creating boards | Yes (visible only to creator) | Yes |
| Creating Pins | Yes (visible only to creator) | Yes |
| Creating catalogs | Yes | Yes |
| Rate limits | Daily limits based on rate limit category. Please see the section on Rate
Limits. | Increased rate limits based on activity. Please see the section on Rate
Limits. |
Differences between Trial and Standard access
The most notable differences between Trial and Standard access are the overall available rate limits and behavior of Pins and Boards created.
The rate limits applicable for your app depend on the scope the endpoints you use fall under. As a general rule, Standard access offers higher rate limits than Trial access. If you are wanting to use Pinterest features in your production environment, we recommend upgrading to Standard access.
Pins and Boards created with Trial access
We understand that testing our API shouldn't mean you have to impact your existing Pinterest profile. That's why all Pins and Boards created with Trial access are only visible to their creator as Sandbox entities.
Read more on our API Sandbox and other supported capabilities. Upgrade your app to Standard access
If you've created an app with Trial access and are ready to build a product for more users, you should upgrade to Standard access. To ensure your app gets approved for Standard access make sure to prep the following:
Prepare a video recording of your app completing an action using the Pinterest API. We will review to verify that you are sending users through the
OAuth flow appropriately and not storing any sensitive information.
If you are the only intended user of the Pinterest API, we will still require a video recording of the OAuth flow. We accept screen recordings of calls on your terminal or through tools such as Postman.
If you are the only intended user of the Pinterest API, we will still require a video recording of the OAuth flow. We accept screen recordings of calls on your terminal or through tools such as Postman.
Once you've prepped your materials for Standard access, take the following steps to submit your request:
Select Upgrade on the app card. This button will only be visible for apps eligible for upgrade.
Verify the information you previously submitted about your app. This includes details on your use case and link to your privacy policy.
Upload a video demo of your app.
Submit your request.
Standard upgrade requests are reviewed regularly. You will receive an email notification once a decision has been made on your app.
Why requests may get denied
Privacy policy is inaccurate or not accessible.
App description is incomplete or unclear.
Demo video does not show the authentication flow.
Demo does not demonstrate an approved user authorization flow.
The compliant way for an app to authenticate a user is by obtaining an
OAuth access token. If you use other methods, such as collecting user login credentials or Pinterest session cookies, your upgrade request may be denied.
Demo video does not show live Pinterest integration.
Getting support with your application status
If you want to appeal a denial, submit a ticket in our Help Center. Please allow a few days for teams to review your access requests before following up on your app's overall status.