Metrics
Pinterest Ads metrics via API
Your customer connects their Pinterest Ads account and your product queries 140 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "pinterest_ads:engagement_rate",
"component": "number_v1",
"metrics": [
"engagement_rate"
]
}
]
}More Pinterest Ads request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Clicks and Repins by Time
This graph describes the number of pin clicks and pins saved over time.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "pinterest_ads:clicks_saves_by_day",
"component": "chart_v1",
"metrics": [
"clickthrough_1",
"repin_1"
],
"dimensions": [
"day"
]
}
]
}Table
Featured campaigns
Campaigns that had the greatest impact on your audience, during the period analyzed.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "pinterest_ads:top_campaigns",
"component": "datatable_v1",
"metrics": [
"repin_1",
"engagement_1",
"ctr"
],
"dimensions": [
"campaign_name"
]
}
]
}Number
Paid Engagement Rate
The engagement rate is defined as the paid engagements (click, save, closeup,carousel sideswipe) divided by the paid impressions.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "pinterest_ads:paid_engagement_rate",
"component": "number_v1",
"metrics": [
"eengagement_rate"
]
}
]
}Numbers
132 metrics
Total Engagement Rate
Is the effective engagement rate, defined as the sum of all engagements (click, save, closeup, carousel sideswipe), whether paid or organic, divided by total impressions (both paid and organic).
pinterest_ads:engagement_ratePaid Engagement Rate
The engagement rate is defined as the paid engagements (click, save, closeup,carousel sideswipe) divided by the paid impressions.
pinterest_ads:paid_engagement_rateTotal Engagement
The total number of engagements on your Pins. This includes saves, Pin clicks, outbound clicks, and carousel card swipes.
pinterest_ads:total_engagementPaid Engagement
The total number of engagements on your Pins. This includes saves, Pin clicks, outbound clicks, and carousel card swipes
pinterest_ads:paid_engagementTotal Conversions
The total number of conversions during the analyzed period.
pinterest_ads:total_conversionsTotal Impressions
Number of times your ads were viewed, including impressions earned.
pinterest_ads:total_impressionsPaid Impressions
The number of times your ads were on screen.
pinterest_ads:paid_impressionsTotal CTR
CTR indicates the total number of clicks on the pins, compared to the total number of times they were viewed (impressions).
pinterest_ads:total_ctrCPM
The cost per one thousand impressions, reported in a value based on the currency specified in the advertiser’s profile’s currency field (or in dollars if no currency is specified).
pinterest_ads:cpmTotal spend
Total ad spend in the selected period.
pinterest_ads:spendTotal Pins Saved
Total number of times your ads were saved.
pinterest_ads:repinPin Clicks
Total number of pin clicks to access content on or off Pinterest.
pinterest_ads:clicksClicks on Link
Total number of clicks on the destination URL associated with your ad (paid and earned).
pinterest_ads:link_clicksVideo Average Watchtime
The average length of time your video ad (or repins of your video ad) was played, defined as (number of seconds played)/(number of times video began playing), reported in seconds.
pinterest_ads:video_average_watchtime3-Second Video Views
The number of times your video ad played continuously for 3 seconds while at least 50% in view.
pinterest_ads:video_3s_viewVideos played at 25%
Number of times your video ad (or repins of your video ad) reached 25% of its length, including views that skipped ahead to this point.
pinterest_ads:video_25_viewVideos played at 50%
Number of times your video ad (or repins of your video ad) reached 50% of its length, including views that skipped ahead to this point.
pinterest_ads:video_50_viewVideos played at 75%
Number of times your video ad (or repins of your video ad) reached 75% of its length, including views that skipped ahead to this point.
pinterest_ads:video_75_viewVideos played at 95%
Number of times your video ad (or repins of your video ad) reached 95% of its length, including views that skipped ahead to this point.
pinterest_ads:video_95_viewVideos played at 100%
Number of times your video ad (or repins of your video ad) reached 100% of its length, including views that skipped ahead to this point.
pinterest_ads:video_100_viewTotal ROAS (Checkout)
Average return on ad spend for checkout events. This metric may include conversions that are modeled.
pinterest_ads:checkout_roasGross Pin clicks
Unfiltered number of times someone clicks your ad (paid)
pinterest_ads:clickthrough_1_grossEarned Pin clicks
Total number of Pin clicks from ads saved to another person's board
pinterest_ads:clickthrough_2Cost per lead
Average cost per lead from your ads
pinterest_ads:cost_per_leadCPOC
CPOC is the cost for each click that directs a user away from Pinterest, usually to the advertiser's website. It is an important metric for campaigns focused on external traffic.
pinterest_ads:cost_per_outbound_click_in_dollarEarned CTR
Earned Pin clicks divided by earned impressions
pinterest_ads:ctr_2Total ROAS (Custom)
Average return on spend for custom events. This metric may include conversions that are modeled.
pinterest_ads:custom_roasCPCV (100%)
Average cost per video view that was played until completion, including views that skipped ahead to this point
pinterest_ads:ecpcv_in_dollarCPCV (95%)
Average cost per video that was played until 95% of its length, including views that skipped ahead to this point
pinterest_ads:ecpcv_p95_in_dollarCPC
CPC represents the cost for each click received on Pinterest ads. It is calculated by dividing the total campaign cost by the total number of clicks generated on the ads.
pinterest_ads:ecpc_in_dollarCPE
CPE measures the average cost for each engagement earned on Pinterest ads, such as clicks on Pins, saves, or interactions with promoted videos.
pinterest_ads:ecpe_in_dollarCPV
CPV indicates the cost for each complete view of a video promoted on Pinterest. It is calculated by dividing the total campaign cost by the total number of completed video views.
pinterest_ads:ecpv_in_dollarEarned engagements
Earned actions from ads saved to boards
pinterest_ads:engagement_2Paid Idea Pin product tag visits
The number of times someone taps on a product tagged within an Idea Pin you promoted
pinterest_ads:idea_pin_product_tag_visit_1Earned Idea Pin product tag visits
The number of times someone taps on a product tagged within an Idea ad saved to another person's board
pinterest_ads:idea_pin_product_tag_visit_2Earned impressions
Total number of times your ad was viewed after being saved to another person's board
pinterest_ads:impression_2In-app CPA (Checkout)
In-app CPA for checkout refers to the cost per acquisition of a customer who completes checkout directly in the Pinterest app. It is calculated by dividing the total campaign cost by the total number of checkouts completed within the app.
pinterest_ads:inapp_checkout_cost_per_actionLeads
The number of times your ad achieved lead conversions
pinterest_ads:leadsPaid outbound clicks
The total number of clicks to the destination URL associated with your ad
pinterest_ads:outbound_click_1Earned outbound clicks
The total number of clicks to the destination URL associated with your ad saved to another person's board
pinterest_ads:outbound_click_2Total CPA (Page visit)
Total CPA for page visit indicates the cost for each visit generated to the advertiser's website from Pinterest ads. This value is obtained by dividing the total cost of the campaign by the total number of page visits recorded.
pinterest_ads:page_visit_cost_per_actionTotal ROAS (Page visit)
Average return on ad spend for page visit events. This metric may include conversions that are modeled.
pinterest_ads:page_visit_roasCompleted quiz
The number of quiz completed for a given ad
pinterest_ads:quiz_completedQuiz completion rate
Percentage of people who completed quizzes after answering question 1
pinterest_ads:quiz_completion_rateTotal Quiz Pin Result Opened
The number of total results opened for all quizzes
pinterest_ads:quiz_pin_result_openEarned saves
Number of times your ad was saved from another person's board
pinterest_ads:repin_2Paid save rate
Paid saves divided by paid impressions
pinterest_ads:repin_rateAverage Showcase Card Closeups
The number of total closeups for all cards divided by pin clicks
pinterest_ads:showcase_average_subpage_closeup_per_sessionTotal Showcase Card Thumbnail Swipe Backward
The number of total swipes backward on card thumbnails
pinterest_ads:showcase_card_thumbnail_swipe_backwardTotal Showcase Card Thumbnail Swipe Forward
The number of total swipes forward on card thumbnails
pinterest_ads:showcase_card_thumbnail_swipe_forwardTotal Showcase Title Pin Outbound Clicks
The number of total outbound clicks from title pin
pinterest_ads:showcase_pin_clickthroughTotal Showcase Card Outbound Clicks
The number of total outbound clicks from all cards
pinterest_ads:showcase_subpage_clickthroughTotal Showcase Card Closeups
The number of total closeups for all cards
pinterest_ads:showcase_subpage_closeupTotal Showcase Card Impressions
The number of total impressions for all cards
pinterest_ads:showcase_subpage_impressionTotal Showcase Card Saves
The number of total saves for all cards
pinterest_ads:showcase_subpage_repinTotal Showcase Card Swipe Forward
The number of total swipes forward for all cards
pinterest_ads:showcase_subpage_swipe_leftTotal Showcase Card Swipe Backward
The number of total swipes backward for all cards
pinterest_ads:showcase_subpage_swipe_rightTotal Showcase Featured Pin Outbound Clicks
The number of total outbound clicks from all featured pins
pinterest_ads:showcase_subpin_clickthroughTotal Showcase Featured Pin Impressions
The number of total impressions for all featured pins
pinterest_ads:showcase_subpin_impressionTotal Showcase Featured Pin Saves
The number of total saves for all featured pins
pinterest_ads:showcase_subpin_repinTotal Showcase Featured Pin Swipe Forward
The number of total swipes forward for all featured pins
pinterest_ads:showcase_subpin_swipe_leftTotal Showcase Featured Pin Swipe Backward
The number of total swipes backward for all featured pins
pinterest_ads:showcase_subpin_swipe_rightTotal conversion rate (Add to cart)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_add_to_cart_conversion_rateTotal conversions (Checkout)
Total number of checkout events that resulted from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_checkoutTotal conversion rate (Checkout)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_checkout_conversion_rateTotal order value (Checkout)
Total value of checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_checkout_value_in_micro_dollarTotal click-through conversions (Add to cart)
The number of add to cart events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_add_to_cartTotal click-through conversions (Checkout)
Total number of checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_checkoutTotal click-through order value (Checkout)
Total value of checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_checkout_value_in_micro_dollarTotal click-through conversions (Lead)
Total number of lead events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_leadTotal click-through conversions (Signup)
Number of signup events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_signupTotal click-through order value (Signup)
Total value of signup events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_click_signup_value_in_micro_dollarTotal conversions (Custom)
Total number of custom events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_customTotal conversion rate (Custom)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_custom_conversion_rateTotal order value (Custom)
Total value of custom events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_custom_value_in_micro_dollarTotal engagement conversions (Checkout)
Total number of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.
pinterest_ads:total_engagement_checkoutTotal engagement order value (Checkout)
Total value of checkout events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.
pinterest_ads:total_engagement_checkout_value_in_micro_dollarTotal engagement conversions (Lead)
Total number of lead events resulting from engagement with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.
pinterest_ads:total_engagement_leadTotal engagement conversions (Signup)
Total number of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.
pinterest_ads:total_engagement_signupTotal engagement order value (Signup)
Total value of signup events resulting from engagements with your ad. Engagements includes saves, closeups, carousel swipes, collection secondary closeups, and collection secondary saves. This metric may include conversions that are modeled.
pinterest_ads:total_engagement_signup_value_in_micro_dollarTotal Idea Pin product tag visits
The number of times someone taps on a product tagged within an Idea Pin, paid and earned.
pinterest_ads:total_idea_pin_product_tag_visitFrequency
The average number of times each user saw your ad.
pinterest_ads:total_impression_frequencyReach
Total number of unique users who saw your ads
pinterest_ads:total_impression_userTotal conversions (Lead)
Total number of lead events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_leadTotal conversion rate (Lead)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_lead_conversion_rateOffline conversions (Checkout)
Total number of offline checkout events resulting from clicks on your ad
pinterest_ads:total_offline_checkoutTotal conversions (Page visit)
Total number of page visit events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_page_visitTotal conversion rate (Page visit)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_page_visit_conversion_rateTotal save rate
Total saves divided by total impressions
pinterest_ads:total_repin_rateTotal conversion rate (Website search)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_search_conversion_rateTotal conversions (Signup)
Total number of signup events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_signupTotal conversion rate (Signup)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_signup_conversion_rateTotal order value (Signup)
Total value of signup events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_signup_value_in_micro_dollarTotal conversion rate (Unknown)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_unknown_conversion_rateVideo views
Total number of times your video ad played continuously for at least 2 seconds while 50% visible (paid and earned)
pinterest_ads:total_video_mrc_viewsTotal video starts
Total number of times your video ad started playing (paid and earned)
pinterest_ads:total_video_p0_combinedTotal view-through conversions (Add to cart)
Total number of add to cart events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_add_to_cartTotal conversion rate (Category view)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_view_category_conversion_rateTotal view-through conversions (Checkout)
Total number of checkout events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_checkoutTotal view-through order value (Checkout)
Total value of checkout events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_checkout_value_in_micro_dollarTotal view-through conversions (Lead)
Total number of lead events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_leadTotal view-through conversions (Signup)
Number of signup events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_signupTotal view-through order value (Signup)
Total value of signup events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_view_signup_value_in_micro_dollarTotal conversion rate (Watch video)
The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period.
pinterest_ads:total_watch_video_conversion_rateWeb conversions (Checkout)
Total number of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_checkoutWeb order value (Checkout)
Total value of web checkout events resulting from interactions with your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_checkout_value_in_micro_dollarWeb click-through conversions (Checkout)
Total number of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_click_checkoutWeb click-through order value (Checkout)
Total value of web checkout events resulting from clicks on your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_click_checkout_value_in_micro_dollarWeb engagement conversions (Checkout)
Total number of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe). This metric may include conversions that are modeled.
pinterest_ads:total_web_engagement_checkoutWeb engagement order value (Checkout)
Total value of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe). This metric may include conversions that are modeled.
pinterest_ads:total_web_engagement_checkout_value_in_micro_dollarWeb sessions
Total number of sessions loaded in a browser
pinterest_ads:total_web_sessionsWeb view-through conversions (Checkout)
Total number of web checkout events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_view_checkoutWeb view-through order value (Checkout)
Total value of web checkout events resulting from views of your ad. This metric may include conversions that are modeled.
pinterest_ads:total_web_view_checkout_value_in_micro_dollarEarned 3s video views
The number of times your video ad played continuously for 3 seconds while 50% in view after being saved to another person's board
pinterest_ads:video_3sec_views_2Video length
Runtime of your video ad
pinterest_ads:video_lengthEarned video views
The number of times your video ad played continuously for 2 seconds while 50% in view after being saved to another person's board
pinterest_ads:video_mrc_views_2Earned video starts
Total number of times your video ad started playing after it was saved to another person's board
pinterest_ads:video_p0_combined_2Earned video played at 100%
Total number of times your video ad reached 100% of its length after it was saved to another person's board, including views that skipped ahead to this point
pinterest_ads:video_p100_complete_2Earned video played at 25%
Total number of times your video ad reached 25% of its length after it was saved to another person's board, including views that skipped ahead to this point
pinterest_ads:video_p25_combined_2Earned video played at 50%
Total number of times your video ad reached 50% of its length after it was saved to another person's board, including views that skipped ahead to this point
pinterest_ads:video_p50_combined_2Earned video played at 75%
Total number of times your video ad reached 75% of its length after it was saved to another person's board, including views that skipped ahead to this point
pinterest_ads:video_p75_combined_2Earned video played at 95%
Total number of times your video ad reached 95% of its length after it was saved to another person's board, including views that skipped ahead to this point
pinterest_ads:video_p95_combined_2Web CPA (Checkout)
Web CPA for checkout represents the cost per acquisition of a customer who completes checkout directly on the advertiser's website after clicking on an ad on Pinterest. It is calculated by dividing the total campaign cost by the total number of checkouts completed on the website.
pinterest_ads:web_checkout_cost_per_actionWeb ROAS (Checkout)
Average return on ad spend for web checkout events. This metric may include conversions that are modeled.
pinterest_ads:web_checkout_roasPaid web sessions
Number of paid sessions loaded in a browser
pinterest_ads:web_sessions_1Earned web sessions
Number of earned sessions loaded in a browser
pinterest_ads:web_sessions_2Revenue
Total revenue influenced by your Pins and ads.
pinterest_ads:revenueAdditions to cart
Number of times people added your products to their cart after interacting with your Pins.
pinterest_ads:additions_to_cartPage visits
Number of times people visited your website after seeing your content on Pinterest.
pinterest_ads:page_visitsPurchase completions
Total number of purchase completions resulting from your Pins and ads.
pinterest_ads:purchase_completionsAverage order value
Average value of purchase completions resulting from your Pins and ads.
pinterest_ads:average_order_valueBuyers
Total number of purchases resulting from interactions with your Pins and ads.
pinterest_ads:buyers
Charts
4 metrics
Clicks and Repins by Time
This graph describes the number of pin clicks and pins saved over time.
pinterest_ads:clicks_saves_by_dayClicks and CTR by time
Pin Click Performance and CTR over the analyzed period
pinterest_ads:clicks_and_ctr_by_dayCPM and Impressions by time
Impression and CPM performance over the analyzed period.
pinterest_ads:cpm_and_impressions_by_daySpend by time
Total amount spent over the period analyzed in the report.
pinterest_ads:spend_by_day
Tables
4 metrics
Featured campaigns
Campaigns that had the greatest impact on your audience, during the period analyzed.
pinterest_ads:top_campaignsFeatured ads
Ad performance summary for the analyzed period.
pinterest_ads:top_adsFeatured ad groups
Ad group performance summary for the analyzed period.
pinterest_ads:top_ad_groupsKeywords
Performance summary for the keywords associated with your ad groups.
pinterest_ads:top_keywords
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
