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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Spotify

Spotify Playlists API

The Playlists API from Spotify — 10 operation(s) for playlists.

Documentation Provider Profile APIs.io OpenAPI GitHub

Spotify Playlists 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 Playlists. 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 18 operations across 8 paths, and defines 27 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.

18 operations 8 paths 27 schemas 2 DELETE8 GET4 POST4 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
Contact
Spotify for Developers Community
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

Spotify Playlists 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 18

Across 8 paths, the API surfaces 18 operations — 2 DELETE, 8 GET, 4 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Playlists 18
GET
/playlists/{playlist_id}
Get Playlist
get-playlist 4 params → 200401403429
PUT
/playlists/{playlist_id}
Change Playlist Details
change-playlist-details 1 param body → 200401403429
GET
/playlists/{playlist_id}/tracksdeprecated
Get Playlist Items [DEPRECATED]
get-playlists-tracks 6 params → 200401403429
POST
/playlists/{playlist_id}/tracksdeprecated
Add Items to Playlist [DEPRECATED]
add-tracks-to-playlist 3 params body → 201401403429
PUT
/playlists/{playlist_id}/tracksdeprecated
Update Playlist Items [DEPRECATED]
reorder-or-replace-playlists-tracks 2 params body → 200401403429
DELETE
/playlists/{playlist_id}/tracksdeprecated
Remove Playlist Items [DEPRECATED]
remove-tracks-playlist 1 param body → 200401403429
GET
/playlists/{playlist_id}/items
Get Playlist Items
get-playlists-items 6 params → 200401403429
POST
/playlists/{playlist_id}/items
Add Items to Playlist
add-items-to-playlist 3 params body → 201401403429
PUT
/playlists/{playlist_id}/items
Update Playlist Items
reorder-or-replace-playlists-items 2 params body → 200401403429
DELETE
/playlists/{playlist_id}/items
Remove Playlist Items
remove-items-playlist 1 param body → 200401403429
GET
/me/playlists
Get Current User's Playlists
get-a-list-of-current-users-playlists 2 params → 200401403429
POST
/me/playlists
Create Playlist
create-playlist body → 201401403429
GET
/users/{user_id}/playlistsdeprecated
Get User's Playlists
get-list-users-playlists 3 params → 200401403429
POST
/users/{user_id}/playlistsdeprecated
Create Playlist for user
create-playlist-for-user 1 param body → 201401403429
GET
/browse/featured-playlistsdeprecated
Get Featured Playlists
get-featured-playlists 3 params → 200401403429
GET
/browse/categories/{category_id}/playlistsdeprecated
Get Category's Playlists
get-a-categories-playlists 3 params → 200401403429
GET
/playlists/{playlist_id}/images
Get Playlist Cover Image
get-playlist-cover 1 param → 200401403429
PUT
/playlists/{playlist_id}/images
Add Custom Playlist Cover Image
upload-custom-playlist-cover 1 param body → 202401403429

Schemas 27

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

AlbumBase
object
13 properties 12 required
ShowBase
object
17 properties 17 required
TrackRestrictionObject
object
1 property
EpisodeObject
object
PlaylistUserObject
object
5 properties
ExternalUrlObject
object
1 property
PagingPlaylistTrackObject
object
ResumePointObject
object
2 properties
EpisodeBase
object
20 properties 17 required
TrackObject
object
20 properties
AlbumRestrictionObject
object
1 property
SimplifiedShowObject
CopyrightObject
object
2 properties
ImageObject
object
3 properties 3 required
PlaylistOwnerObject
SimplifiedPlaylistObject
object
14 properties
PagingPlaylistObject
object
PlaylistTrackObject
object
5 properties
SimplifiedAlbumObject
ErrorObject
object
2 properties 2 required
SimplifiedArtistObject
object
6 properties
PlaylistObject
object
14 properties
ExternalIdObject
object
3 properties
PlaylistTracksRefObject
object
2 properties
PagingObject
object
6 properties 7 required
PagingFeaturedPlaylistObject
object
2 properties
EpisodeRestrictionObject
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spotify-playlists-api-openapi.yml Raw ↑

Other APIs Spotify publishes across the network.

Spotify Albums API
AE Profile APIs.io
Spotify Artists API
AE Profile APIs.io
Spotify Audiobooks API
AE Profile APIs.io
Spotify Categories API
AE Profile APIs.io
Spotify Chapters API
AE Profile APIs.io
Spotify Episodes API
AE Profile APIs.io
Spotify Genres API
AE Profile APIs.io
Spotify Library API
AE Profile APIs.io
Spotify Markets API
AE Profile APIs.io
Spotify Player API
AE Profile APIs.io
Spotify Search API
AE Profile APIs.io
Spotify Shows API
AE Profile APIs.io
#Playlists
← Back to S APIs
API Details
ID
spotify:spotify-playlists-api
Base URL
https://api.spotify.com/v1
Docs
https://developer.spotify.com/documentation/web-api
Provider
Spotify
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=spotify-playlists-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/spotify-playlists-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Spotify Playlists 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.