Metrics

Spotify Ads metrics via API

Your customer connects their Spotify Ads account and your product queries 50 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": "spotify_ads:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ],
      "dimensions": [
        "AD_ACCOUNT"
      ]
    }
  ]
}
Example: "Clicks" in October, compared to September.

More Spotify 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

Reach and Impressions over time

The number of unique users who received your ad and the number of times your ad was served 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": "spotify_ads:reach_impressions_by_day",
      "component": "chart_v1",
      "metrics": [
        "reach",
        "impressions"
      ],
      "dimensions": [
        "DAY"
      ]
    }
  ]
}

Table

Featured Ads

Your ads in the specified time period.

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": "spotify_ads:ads",
      "component": "datatable_v1",
      "metrics": [
        "reach",
        "impressions",
        "clicks",
        "completes",
        "completion_rate",
        "ctr",
        "e_cpm",
        "e_cpcl",
        "frequency",
        "spend"
      ],
      "dimensions": [
        "AD"
      ]
    }
  ]
}

Number

Ad Played Up To 100%

The number of ads served that was played to the end

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": "spotify_ads:completes",
      "component": "number_v1",
      "metrics": [
        "completes"
      ],
      "dimensions": [
        "AD_ACCOUNT"
      ]
    }
  ]
}

Numbers

37 metrics

  • Clicks

    The number of impressions in which your ad was clicked

    spotify_ads:clicks
  • Ad Played Up To 100%

    The number of ads served that was played to the end

    spotify_ads:completes
  • Ad Played Up To 100% Rate

    The percentage of ads played to completion

    spotify_ads:completion_rate
  • Click Through Rate

    The percentage of ads that were clicked

    spotify_ads:ctr
  • CPM

    Average Cost Per Thousand Impressions (CPM) is the average amount paid by the advertiser for every 1,000 impressions of the ad, regardless of whether or not all of them are heard.

    spotify_ads:e_cpm
  • CPCL

    Average Cost Per Thousand Completed Listens (ACPL) is the average amount paid for every 1,000 complete listens to your ad. This metric applies exclusively to active audio campaigns set up with the ACPL model.

    spotify_ads:e_cpcl
  • Ad Played Up To 25%

    The number of users who listened or viewed 25% of the ad's total length

    spotify_ads:first_quartiles
  • Frequency of Ads Served

    The average number of times each person heard or viewed your ad

    spotify_ads:frequency
  • Impressions

    The number of times an ad has been served

    spotify_ads:impressions
  • Ad Played Up To 50%

    The number of users for which the ad played to the midpoint of the ad's total length

    spotify_ads:midpoints
  • Off Spotify Impressions

    The number of ads served off of Spotify

    spotify_ads:off_spotify_impressions
  • Paid Listens

    The number of listens for a CPCL campaign where a user did NOT skip the ad

    spotify_ads:paid_listens
  • Frequency of Paid Listens

    The average frequency for listens on a CPCL campaign

    spotify_ads:paid_listens_frequency
  • Reach of Paid Listens

    Total number of unique users who listened to a paid ad in its entirety within a CPCL campaign.

    spotify_ads:paid_listens_reach
  • Reach of Ads Served

    The number of unique users who received your ad

    spotify_ads:reach
  • Amount Spent

    The total amount spent in this campaign

    spotify_ads:spend
  • Starts

    The number of times a user starts hearing/viewing your ad

    spotify_ads:starts
  • Skips

    The number of times a user skips an ad

    spotify_ads:skips
  • Ad Played Up To 75%

    The number of users who listened or viewed 75% of the ad's total length

    spotify_ads:third_quartiles
  • Unmutes

    The number of times a user unmutes an ad

    spotify_ads:unmutes
  • Video Expands

    The number of times someone tapped your ad to expand it

    spotify_ads:video_expands
  • Video Expand Rate

    The number ad expands divided by the number of impressions

    spotify_ads:video_expand_rate
  • Video Views

    The number of times your video played for at least 3 seconds

    spotify_ads:video_views
  • Average Streams per Listener

    The average number of times each listener streamed your content after seeing or hearing your ad.

    spotify_ads:streams_per_user
  • Average Streams per New Listener

    The average number of times each new listener streamed your content after seeing or hearing your ad.

    spotify_ads:streams_per_new_listener
  • Intent Rate

    The percentage of listeners who took actions showing intent to stream your content again in the future. Actions include saving your content (by tapping the + icon or “save”) or adding it to a playlist.

    spotify_ads:intent_rate
  • Listener Conversion Rate

    The percentage of listeners who streamed your content after seeing or hearing your ad.

    spotify_ads:conversion_rate
  • Listeners

    The number of unique Spotify users who streamed at least 30 seconds of the promoted content within 14 days of seeing or hearing your ad.

    spotify_ads:listeners
  • New Listener Streams

    The number of streams from new listeners who heard or saw your ad.

    spotify_ads:new_listener_streams
  • New Listeners

    The number of listeners who had not streamed your content in the 28 days before seeing or hearing your ad.

    spotify_ads:new_listeners
  • New Listeners Conversion Rate

    The percentage of new listeners who streamed your content after seeing or hearing your ad.

    spotify_ads:new_listener_conversion_rate
  • Streams

    The number of times listeners streamed your content for at least 30 seconds within 14 days of seeing or hearing your ads.

    spotify_ads:streams
  • Streamed Impressions

    The number of times an ad has been streamed

    spotify_ads:streamed_impressions
  • Leads

    The number of lead events attributed to your ads within a 30-day window

    spotify_ads:leads
  • Purchases

    The number of purchase events attributed to your ads within a 30-day window

    spotify_ads:purchases
  • Attributed Revenue

    The total amount of revenue attributed from purchase or lead events based on information received from data sources connected to Spotify

    spotify_ads:revenue
  • ROAS

    The total return on ad spend from attributed purchases, based on the value of purchase or lead events received from data sources connected to Spotify

    spotify_ads:return_on_ad_spend

Charts

7 metrics

  • Reach and Impressions over time

    The number of unique users who received your ad and the number of times your ad was served over time.

    spotify_ads:reach_impressions_by_day
  • Clicks and CTR over time

    The number of times an ad was clicked and the percentage of ads that were clicked over time.

    spotify_ads:clicks_ctr_by_day
  • Spend over time

    The total amount spent in this campaign over time.

    spotify_ads:spend_by_day
  • Listeners and New Listeners

    The number of unique Spotify users who streamed at least 30 seconds of the promoted content within 14 days of seeing or hearing your ad and the number of listeners who had not streamed your content in the 28 days before seeing or hearing your ad in the specified time period.

    spotify_ads:listeners_by_day
  • Clicks by Age

    The number of times an ad was clicked by age group

    spotify_ads:clicks_by_age
  • Clicks by Gender

    The number of times an ad was clicked by gender

    spotify_ads:clicks_by_gender
  • Reach by Platform

    The number of unique users who received your ad by platform

    spotify_ads:reach_by_platform

Tables

6 metrics

  • Featured Ads

    Your ads in the specified time period.

    spotify_ads:ads
  • Featured campaigns

    Campaigns that had the greatest impact on your audience, during the period analyzed.

    spotify_ads:featured_campaigns
  • Featured ad set

    Summary of key data for ad sets for the period analyzed.

    spotify_ads:ad_sets
  • Featured Genre

    Summary of key data for genres

    spotify_ads:insights_by_genre
  • Featured Country

    Summary of key data for countries

    spotify_ads:insights_by_country
  • Featured Placement

    Summary of key data for placements

    spotify_ads:insights_by_placement

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.