How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Spotify Player API

The Player API from Spotify — 13 operation(s) for player.

Spotify Player API is one of 15 APIs that Spotify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Player. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, rate-limit docs, a JSON-LD context, and 3 JSON Schemas.

This API exposes 15 operations across 13 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.spotify.com/v1.

15 operations 13 paths 26 schemas 5 GET3 POST7 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.spotify.com/v1
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Spotify Player API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth_2_0) using the authorizationCode flow, exposing 19 scopes.

  • oauth_2_0 — Spotify supports OAuth 2.0 for authenticating all API requests.

Paths & Operations 15

Across 13 paths, the API surfaces 15 operations — 5 GET, 3 POST, 7 PUT. Each is listed below with its method, path, parameters, and response codes.

Player 15
GET
/me/player
Get Playback State
get-information-about-the-users-current-playback 2 params → 200204401403429
PUT
/me/player
Transfer Playback
transfer-a-users-playback body → 204401403429
GET
/me/player/devices
Get Available Devices
get-a-users-available-devices → 200401403429
GET
/me/player/currently-playing
Get Currently Playing Track
get-the-users-currently-playing-track 2 params → 200401403429
PUT
/me/player/play
Start/Resume Playback
start-a-users-playback 1 param body → 204401403429
PUT
/me/player/pause
Pause Playback
pause-a-users-playback 1 param → 204401403429
POST
/me/player/next
Skip To Next
skip-users-playback-to-next-track 1 param → 204401403429
POST
/me/player/previous
Skip To Previous
skip-users-playback-to-previous-track 1 param → 204401403429
PUT
/me/player/seek
Seek To Position
seek-to-position-in-currently-playing-track 2 params → 204401403429
PUT
/me/player/repeat
Set Repeat Mode
set-repeat-mode-on-users-playback 2 params → 204401403429
PUT
/me/player/volume
Set Playback Volume
set-volume-for-users-playback 2 params → 204401403429
PUT
/me/player/shuffle
Toggle Playback Shuffle
toggle-shuffle-for-users-playback 2 params → 204401403429
GET
/me/player/recently-played
Get Recently Played Tracks
get-recently-played 3 params → 200401403429
GET
/me/player/queue
Get the User's Queue
get-queue → 200401403429
POST
/me/player/queue
Add Item to Playback Queue
add-to-queue 2 params → 204401403429

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are EpisodeBase (20 properties), TrackObject (20 properties), ShowBase (17 properties), AlbumBase (13 properties). Each schema is shown below with its type and property counts.

AlbumBase
object
13 properties 12 required
CursorPagingObject
object
5 properties
ShowBase
object
17 properties 17 required
TrackRestrictionObject
object
1 property
DisallowsObject
object
10 properties
EpisodeObject
object
ExternalUrlObject
object
1 property
CursorObject
object
2 properties
QueueObject
object
2 properties
ContextObject
object
4 properties
ResumePointObject
object
2 properties
DeviceObject
object
8 properties
EpisodeBase
object
20 properties 17 required
TrackObject
object
20 properties
AlbumRestrictionObject
object
1 property
SimplifiedShowObject
CopyrightObject
object
2 properties
CursorPagingPlayHistoryObject
object
PlayHistoryObject
object
3 properties
ImageObject
object
3 properties 3 required
CurrentlyPlayingContextObject
object
10 properties
SimplifiedAlbumObject
ErrorObject
object
2 properties 2 required
SimplifiedArtistObject
object
6 properties
ExternalIdObject
object
3 properties
EpisodeRestrictionObject
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spotify-player-api-openapi.yml Raw ↑

Other APIs Spotify publishes across the network.

Spotify Albums API
Spotify Artists API
Spotify Audiobooks API
Spotify Categories API
Spotify Chapters API
Spotify Episodes API
Spotify Genres API
Spotify Library API
Spotify Markets API
Spotify Playlists API
Spotify Search API
Spotify Shows API
Where this information came from

This is an independent, third-party profile of Spotify Player API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.