Breadcrumbs

Pinterest Ads

Overview


Vendor/Partner

Pinterest

Version

v5

API Documentation

Pinterest Ads API Docs

Sunset Date

None as of 01/02/2025

Channel(s)

Social

Refresh Time (CST)

7 am / Real Time

Default backfill

30 Days (7 Days for hourly breakdowns)

Alli Data Library

https://agencypmg.atlassian.net/wiki/s/-1529285079/6452/4c2832860aad97c77f44f8794b470d79af5ad2a7/_/images/icons/emoticons/check.png

Getting Started

Required Authorization

Limitations

  • The furthest back you can are allowed to pull data is 90 days before the current date in UTC time and the max time range supported is 90 days. https://developers.pinterest.com/docs/api/v5/#operation/ad_account/analytics

  • The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager

  • If the data is broken down by hour, Pinterest limits backfills to 8 days from the current date.

Define your Data

Understanding Pinterest metrics: https://developers.pinterest.com/docs/ads/ad-analytics-reporting/#Mapping%20API%20metrics%20to%20Ads%20Manager

Dimensions

Name

Description





Metrics

Name

Description