Track Pinterest ad account metrics

This tutorial will walk you through how to use the Pinterest API to monitor your ad campaign performance.

Step 1: Get your Pinterest ad account ID

Pinterest organizes its ad analytics by ad account. In order to fetch your metrics, you will first need to know your ad account ID. We’ll use the /v5/ad_accounts endpoint to fetch your accounts. Try it using the form below. Your ad account ID should be a big number, like 549763711438.

List Pinterest ad accounts

Please fill in any necessary fields and click Run.

GET

Preview

View the API data, get a live Google Sheet dashboard

id
name
country
currency
    
    
    

Get a live Google Sheet

Export your data to a google sheet, with the SyncWith Addon, or download to CSV

Automatically updated

Add data sources

Build reports & dashboards

Step 2: Fetch Pinterest paid ad performance metrics

Using your ad account ID from the previous step, we can now fetch metrics using the /v5/ad_accounts/{ad_account_id}/analytics endpoint. Try it using the form below.

Get Pinterest Ad Account Analytics

Please fill in any necessary fields and click Run.

GET

Preview

View the API data, get a live Google Sheet dashboard

TOTAL_IMPRESSION_USER
TOTAL_CLICKTHROUGH
DATE
AD_ACCOUNT_ID
SPEND_IN_DOLLAR
     
     
     

Get a live Google Sheet

Export your data to a google sheet, with the SyncWith Addon, or download to CSV

Automatically updated

Add data sources

Build reports & dashboards

The example above only fetched a small set of metrics, and broke out responses by day. To learn the complete set of fields on which you can report, please consult Pinterest’s API documentation.
💡
If you just want totals, set granularity to TOTAL. You could also try HOUR, WEEK or MONTH. To report on individual ads, try adding AD_ID to the list of columns.