# Spotify Web API

**Provider:** Spotify
**Category:** entertainment
**Base URL:** `https://api.spotify.com/v1`
**Auth:** oauth2 — `Authorization: Bearer BQC...`
**Rate Limit:** 180 requests/min (approx)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developer.spotify.com/documentation/web-api

## Description

Spotify's Web API gives programmatic access to Spotify's catalog of 100M+ tracks. Search for any song, artist, album, or playlist; retrieve audio features (tempo, key, danceability); control playback on active devices; manage the user's library; follow artists; and create/modify playlists.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.spotify.com/v1/search` | Search tracks, albums, artists, playlists |
| GET | `https://api.spotify.com/v1/tracks/{id}` | Get track metadata |
| GET | `https://api.spotify.com/v1/audio-features/{id}` | Get audio analysis (tempo, key, energy) |
| GET | `https://api.spotify.com/v1/recommendations` | Get personalized track recommendations |
| GET | `https://api.spotify.com/v1/me/player` | Get current playback state |
| PUT | `https://api.spotify.com/v1/me/player/play` | Start or resume playback |
| POST | `https://api.spotify.com/v1/users/{id}/playlists` | Create a playlist |

## Authentication

Use OAuth 2.0. Client credentials grant for catalog access; Authorization Code + PKCE for user data and playback control.

```
Authorization: Bearer BQC...
```

## Sample Request

```bash
curl "https://api.spotify.com/v1/search?q=Daft+Punk&type=artist&limit=1" \
  -H "Authorization: Bearer $SPOTIFY_ACCESS_TOKEN"
```

## Sample Response

```json
{
  "artists": {
    "items": [{
      "id": "4tZwfgrHOc3mvqYlEYSvVi",
      "name": "Daft Punk",
      "popularity": 80,
      "followers": {"total": 9842341},
      "genres": ["french house", "electronic"],
      "images": [{"url": "https://i.scdn.co/image/...", "width": 640}]
    }]
  }
}
```

## Pricing Details

Spotify API is free for all developers. Playback control requires users to have Spotify Premium. Extended Quota Mode requires approval.

---

*Source: [API Map](https://apimap.dev/apis/spotify/) — CC BY 4.0*