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"
]
}
]
}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:clicksAd Played Up To 100%
The number of ads served that was played to the end
spotify_ads:completesAd Played Up To 100% Rate
The percentage of ads played to completion
spotify_ads:completion_rateClick Through Rate
The percentage of ads that were clicked
spotify_ads:ctrCPM
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_cpmCPCL
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_cpclAd Played Up To 25%
The number of users who listened or viewed 25% of the ad's total length
spotify_ads:first_quartilesFrequency of Ads Served
The average number of times each person heard or viewed your ad
spotify_ads:frequencyImpressions
The number of times an ad has been served
spotify_ads:impressionsAd Played Up To 50%
The number of users for which the ad played to the midpoint of the ad's total length
spotify_ads:midpointsOff Spotify Impressions
The number of ads served off of Spotify
spotify_ads:off_spotify_impressionsPaid Listens
The number of listens for a CPCL campaign where a user did NOT skip the ad
spotify_ads:paid_listensFrequency of Paid Listens
The average frequency for listens on a CPCL campaign
spotify_ads:paid_listens_frequencyReach 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_reachReach of Ads Served
The number of unique users who received your ad
spotify_ads:reachAmount Spent
The total amount spent in this campaign
spotify_ads:spendStarts
The number of times a user starts hearing/viewing your ad
spotify_ads:startsSkips
The number of times a user skips an ad
spotify_ads:skipsAd Played Up To 75%
The number of users who listened or viewed 75% of the ad's total length
spotify_ads:third_quartilesUnmutes
The number of times a user unmutes an ad
spotify_ads:unmutesVideo Expands
The number of times someone tapped your ad to expand it
spotify_ads:video_expandsVideo Expand Rate
The number ad expands divided by the number of impressions
spotify_ads:video_expand_rateVideo Views
The number of times your video played for at least 3 seconds
spotify_ads:video_viewsAverage Streams per Listener
The average number of times each listener streamed your content after seeing or hearing your ad.
spotify_ads:streams_per_userAverage 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_listenerIntent 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_rateListener Conversion Rate
The percentage of listeners who streamed your content after seeing or hearing your ad.
spotify_ads:conversion_rateListeners
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:listenersNew Listener Streams
The number of streams from new listeners who heard or saw your ad.
spotify_ads:new_listener_streamsNew Listeners
The number of listeners who had not streamed your content in the 28 days before seeing or hearing your ad.
spotify_ads:new_listenersNew Listeners Conversion Rate
The percentage of new listeners who streamed your content after seeing or hearing your ad.
spotify_ads:new_listener_conversion_rateStreams
The number of times listeners streamed your content for at least 30 seconds within 14 days of seeing or hearing your ads.
spotify_ads:streamsStreamed Impressions
The number of times an ad has been streamed
spotify_ads:streamed_impressionsLeads
The number of lead events attributed to your ads within a 30-day window
spotify_ads:leadsPurchases
The number of purchase events attributed to your ads within a 30-day window
spotify_ads:purchasesAttributed Revenue
The total amount of revenue attributed from purchase or lead events based on information received from data sources connected to Spotify
spotify_ads:revenueROAS
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_dayClicks 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_daySpend over time
The total amount spent in this campaign over time.
spotify_ads:spend_by_dayListeners 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_dayClicks by Age
The number of times an ad was clicked by age group
spotify_ads:clicks_by_ageClicks by Gender
The number of times an ad was clicked by gender
spotify_ads:clicks_by_genderReach 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:adsFeatured campaigns
Campaigns that had the greatest impact on your audience, during the period analyzed.
spotify_ads:featured_campaignsFeatured ad set
Summary of key data for ad sets for the period analyzed.
spotify_ads:ad_setsFeatured Genre
Summary of key data for genres
spotify_ads:insights_by_genreFeatured Country
Summary of key data for countries
spotify_ads:insights_by_countryFeatured 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.
