Skip to content
Documentation
Documentation
Products
Web API
Web Playback SDK
Ads API
iOS
Android
Embeds
Commercial Hardware
Open Access
Guidelines
Design
Accessibility
Legal
Community
Documentation
Documentation
Products
Web API
Web Playback SDK
Ads API
iOS
Android
Embeds
Commercial Hardware
Open Access
Guidelines
Design
Accessibility
Legal
Community
Ads API
Introduction
Introduction
Introduction
About
Next Steps
Support
Subscribe to Newsletter
API Design
Rate Limiting
Breaking v. Non-Breaking Changes Policy
Versioning
Time format
Pagination
Release Notes
Quickstart
Quickstart
Quickstart
Account Prerequisites
Initialize your new Ads API application
Authenticate your Ad Studio account
Using the refresh token
Guides
Guides
Guides
Object hierarchy
Ad Accounts
Advertisers
Campaigns
Ad Sets
Ads
Assets
Campaign Management
Overview
Eligibility Criteria
Differences from the UI
Build a Campaign
Reporting
Overview
Eligibility Criteria
Differences from the UI (Reporting)
Metrics Glossary
Campaign Performance Metrics
Streaming Conversion Metrics
Reference
General info
ad-accounts
ad-accounts
ad-accounts
Get Ad Accounts for Current User
Get an Ad Account by ID
ad-categories
ad-categories
ad-categories
Get Ad Categories
ad-sets
ad-sets
ad-sets
Get Ad Set by ID
Update Ad Set
Get Ad Sets by Ad Account ID
Create an Ad Set
ads
ads
ads
Get Ads by Ad Account ID
Create an Ad
Get Ad by ID
Update an Ad
assets
assets
assets
Get Assets by Ad Account
Create Asset
Get Asset by ID
Update Asset
Upload Asset
Start Upload Chunked Asset
Transfer Chunked Asset
Complete Upload Chunked Asset
campaigns
campaigns
campaigns
Get Campaigns by Ad Account ID
Create a Campaign
Get Campaign by ID
Update a Campaign
estimates
estimates
estimates
Estimate audience
Estimate bid
podcast-shows
podcast-shows
podcast-shows
Get Podcast Shows
reports
reports
reports
Get Aggregate Report by Ad Account ID
Get Insight Report by Ad Account ID
targets
targets
targets
Get Artist Targets
Get Genre Targets
Get Geo Targets
Get Interest Targets
Get Language Targets
Get Playlist Targets
Get Podcast Episode Topic Targets
Get Sensitive Topic Targets
Ads API
Introduction
Introduction
Introduction
About
Next Steps
Support
Subscribe to Newsletter
API Design
Rate Limiting
Breaking v. Non-Breaking Changes Policy
Versioning
Time format
Pagination
Release Notes
Quickstart
Quickstart
Quickstart
Account Prerequisites
Initialize your new Ads API application
Authenticate your Ad Studio account
Using the refresh token
Guides
Guides
Guides
Object hierarchy
Ad Accounts
Advertisers
Campaigns
Ad Sets
Ads
Assets
Campaign Management
Overview
Eligibility Criteria
Differences from the UI
Build a Campaign
Reporting
Overview
Eligibility Criteria
Differences from the UI (Reporting)
Metrics Glossary
Campaign Performance Metrics
Streaming Conversion Metrics
Reference
General info
ad-accounts
ad-accounts
ad-accounts
Get Ad Accounts for Current User
Get an Ad Account by ID
ad-categories
ad-categories
ad-categories
Get Ad Categories
ad-sets
ad-sets
ad-sets
Get Ad Set by ID
Update Ad Set
Get Ad Sets by Ad Account ID
Create an Ad Set
ads
ads
ads
Get Ads by Ad Account ID
Create an Ad
Get Ad by ID
Update an Ad
assets
assets
assets
Get Assets by Ad Account
Create Asset
Get Asset by ID
Update Asset
Upload Asset
Start Upload Chunked Asset
Transfer Chunked Asset
Complete Upload Chunked Asset
campaigns
campaigns
campaigns
Get Campaigns by Ad Account ID
Create a Campaign
Get Campaign by ID
Update a Campaign
estimates
estimates
estimates
Estimate audience
Estimate bid
podcast-shows
podcast-shows
podcast-shows
Get Podcast Shows
reports
reports
reports
Get Aggregate Report by Ad Account ID
Get Insight Report by Ad Account ID
targets
targets
targets
Get Artist Targets
Get Genre Targets
Get Geo Targets
Get Interest Targets
Get Language Targets
Get Playlist Targets
Get Podcast Episode Topic Targets
Get Sensitive Topic Targets
Ads API •
References / info
Ads API v2.0
Servers
Sandbox server for user testing.
https://api-partner.spotify.com/ads-sandbox/v2
Production server.
https://api-partner.spotify.com/ads/v2