Pinterest Ads
Vendor/Partner | |
|---|---|
Version | v5 |
API Documentation | |
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 |
|
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_accountmust 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 ManagerIf 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 |
|---|---|