Pinners are in a unique mindset on Pinterest in that they are seeking, but undecided.
Understanding your Pinner audience and organic Pin performance is vital in turning inspiration to action. This
article is for developers building analytics experiences for users, creator platforms, agencies, and brands who
want to measure organic performance. We offer multiple options for fetching organic performance analytics within
the Pinterest API - this guide will help you figure out which option is best for your use case.
There is a separate guide for developers interested in building support for ads reporting.
90 day look back on organic reporting for user accounts and Pins
Lifetime organic reporting for most Pins
List of a users top 50 image and/or video Pins
Content on Pinterest is in the form of Pins. All ads originate from an organic Pin. The reporting endpoints covered in this guide are only for organic Pins, any new performance a Pin receives once its been promoted will be reported on in our ad analytic endpoints.
Benefits to claiming your website
Users can claim their website to get access to analytics for the Pins they publish as
well as analytics on Pins other people publish which link to their site. We recommend people claim their
website(s) to get a deeper understanding of how Pinners are engaging with their content.
You can claim more than one website per Pinterest account.
Each website must be at a second-level domain (example.com), subdomain (ads.example.com) or subpath domain (example.com/uk).
Some analytics are only available if the user has a business account. To get the most of
our API, we recommend users to convert their account to Business.
To get a full list of supported metrics and its definitions you can call our resource endpoint . Filter by category = “Organic” to only see metrics available for organic Pins. Overview of organic analytic options
overview of organic analytics options table| Endpoint name | Scope | Description |
|---|
| Get user account analytics | User account/business | High level summary at the account level, over a date range |
| Get user account top pins analytics | Top 50 Pins | Show pin level metrics for the top 50 pins over a date range |
| Get user account top video pin analytics | Top 50 video Pins | Show pin level metrics for the top 50 video pins over a date range |
| Get pin analytics | Single Pin | Get metrics for a single Pin ID over a date range |
| Get multiple pin analytics | Multiple Pins | Get metrics for multiple Pin IDs over a date range |
param on and other Pin endpoints | Available for single or multiple Pins | Optional param to include 90d and lifetime metrics when fetching Pin metadata via endpoints
like Get Pin, List Pins and List Pins on board. may be referred to as in help center articles. If Pin was created before 2023-03-20 lifetime metrics will
only be available for Video and Idea Pin formats. Lifetime metrics are available for all Pin
formats since then. |
Summary analytics endpoints
These endpoints are useful for providing a high level snapshot of performance trends and
surfacing top performing Pins. We have separate endpoints for seeing top video Pins versus all Pins as the
metrics available and the sorting options are different.
Detailed Pin analytics endpoints
Our dedicated Pin analytics endpoints are good for getting detailed Pin level metrics across a date
range, if you know the specific Pin IDs you'd like to check in advance. The new endpoint provides our most performant option for fetching these metrics at scale and allows you to request Pin metrics for up to 100 Pin IDs at once. "pin_metrics" parameter on Pins endpoints
The final option allows you to return fixed summary metrics (rolling 90 day and all time
performance) when calling other Pin metadata endpoints, such as and . This option is useful if You'd like to fetch Pin metadata and performance metrics at the same time
You don't know the specific Pin IDs you want to fetch in advance
The rolling summary metrics (one day, 7 day, 30 day, etc) are unique to this method of fetching and not available in other analytics endpoints. There are also some caveats on lifetime metrics available through this method, be sure to review the API reference for the endpoint you are calling.