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"
      ]
    }
  ]
}
Example: "Total Engagement Rate" in October, compared to September.

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_rate
  • Paid 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_rate
  • Total Engagement

    The total number of engagements on your Pins. This includes saves, Pin clicks, outbound clicks, and carousel card swipes.

    pinterest_ads:total_engagement
  • Paid Engagement

    The total number of engagements on your Pins. This includes saves, Pin clicks, outbound clicks, and carousel card swipes

    pinterest_ads:paid_engagement
  • Total Conversions

    The total number of conversions during the analyzed period.

    pinterest_ads:total_conversions
  • Total Impressions

    Number of times your ads were viewed, including impressions earned.

    pinterest_ads:total_impressions
  • Paid Impressions

    The number of times your ads were on screen.

    pinterest_ads:paid_impressions
  • Total 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_ctr
  • CPM

    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:cpm
  • Total spend

    Total ad spend in the selected period.

    pinterest_ads:spend
  • Total Pins Saved

    Total number of times your ads were saved.

    pinterest_ads:repin
  • Pin Clicks

    Total number of pin clicks to access content on or off Pinterest.

    pinterest_ads:clicks
  • Clicks on Link

    Total number of clicks on the destination URL associated with your ad (paid and earned).

    pinterest_ads:link_clicks
  • Video 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_watchtime
  • 3-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_view
  • Videos 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_view
  • Videos 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_view
  • Videos 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_view
  • Videos 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_view
  • Videos 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_view
  • Total ROAS (Checkout)

    Average return on ad spend for checkout events. This metric may include conversions that are modeled.

    pinterest_ads:checkout_roas
  • Gross Pin clicks

    Unfiltered number of times someone clicks your ad (paid)

    pinterest_ads:clickthrough_1_gross
  • Earned Pin clicks

    Total number of Pin clicks from ads saved to another person's board

    pinterest_ads:clickthrough_2
  • Cost per lead

    Average cost per lead from your ads

    pinterest_ads:cost_per_lead
  • CPOC

    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_dollar
  • Earned CTR

    Earned Pin clicks divided by earned impressions

    pinterest_ads:ctr_2
  • Total ROAS (Custom)

    Average return on spend for custom events. This metric may include conversions that are modeled.

    pinterest_ads:custom_roas
  • CPCV (100%)

    Average cost per video view that was played until completion, including views that skipped ahead to this point

    pinterest_ads:ecpcv_in_dollar
  • CPCV (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_dollar
  • CPC

    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_dollar
  • CPE

    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_dollar
  • CPV

    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_dollar
  • Earned engagements

    Earned actions from ads saved to boards

    pinterest_ads:engagement_2
  • Paid 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_1
  • Earned 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_2
  • Earned impressions

    Total number of times your ad was viewed after being saved to another person's board

    pinterest_ads:impression_2
  • In-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_action
  • Leads

    The number of times your ad achieved lead conversions

    pinterest_ads:leads
  • Paid outbound clicks

    The total number of clicks to the destination URL associated with your ad

    pinterest_ads:outbound_click_1
  • Earned 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_2
  • Total 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_action
  • Total ROAS (Page visit)

    Average return on ad spend for page visit events. This metric may include conversions that are modeled.

    pinterest_ads:page_visit_roas
  • Completed quiz

    The number of quiz completed for a given ad

    pinterest_ads:quiz_completed
  • Quiz completion rate

    Percentage of people who completed quizzes after answering question 1

    pinterest_ads:quiz_completion_rate
  • Total Quiz Pin Result Opened

    The number of total results opened for all quizzes

    pinterest_ads:quiz_pin_result_open
  • Earned saves

    Number of times your ad was saved from another person's board

    pinterest_ads:repin_2
  • Paid save rate

    Paid saves divided by paid impressions

    pinterest_ads:repin_rate
  • Average Showcase Card Closeups

    The number of total closeups for all cards divided by pin clicks

    pinterest_ads:showcase_average_subpage_closeup_per_session
  • Total Showcase Card Thumbnail Swipe Backward

    The number of total swipes backward on card thumbnails

    pinterest_ads:showcase_card_thumbnail_swipe_backward
  • Total Showcase Card Thumbnail Swipe Forward

    The number of total swipes forward on card thumbnails

    pinterest_ads:showcase_card_thumbnail_swipe_forward
  • Total Showcase Title Pin Outbound Clicks

    The number of total outbound clicks from title pin

    pinterest_ads:showcase_pin_clickthrough
  • Total Showcase Card Outbound Clicks

    The number of total outbound clicks from all cards

    pinterest_ads:showcase_subpage_clickthrough
  • Total Showcase Card Closeups

    The number of total closeups for all cards

    pinterest_ads:showcase_subpage_closeup
  • Total Showcase Card Impressions

    The number of total impressions for all cards

    pinterest_ads:showcase_subpage_impression
  • Total Showcase Card Saves

    The number of total saves for all cards

    pinterest_ads:showcase_subpage_repin
  • Total Showcase Card Swipe Forward

    The number of total swipes forward for all cards

    pinterest_ads:showcase_subpage_swipe_left
  • Total Showcase Card Swipe Backward

    The number of total swipes backward for all cards

    pinterest_ads:showcase_subpage_swipe_right
  • Total Showcase Featured Pin Outbound Clicks

    The number of total outbound clicks from all featured pins

    pinterest_ads:showcase_subpin_clickthrough
  • Total Showcase Featured Pin Impressions

    The number of total impressions for all featured pins

    pinterest_ads:showcase_subpin_impression
  • Total Showcase Featured Pin Saves

    The number of total saves for all featured pins

    pinterest_ads:showcase_subpin_repin
  • Total Showcase Featured Pin Swipe Forward

    The number of total swipes forward for all featured pins

    pinterest_ads:showcase_subpin_swipe_left
  • Total Showcase Featured Pin Swipe Backward

    The number of total swipes backward for all featured pins

    pinterest_ads:showcase_subpin_swipe_right
  • Total 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_rate
  • Total 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_checkout
  • Total 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_rate
  • Total 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_dollar
  • Total 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_cart
  • Total 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_checkout
  • Total 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_dollar
  • Total 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_lead
  • Total 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_signup
  • Total 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_dollar
  • Total conversions (Custom)

    Total number of custom events resulting from interactions with your ad. This metric may include conversions that are modeled.

    pinterest_ads:total_custom
  • Total 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_rate
  • Total 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_dollar
  • Total 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_checkout
  • Total 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_dollar
  • Total 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_lead
  • Total 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_signup
  • Total 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_dollar
  • Total 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_visit
  • Frequency

    The average number of times each user saw your ad.

    pinterest_ads:total_impression_frequency
  • Reach

    Total number of unique users who saw your ads

    pinterest_ads:total_impression_user
  • Total conversions (Lead)

    Total number of lead events resulting from interactions with your ad. This metric may include conversions that are modeled.

    pinterest_ads:total_lead
  • Total 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_rate
  • Offline conversions (Checkout)

    Total number of offline checkout events resulting from clicks on your ad

    pinterest_ads:total_offline_checkout
  • Total 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_visit
  • Total 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_rate
  • Total save rate

    Total saves divided by total impressions

    pinterest_ads:total_repin_rate
  • Total 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_rate
  • Total conversions (Signup)

    Total number of signup events resulting from interactions with your ad. This metric may include conversions that are modeled.

    pinterest_ads:total_signup
  • Total 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_rate
  • Total 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_dollar
  • Total 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_rate
  • Video 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_views
  • Total video starts

    Total number of times your video ad started playing (paid and earned)

    pinterest_ads:total_video_p0_combined
  • Total 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_cart
  • Total 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_rate
  • Total 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_checkout
  • Total 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_dollar
  • Total 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_lead
  • Total 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_signup
  • Total 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_dollar
  • Total 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_rate
  • Web 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_checkout
  • Web 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_dollar
  • Web 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_checkout
  • Web 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_dollar
  • Web 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_checkout
  • Web 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_dollar
  • Web sessions

    Total number of sessions loaded in a browser

    pinterest_ads:total_web_sessions
  • Web 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_checkout
  • Web 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_dollar
  • Earned 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_2
  • Video length

    Runtime of your video ad

    pinterest_ads:video_length
  • Earned 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_2
  • Earned 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_2
  • Earned 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_2
  • Earned 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_2
  • Earned 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_2
  • Earned 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_2
  • Earned 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_2
  • Web 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_action
  • Web ROAS (Checkout)

    Average return on ad spend for web checkout events. This metric may include conversions that are modeled.

    pinterest_ads:web_checkout_roas
  • Paid web sessions

    Number of paid sessions loaded in a browser

    pinterest_ads:web_sessions_1
  • Earned web sessions

    Number of earned sessions loaded in a browser

    pinterest_ads:web_sessions_2
  • Revenue

    Total revenue influenced by your Pins and ads.

    pinterest_ads:revenue
  • Additions to cart

    Number of times people added your products to their cart after interacting with your Pins.

    pinterest_ads:additions_to_cart
  • Page visits

    Number of times people visited your website after seeing your content on Pinterest.

    pinterest_ads:page_visits
  • Purchase completions

    Total number of purchase completions resulting from your Pins and ads.

    pinterest_ads:purchase_completions
  • Average order value

    Average value of purchase completions resulting from your Pins and ads.

    pinterest_ads:average_order_value
  • Buyers

    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_day
  • Clicks and CTR by time

    Pin Click Performance and CTR over the analyzed period

    pinterest_ads:clicks_and_ctr_by_day
  • CPM and Impressions by time

    Impression and CPM performance over the analyzed period.

    pinterest_ads:cpm_and_impressions_by_day
  • Spend 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_campaigns
  • Featured ads

    Ad performance summary for the analyzed period.

    pinterest_ads:top_ads
  • Featured ad groups

    Ad group performance summary for the analyzed period.

    pinterest_ads:top_ad_groups
  • Keywords

    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.