Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Organic analytics

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.

Features supported

  • 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

Before getting started

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).
For detailed instructions on how to claim your website, see claim your website.

Prerequisites

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.

Basic metric definitions

To get a full list of supported metrics and its definitions you can call our resource endpoint
GET
Get available metrics' definitions
. Filter by category = “Organic” to only see metrics available for organic Pins.
You can also review our page on metrics glossary.

Overview of organic analytic options

overview of organic analytics options table
Endpoint nameScopeDescription
Get user account analyticsUser account/business
GET
Get user account analytics
High level summary at the account level, over a date range
Get user account top pins analyticsTop 50 Pins
GET
Get user account top pins analytics
Show pin level metrics for the top 50 pins over a date range
Get user account top video pin analyticsTop 50 video Pins
GET
Get user account top video pins analytics
Show pin level metrics for the top 50 video pins over a date range
Get pin analyticsSingle Pin
GET
Get Pin analytics
Get metrics for a single Pin ID over a date range
Get multiple pin analyticsMultiple Pins
GET
Get multiple Pin analytics
Get metrics for multiple Pin IDs over a date range
pin_metrics
param on
GET
List Pins
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.
Pin metrics
may be referred to as
Pin stats
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

  • GET
    Get user account analytics
  • GET
    Get user account top pins analytics
  • GET
    Get user account top video pins analytics
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

  • GET
    Get Pin analytics
  • GET
    Get multiple Pin analytics
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
GET
Get multiple Pin analytics
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
GET
Get Pin
GET
List Pins
and
GET
List Pins on board
. This option is useful if
  1. You'd like to fetch Pin metadata and performance metrics at the same time
  2. 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.

Additional resources

  • Help Center: Review your Pin stats
Was this page helpful?