Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
pins

Get multiple Pin analytics

This endpoint is currently in beta and not available to all apps. Learn more.

Get analytics for multiple pins owned by the "operation user_account" - or on a group board that has been shared with this account.

  • The maximum number of pins supported in a single request is 100.
  • By default, the "operation user_account" is the token user_account.

Optional: Business Access: Specify an ad_account_id (obtained via List ad accounts) to use the owner of that ad_account as the "operation user_account". In order to do this, the token user_account must have one of the following Business Access roles on the ad_account:

  • For Pins on public or protected boards: Admin, Analyst.
  • For Pins on secret boards: Admin.

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.

get/pins/analytics

Query parameters

pin_idsPinterestLibIntegerFormatType[] required

List of Pin IDs.

start_datestring date required

Metric report start date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days back from today.

end_datestring date required

Metric report end date (UTC). Format: YYYY-MM-DD. Cannot be more than 90 days past start_date.

app_types'ALL' | 'MOBILE' | 'TABLET' | 'WEB'

Apps or devices to get data for, default is all.

metric_typesMultiPinsAnalyticsMetricTypesItem[] required

Pin metric types to get data for.

ad_account_idstring

Unique identifier of an ad account.

Response

The request has succeeded.

object required