Spotify

aid: spotify
name: Spotify
description: Spotify is the world's leading music streaming platform with 600M+ users
  and 100M+ tracks. The Spotify Web API enables developers to discover music and podcasts,
  manage Spotify libraries, control audio playback, access audio analysis, and build
  personalized music experiences. Authentication uses OAuth 2.0 with scopes for user-authorized
  access. The API underwent significant changes in February 2026 with new generic
  library endpoints and streamlined playlist management.
type: Index
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Music
- Audio
- Streaming
- Podcasts
- Playlists
created: '2023-11-15'
modified: '2026-05-30'
url: https://raw.githubusercontent.com/api-evangelist/spotify/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: spotify:spotify-web-api
  name: Spotify Web API
  description: The Spotify Web API provides RESTful access to Spotify's music and
    podcast catalog, user library management, playback control, and personalization
    features. Developers can retrieve metadata for albums, artists, tracks, shows,
    and episodes; manage user playlists and saved libraries; control playback on connected
    devices; and access audio analysis and recommendations. OAuth 2.0 authentication
    supports Authorization Code Flow, PKCE, and Client Credentials flows.
  humanURL: https://developer.spotify.com/documentation/web-api
  baseURL: https://api.spotify.com/v1
  tags:
  - Albums
  - Artists
  - Tracks
  - Playlists
  - Player
  - Search
  - Podcasts
  - Library
  - Recommendations
  - Audio Analysis
  properties:
  - type: Documentation
    url: https://developer.spotify.com/documentation/web-api
  - type: OpenAPI
    url: openapi/spotify-openapi-original.yml
  - type: GettingStarted
    url: https://developer.spotify.com/documentation/web-api/tutorials/getting-started
  - type: Authorization
    url: https://developer.spotify.com/documentation/web-api/concepts/authorization
  - type: RateLimits
    url: https://developer.spotify.com/documentation/web-api/concepts/rate-limits
  - type: Scopes
    url: https://developer.spotify.com/documentation/web-api/concepts/scopes
  - type: JSONSchema
    url: json-schema/spotify-track-schema.json
  - type: JSONSchema
    url: json-schema/spotify-playlist-schema.json
  - type: JSONStructure
    url: json-structure/spotify-track-structure.json
  - type: JSONLD
    url: json-ld/spotify-context.jsonld
  - type: SpectralRules
    url: rules/spotify-rules.yml
  - type: Capabilities
    url: capabilities/music-discovery.yaml
  - type: Vocabulary
    url: vocabulary/spotify-vocabulary.yml
  - type: NaftikoCapability
    url: capabilities/spotify-albums.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-artists.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-audiobooks.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-categories.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-chapters.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-episodes.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-genres.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-library.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-markets.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-player.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-playlists.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-search.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-shows.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-tracks.yaml
  - type: NaftikoCapability
    url: capabilities/spotify-users.yaml
  - url: graphql/spotify-graphql.md
    type: GraphQL
  features:
  - type: MusicCatalog
    description: Search and retrieve metadata for 100M+ tracks, albums, and artists
  - type: PlaybackControl
    description: Control Spotify playback on any connected device via API
  - type: LibraryManagement
    description: Save, remove, and manage user's music library with generic URI-based
      endpoints
  - type: PlaylistManagement
    description: Create, update, and manage playlists; add, reorder, and remove items
  - type: AudioAnalysis
    description: Access beat-by-beat audio analysis including tempo, key, and energy
  - type: Recommendations
    description: Generate personalized track recommendations based on seeds and audio
      features
  - type: Personalization
    description: Access user's top artists and tracks over multiple time ranges
  - type: PodcastsAudiobooks
    description: Stream and manage shows, episodes, and audiobooks
  useCases:
  - type: MusicDiscovery
    description: Build recommendation engines and music discovery experiences
  - type: PlaylistBuilding
    description: Create collaborative or AI-generated playlists
  - type: PartyMode
    description: Control music playback at events, restaurants, or shared spaces
  - type: MusicAnalytics
    description: Analyze listening patterns and audio characteristics
  - type: DeviceControl
    description: Remote control Spotify playback from companion apps
common:
- type: GitHubOrganization
  url: https://github.com/spotify
- type: LinkedIn
  url: https://www.linkedin.com/company/spotify
- url: https://developer.spotify.com/
  type: Developer
- url: https://developer.spotify.com/documentation/web-api/tutorials/getting-started
  type: GettingStarted
- url: https://developer.spotify.com/documentation/web-api/concepts/authorization
  type: Authorization
- url: https://developer.spotify.com/documentation/web-api/concepts/rate-limits
  type: RateLimits
- url: https://developer.spotify.com/documentation/web-api/concepts/scopes
  type: Scopes
- url: https://developer.spotify.com/community
  type: Community
- url: https://developer.spotify.com/documentation/embeds
  type: Embeds
- url: https://developer.spotify.com/terms
  type: TermsOfService
- url: https://accounts.spotify.com/en/login
  type: Login
- url: https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer
  type: Forum
- url: https://developer.spotify.com/documentation/web-api/references/changes/february-2026
  type: ChangeLog
- type: LLMsTxt
  url: https://developer.spotify.com/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com