# Spotify API v2 for AI Agents

Spotify metadata v2: tracks, albums, artists, playlists, search, full discographies, artist playlists, related artists, discovered-on and featuring playlists, similar albums, podcasts, episodes, audiobooks, chapters, genres and users. No auth, no API key.

| Field | Value |
| --- | --- |
| Provider | APIStead Labs |
| Category | Media |
| Networks | Base |
| Price | $0.03 per call |
| Base URL | https://apistead.qd.je/api/v2 |
| Verification | verified (23/23 routes) |
| Last verified | 2026-11-13T13:53:04.807Z |
| Receipt | https://basescan.org/tx/0x3f369c98f7753d3fda50495d941342c1880dd2480d6e80170fa235127b97ef1b |
| JSON | https://x402.apistead.qd.je/api/apis/spotify-api-v2 |
| Markdown | https://x402.apistead.qd.je/api/apis/spotify-api-v2/md |
| MCP | https://apistead.qd.je/mcp |
| API reference | https://x402.apistead.qd.je/api |
| OpenAPI | https://x402.apistead.qd.je/openapi.json |

## For AI agents

Spotify v2 metadata for agents: search the catalogue; fetch complete artist discographies, artist playlists, related artists, similar albums, podcast episodes, audiobook chapters and public user playlists. No Spotify login or API key.

## Scope

The v2 release covers public Spotify search, playlists, albums, artists, artist top tracks, related artists, artist playlists, discovered-on playlists, featuring playlists, complete artist discographies, tracks, similar albums, podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. The five v1 routes remain live. It does not access a user library, playback, downloads or account data. Playlist creation dates and per-track added dates are not exposed in public metadata.

## Agent intents

- Spotify search API
- Spotify API without login
- Spotify API without an API key
- Spotify API no OAuth
- Spotify catalogue search
- Spotify music metadata API
- Spotify discography API
- Spotify artist playlists API
- Spotify related artists API
- get Spotify related artists
- get Spotify artist playlists
- get Spotify artist discovered-on playlists
- get Spotify artist featuring playlists
- get Spotify albums similar to a track
- search Spotify podcasts
- search Spotify episodes
- search Spotify audiobooks
- search Spotify users
- get a Spotify podcast
- get Spotify podcast episodes
- get a Spotify episode
- get a Spotify audiobook
- get Spotify audiobook chapters
- get Spotify genres
- get a Spotify public user profile
- search Spotify tracks
- search Spotify albums
- search Spotify artists
- search Spotify playlists
- get Spotify metadata without a token
- search Spotify for a track
- search Spotify for an album or artist
- search Spotify without an API key
- get a Spotify artist's complete discography
- get a Spotify playlist with full track metadata
- get Spotify metadata without a Spotify account
- Spotify API v2 for AI agents
- Spotify API alternative

Spotify v2 is the additive generation of the APIStead Spotify API. The five v1 routes remain live; v2 adds keyword search, complete artist discographies, artist playlist sections, related artists and similar albums.

Every v2 route accepts a Spotify URL, URI or 22-character id and returns normalized JSON. Playlists return every ordered track with no song limit. Search returns tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users with per-type counts and totals. Dedicated search routes cover podcasts, episodes, audiobooks and users. Detail routes return podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. Artist routes return playlists, related artists, discovered-on playlists and featuring playlists. Discography returns the artist's release sections and marks `complete: true` when the full discography was read.

The API reads public Spotify catalogue metadata. No Spotify account, login, OAuth token or API key is required from the buyer. This is an independent APIStead API and is not affiliated with or endorsed by Spotify.

Playlist creation dates and per-track added dates are not exposed in public metadata, so those fields are not returned. Playback control, downloads and user-library access are not included.

## Endpoints

### GET /spotify/search

Search Spotify tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users.

- URL: https://apistead.qd.je/api/v2/spotify/search
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.788Z
- Latency: 3 ms
- Uptime (30d): 80.65%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=all&limit=2
```

Example response:

```json
{
  "note": "Spotify catalogue search, normalized for agents. Returns public tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users. Playback control, downloads and user-library access are not included.",
  "type": "all",
  "limit": 2,
  "query": "daft punk",
  "users": [],
  "albums": [
    {
      "id": "5WulAOx9ilWy1h8UGZ1gkI",
      "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
      "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
      "name": "Deadbeat",
      "type": "album",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "track_count": null,
      "release_date": "2025-10-17"
    }
  ],
  "counts": {
    "users": 0,
    "albums": 1,
    "genres": 0,
    "tracks": 1,
    "artists": 1,
    "episodes": 0,
    "podcasts": 0,
    "playlists": 1,
    "audiobooks": 0
  },
  "genres": [],
  "offset": 0,
  "source": "spotify",
  "totals": {
    "users": 0,
    "albums": 1,
    "genres": 0,
    "tracks": 1,
    "artists": 1,
    "episodes": 0,
    "podcasts": 0,
    "playlists": 1,
    "audiobooks": 0
  },
  "tracks": [
    {
      "id": "4whkhyXTrTgHKZzkUvdwoq",
      "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
      "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
      "album": {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "name": "Deadbeat",
        "release_date": "2025-10-17"
      },
      "title": "My Old Ways",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "explicit": true,
      "playable": true,
      "position": 1,
      "duration_ms": 298783,
      "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
      "release_date": "2025-10-17",
      "duration_formatted": "4:59"
    }
  ],
  "artists": [
    {
      "id": "5INjqkS1o8h1imAzPqGZBb",
      "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
      "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
      "name": "Tame Impala",
      "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601"
    }
  ],
  "preview": false,
  "episodes": [],
  "podcasts": [],
  "playlists": [
    {
      "id": "37i9dQZF1DXcBWIGoYBM5M",
      "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M",
      "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
      "name": "Daft Punk Mix",
      "owner": {
        "id": "spotify",
        "url": "https://open.spotify.com/user/spotify",
        "name": "Spotify",
        "avatar": null
      },
      "cover_image": "https://i.scdn.co/image/ab67616d0000b2730893a0c33fd4b8497b0ef2f6",
      "description": "",
      "track_count": null
    }
  ],
  "audiobooks": [],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/playlist

Spotify playlist metadata and every ordered track. There is no song limit.

- URL: https://apistead.qd.je/api/v2/spotify/playlist
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.735Z
- Latency: 3 ms
- Uptime (30d): 79.03%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/playlist?url=https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M&include_albums=true&album_limit=10
```

Example response:

```json
{
  "note": "Spotify playlist metadata, normalized for agents. Playback control, downloads and user-library access are not included.",
  "source": "spotify",
  "tracks": [
    {
      "id": "4whkhyXTrTgHKZzkUvdwoq",
      "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
      "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
      "album": {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "name": "Deadbeat",
        "release_date": "2025-10-17"
      },
      "title": "My Old Ways",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "explicit": true,
      "playable": true,
      "position": 1,
      "duration_ms": 298783,
      "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
      "release_date": "2025-10-17",
      "duration_formatted": "4:59"
    }
  ],
  "preview": false,
  "summary": {
    "duration_ms": 298783,
    "track_count": 1,
    "unique_albums": 1,
    "explicit_count": 1,
    "unique_artists": 1,
    "returned_tracks": 1,
    "duration_formatted": "4:59",
    "average_track_duration_ms": 298783
  },
  "playlist": {
    "id": "37i9dQZF1DXcBWIGoYBM5M",
    "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M",
    "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
    "name": "Today's Top Hits",
    "owner": {
      "id": "spotify",
      "url": "https://open.spotify.com/user/spotify",
      "name": "Spotify",
      "avatar": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5"
    },
    "saves": 3500000,
    "playable": true,
    "cover_image": "https://i.scdn.co/image/ab67616d0000b2730893a0c33fd4b8497b0ef2f6",
    "description": "The hottest 50.",
    "duration_ms": 199000,
    "track_count": 1,
    "explicit_count": 0,
    "duration_formatted": "3:19"
  },
  "retrieved_at": "2026-11-12T00:00:00Z",
  "album_enrichment": {
    "limit": 10,
    "limited": false,
    "requested": true,
    "enriched_tracks": 1
  }
}
```

### GET /spotify/album

Spotify album metadata and full track list.

- URL: https://apistead.qd.je/api/v2/spotify/album
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.683Z
- Latency: 8 ms
- Uptime (30d): 80.65%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/album?url=https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI
```

Example response:

```json
{
  "note": "Spotify album metadata, normalized for agents. Playback control, downloads and user-library access are not included.",
  "album": {
    "id": "5WulAOx9ilWy1h8UGZ1gkI",
    "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
    "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
    "name": "Deadbeat",
    "type": "album",
    "artists": [
      {
        "id": "5INjqkS1o8h1imAzPqGZBb",
        "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
        "name": "Tame Impala"
      }
    ],
    "playable": true,
    "copyrights": [
      "℗ 2025 Columbia Records, a Division of Sony Music Entertainment, under exclusive license from Tame Impala"
    ],
    "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
    "duration_ms": 2600000,
    "track_count": 12,
    "release_date": "2025-10-17",
    "explicit_count": 1,
    "duration_formatted": "43:20"
  },
  "source": "spotify",
  "tracks": [
    {
      "id": "4whkhyXTrTgHKZzkUvdwoq",
      "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
      "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
      "album": {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "name": "Deadbeat",
        "release_date": "2025-10-17"
      },
      "title": "My Old Ways",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "explicit": true,
      "playable": true,
      "position": 1,
      "duration_ms": 298783,
      "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
      "release_date": "2025-10-17",
      "duration_formatted": "4:59"
    }
  ],
  "preview": false,
  "summary": {
    "duration_ms": 2600000,
    "track_count": 12,
    "explicit_count": 1,
    "unique_artists": 1,
    "returned_tracks": 12,
    "duration_formatted": "43:20",
    "average_track_duration_ms": 216667
  },
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist

Spotify artist profile and top tracks.

- URL: https://apistead.qd.je/api/v2/spotify/artist
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.889Z
- Latency: 7 ms
- Uptime (30d): 85.07%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify artist metadata, normalized for agents. Bio is included when Spotify publishes it. Playback control, downloads and user-library access are not included.",
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala",
    "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601",
    "followers": 12382756,
    "world_rank": 31,
    "monthly_listeners": 65445089
  },
  "source": "spotify",
  "preview": false,
  "summary": {
    "top_tracks": 5,
    "duration_ms": 1200000,
    "explicit_count": 2,
    "unique_artists": 1,
    "duration_formatted": "20:00"
  },
  "top_tracks": [
    {
      "id": "4whkhyXTrTgHKZzkUvdwoq",
      "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
      "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
      "album": {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "name": "Deadbeat",
        "release_date": "2025-10-17"
      },
      "title": "My Old Ways",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "explicit": true,
      "playable": true,
      "position": 1,
      "duration_ms": 298783,
      "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
      "release_date": "2025-10-17",
      "duration_formatted": "4:59"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/top-tracks

Spotify artist top tracks with album context.

- URL: https://apistead.qd.je/api/v2/spotify/artist/top-tracks
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.833Z
- Latency: 5 ms
- Uptime (30d): 81.97%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/top-tracks?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb&limit=2
```

Example response:

```json
{
  "note": "Spotify artist top tracks, normalized for agents. Each track includes album context. Playback control, downloads and user-library access are not included.",
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala",
    "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601",
    "followers": 12382756,
    "world_rank": 31,
    "monthly_listeners": 65445089
  },
  "source": "spotify",
  "preview": false,
  "summary": {
    "duration_ms": 480000,
    "explicit_count": 1,
    "unique_artists": 1,
    "requested_limit": 2,
    "returned_tracks": 2,
    "duration_formatted": "8:00",
    "available_top_tracks": 5
  },
  "top_tracks": [
    {
      "id": "4whkhyXTrTgHKZzkUvdwoq",
      "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
      "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
      "album": {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "name": "Deadbeat",
        "release_date": "2025-10-17"
      },
      "title": "My Old Ways",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
      "explicit": true,
      "playable": true,
      "position": 1,
      "duration_ms": 298783,
      "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
      "release_date": "2025-10-17",
      "duration_formatted": "4:59"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/discography

Spotify artist discography with complete release sections. The example response is abbreviated; the live route returns all albums, singles and EPs by default.

- URL: https://apistead.qd.je/api/v2/spotify/artist/discography
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.861Z
- Latency: 6 ms
- Uptime (30d): 82.54%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/discography?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify discography, normalized for agents. Albums, singles and EPs cover the artist's full discography; Popular releases and Appears On come from the artist overview. Playback control, downloads and user-library access are not included.",
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala",
    "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601",
    "followers": 12382756,
    "world_rank": 31,
    "monthly_listeners": 65445089
  },
  "source": "spotify",
  "preview": false,
  "summary": {
    "scope": "full_discography",
    "albums": 1,
    "complete": true,
    "appears_on": 1,
    "total_releases": 6,
    "singles_and_eps": 1,
    "appears_on_total": 1,
    "popular_releases": 1,
    "appears_on_complete": true
  },
  "sections": {
    "albums": [
      {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "type": "album",
        "year": 2025,
        "title": "Deadbeat",
        "section": "albums",
        "position": 1,
        "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
        "release_date": "2025-10-17"
      }
    ],
    "appears_on": [
      {
        "id": "4wtZQMNTC1O79kDxMBsEan",
        "uri": "spotify:album:4wtZQMNTC1O79kDxMBsEan",
        "url": "https://open.spotify.com/album/4wtZQMNTC1O79kDxMBsEan",
        "type": "album",
        "year": 2023,
        "title": "Cracker Island",
        "section": "appears_on",
        "position": 1,
        "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
        "release_date": "2023-02-24"
      }
    ],
    "singles_and_eps": [
      {
        "id": "1V8Qu6CwkBfYucnCWxynq8",
        "uri": "spotify:album:1V8Qu6CwkBfYucnCWxynq8",
        "url": "https://open.spotify.com/album/1V8Qu6CwkBfYucnCWxynq8",
        "type": "single",
        "year": 2026,
        "title": "Flower In A Hurricane",
        "section": "singles_and_eps",
        "position": 1,
        "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
        "release_date": "2026-10-15"
      }
    ],
    "popular_releases": [
      {
        "id": "5WulAOx9ilWy1h8UGZ1gkI",
        "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI",
        "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
        "type": "album",
        "year": 2025,
        "title": "Deadbeat",
        "section": "popular_releases",
        "position": 1,
        "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
        "release_date": "2025-10-17"
      }
    ]
  },
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/track

Spotify track metadata.

- URL: https://apistead.qd.je/api/v2/spotify/track
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.801Z
- Latency: 4 ms
- Uptime (30d): 80.65%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/track?url=https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq
```

Example response:

```json
{
  "note": "Spotify track metadata, normalized for agents. Playback control, downloads and user-library access are not included.",
  "track": {
    "id": "4whkhyXTrTgHKZzkUvdwoq",
    "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
    "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq",
    "album": {
      "id": "5WulAOx9ilWy1h8UGZ1gkI",
      "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI",
      "name": "Deadbeat",
      "release_date": "2025-10-17"
    },
    "title": "My Old Ways",
    "artists": [
      {
        "id": "5INjqkS1o8h1imAzPqGZBb",
        "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
        "name": "Tame Impala"
      }
    ],
    "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b",
    "explicit": true,
    "playable": true,
    "copyrights": [
      "℗ 2025 Columbia Records, a Division of Sony Music Entertainment, under exclusive license from Tame Impala"
    ],
    "duration_ms": 298783,
    "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d",
    "release_date": "2025-10-17",
    "duration_formatted": "4:59"
  },
  "source": "spotify",
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/podcast

Spotify podcast metadata from a podcast link.

- URL: https://apistead.qd.je/api/v2/spotify/podcast
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.728Z
- Latency: 3 ms
- Uptime (30d): 80%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/podcast?id=79CkJF3UJTHFV8Dse3Oy0P
```

Example response:

```json
{
  "note": "Spotify podcast metadata, normalized for agents. Playback control, downloads and user-library access are not included.",
  "source": "spotify",
  "podcast": {
    "id": "79CkJF3UJTHFV8Dse3Oy0P",
    "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P",
    "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
    "name": "Huberman Lab",
    "rating": {
      "total": 132040,
      "average": 4.9
    },
    "topics": [
      "Health",
      "Science"
    ],
    "explicit": true,
    "playable": true,
    "publisher": "Scicomm Media",
    "media_type": "MIXED",
    "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a",
    "description": "The Huberman Lab podcast discusses neuroscience and science-based tools for everyday life.",
    "total_episodes": 458
  },
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/podcast/episodes

Spotify podcast episodes with limit and offset.

- URL: https://apistead.qd.je/api/v2/spotify/podcast/episodes
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.814Z
- Latency: 3 ms
- Uptime (30d): 75%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/podcast/episodes?id=79CkJF3UJTHFV8Dse3Oy0P&limit=2
```

Example response:

```json
{
  "note": "Spotify podcast episodes, normalized for agents. Playback control, downloads and user-library access are not included.",
  "limit": 2,
  "total": 458,
  "offset": 0,
  "source": "spotify",
  "podcast": {
    "id": "79CkJF3UJTHFV8Dse3Oy0P",
    "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P",
    "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
    "name": "Huberman Lab",
    "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a"
  },
  "preview": false,
  "episodes": [
    {
      "id": "2jMJRxwPQPErrwRGo8duQQ",
      "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ",
      "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ",
      "title": "Overcome Addictions & Obsessions of All Kinds",
      "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79",
      "podcast": {
        "id": "79CkJF3UJTHFV8Dse3Oy0P",
        "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
        "name": "Huberman Lab"
      },
      "explicit": false,
      "playable": true,
      "description": "A conversation about dopamine, habits and compulsive behaviour.",
      "duration_ms": 8210602,
      "media_types": [
        "AUDIO",
        "VIDEO"
      ],
      "preview_url": "https://p.scdn.co/mp3-preview/e6e12cd874abb5a8684c059f7e884f47e64e6acd.mp3",
      "release_date": "2026-11-09",
      "duration_formatted": "2:16:50"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/episode

Spotify episode metadata from an episode link.

- URL: https://apistead.qd.je/api/v2/spotify/episode
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.807Z
- Latency: 3 ms
- Uptime (30d): 78.57%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/episode?id=2jMJRxwPQPErrwRGo8duQQ
```

Example response:

```json
{
  "note": "Spotify episode metadata, normalized for agents. Playback control, downloads and user-library access are not included.",
  "source": "spotify",
  "episode": {
    "id": "2jMJRxwPQPErrwRGo8duQQ",
    "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ",
    "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ",
    "title": "Overcome Addictions & Obsessions of All Kinds",
    "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79",
    "podcast": {
      "id": "79CkJF3UJTHFV8Dse3Oy0P",
      "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
      "name": "Huberman Lab"
    },
    "explicit": false,
    "playable": true,
    "description": "A conversation about dopamine, habits and compulsive behaviour.",
    "duration_ms": 8210602,
    "media_types": [
      "AUDIO",
      "VIDEO"
    ],
    "preview_url": "https://p.scdn.co/mp3-preview/e6e12cd874abb5a8684c059f7e884f47e64e6acd.mp3",
    "release_date": "2026-11-09",
    "duration_formatted": "2:16:50"
  },
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/audiobook

Spotify audiobook metadata from an audiobook link.

- URL: https://apistead.qd.je/api/v2/spotify/audiobook
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.851Z
- Latency: 5 ms
- Uptime (30d): 80.36%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/audiobook?id=0Db3QPOPFO0SYx0TGG0mim
```

Example response:

```json
{
  "note": "Spotify audiobook metadata, normalized for agents. Audiobook audio, downloads and user-library access are not included.",
  "source": "spotify",
  "preview": false,
  "audiobook": {
    "id": "0Db3QPOPFO0SYx0TGG0mim",
    "uri": "spotify:show:0Db3QPOPFO0SYx0TGG0mim",
    "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim",
    "price": {
      "amount": 32.9,
      "currency": "USD",
      "formatted": "$32.90"
    },
    "title": "Protocols: An Operating Manual for the Human Body",
    "rating": {
      "total": 188,
      "average": 4.87
    },
    "authors": [
      "Andrew Huberman"
    ],
    "explicit": false,
    "language": "en",
    "playable": false,
    "narrators": [
      "Andrew D. Huberman Ph.D."
    ],
    "publisher": "Andrew D. Huberman Ph.D.",
    "cover_image": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5",
    "description": "A science-based operating manual for the human body.",
    "duration_ms": 65133789,
    "release_date": "2026-09-15",
    "chapters_count": 64,
    "duration_formatted": "18:05:33"
  },
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/audiobook/chapters

Spotify audiobook chapters with limit and offset.

- URL: https://apistead.qd.je/api/v2/spotify/audiobook/chapters
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.795Z
- Latency: 4 ms
- Uptime (30d): 78.57%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/audiobook/chapters?id=0Db3QPOPFO0SYx0TGG0mim&limit=2
```

Example response:

```json
{
  "note": "Spotify audiobook chapters, normalized for agents. Audiobook audio, downloads and user-library access are not included.",
  "limit": 2,
  "total": 64,
  "offset": 0,
  "source": "spotify",
  "preview": false,
  "chapters": [
    {
      "id": "6z4sRbQH1K2drBheUVeytw",
      "uri": "spotify:episode:6z4sRbQH1K2drBheUVeytw",
      "url": "https://open.spotify.com/episode/6z4sRbQH1K2drBheUVeytw",
      "title": "Track 1",
      "artwork": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5",
      "explicit": false,
      "playable": false,
      "position": 1,
      "audiobook": {
        "id": "0Db3QPOPFO0SYx0TGG0mim",
        "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim",
        "title": "Protocols: An Operating Manual for the Human Body"
      },
      "description": "",
      "duration_ms": 66507,
      "preview_url": null,
      "duration_formatted": "1:07"
    }
  ],
  "audiobook": {
    "id": "0Db3QPOPFO0SYx0TGG0mim",
    "uri": "spotify:show:0Db3QPOPFO0SYx0TGG0mim",
    "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim",
    "title": "Protocols: An Operating Manual for the Human Body",
    "cover_image": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5"
  },
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/genres

Search Spotify genres by keyword.

- URL: https://apistead.qd.je/api/v2/spotify/genres
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.586Z
- Latency: 4 ms
- Uptime (30d): 75%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/genres?q=pop&limit=2
```

Example response:

```json
{
  "note": "Spotify genres, normalized for agents.",
  "query": "pop",
  "total": 37,
  "genres": [
    {
      "id": "0JQ5DAqbMKFEC4WFtoNRpw",
      "uri": "spotify:genre:0JQ5DAqbMKFEC4WFtoNRpw",
      "name": "Pop",
      "image": "https://t.scdn.co/media/derived/pop-274x274_447148649685019f5e2a03a39e78ba52_0_0_274_274.jpg"
    }
  ],
  "source": "spotify",
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/user

Spotify public user profile and public playlists.

- URL: https://apistead.qd.je/api/v2/spotify/user
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.825Z
- Latency: 7 ms
- Uptime (30d): 78.57%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/user?id=spotify
```

Example response:

```json
{
  "note": "Spotify public user profile, normalized for agents. Private account data is not included.",
  "user": {
    "id": "spotify",
    "uri": "spotify:user:spotify",
    "url": "https://open.spotify.com/user/spotify",
    "image": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
    "username": "spotify",
    "display_name": "Spotify",
    "playlists_count": 1000,
    "public_playlists": [
      {
        "id": "37i9dQZF1DXcBWIGoYBM5M",
        "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M",
        "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M",
        "name": "Today's Top Hits",
        "followers": 33597453,
        "cover_image": null
      }
    ]
  },
  "source": "spotify",
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/search/podcasts

Search Spotify podcasts by keyword.

- URL: https://apistead.qd.je/api/v2/spotify/search/podcasts
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.774Z
- Latency: 4 ms
- Uptime (30d): 74.07%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/search/podcasts?q=huberman&limit=1
```

Example response:

```json
{
  "note": "Spotify podcast search, normalized for agents. Playback control, downloads and user-library access are not included.",
  "type": "podcast",
  "limit": 1,
  "query": "huberman",
  "total": 209,
  "offset": 0,
  "source": "spotify",
  "preview": false,
  "podcasts": [
    {
      "id": "79CkJF3UJTHFV8Dse3Oy0P",
      "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P",
      "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
      "name": "Huberman Lab",
      "publisher": "Scicomm Media",
      "media_type": "MIXED",
      "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/search/episodes

Search Spotify podcast episodes by keyword.

- URL: https://apistead.qd.je/api/v2/spotify/search/episodes
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.840Z
- Latency: 4 ms
- Uptime (30d): 77.78%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/search/episodes?q=dopamine&limit=1
```

Example response:

```json
{
  "note": "Spotify episode search, normalized for agents. Playback control, downloads and user-library access are not included.",
  "type": "episode",
  "limit": 1,
  "query": "dopamine",
  "total": 3,
  "offset": 0,
  "source": "spotify",
  "preview": false,
  "episodes": [
    {
      "id": "2jMJRxwPQPErrwRGo8duQQ",
      "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ",
      "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ",
      "title": "Overcome Addictions & Obsessions of All Kinds",
      "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79",
      "podcast": {
        "id": "79CkJF3UJTHFV8Dse3Oy0P",
        "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P",
        "name": "Huberman Lab"
      },
      "explicit": false,
      "playable": true,
      "description": "A conversation about dopamine, habits and compulsive behaviour.",
      "duration_ms": 8210602,
      "release_date": "2026-11-09",
      "duration_formatted": "2:16:50"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/search/audiobooks

Search Spotify audiobooks by keyword.

- URL: https://apistead.qd.je/api/v2/spotify/search/audiobooks
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.551Z
- Latency: 7 ms
- Uptime (30d): 74.07%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/search/audiobooks?q=atomic%20habits&limit=1
```

Example response:

```json
{
  "note": "Spotify audiobook search, normalized for agents. Audiobook audio, downloads and user-library access are not included.",
  "type": "audiobook",
  "limit": 1,
  "query": "atomic habits",
  "total": 2,
  "offset": 0,
  "source": "spotify",
  "preview": false,
  "audiobooks": [
    {
      "id": "40ygvasZaqVMMBkgYoUy8C",
      "uri": "spotify:show:40ygvasZaqVMMBkgYoUy8C",
      "url": "https://open.spotify.com/show/40ygvasZaqVMMBkgYoUy8C",
      "title": "Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones",
      "authors": [
        "James Clear"
      ],
      "cover_image": "https://i.scdn.co/image/ab676663000022a843d3293222816f8305c3eaaa",
      "description": "Author(s): James Clear Narrator(s): James Clear. Tiny changes, remarkable results.",
      "release_date": "2018-10-16"
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/search/users

Search Spotify public user profiles by keyword.

- URL: https://apistead.qd.je/api/v2/spotify/search/users
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.716Z
- Latency: 3 ms
- Uptime (30d): 75.93%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/search/users?q=huberman&limit=1
```

Example response:

```json
{
  "note": "Spotify public user search, normalized for agents. Private account data is not included.",
  "type": "user",
  "limit": 1,
  "query": "huberman",
  "total": 195,
  "users": [
    {
      "id": "31ad2j7c46tsiqvkw2msrjfmgky4",
      "uri": "spotify:user:31ad2j7c46tsiqvkw2msrjfmgky4",
      "url": "https://open.spotify.com/user/31ad2j7c46tsiqvkw2msrjfmgky4",
      "image": "https://i.scdn.co/image/ab6775700000ee851ce7fdc8210fb842b4dd8292",
      "username": "31ad2j7c46tsiqvkw2msrjfmgky4",
      "display_name": "Andrew Huberman"
    }
  ],
  "offset": 0,
  "source": "spotify",
  "preview": false,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/playlists

Spotify playlists owned by or associated with an artist.

- URL: https://apistead.qd.je/api/v2/spotify/artist/playlists
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.755Z
- Latency: 4 ms
- Uptime (30d): 77.36%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/playlists?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify playlists owned by or associated with the artist, normalized for agents.",
  "total": 1,
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala"
  },
  "source": "spotify",
  "preview": false,
  "complete": true,
  "returned": 1,
  "playlists": [
    {
      "id": "4wmXlb759ceIV2O4JRWjSo",
      "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo",
      "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo",
      "name": "Tame Impala Complete",
      "owner": {
        "url": null,
        "name": "Tame Impala"
      },
      "followers": null,
      "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa",
      "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now."
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/related

Spotify related artists for an artist.

- URL: https://apistead.qd.je/api/v2/spotify/artist/related
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.742Z
- Latency: 4 ms
- Uptime (30d): 75.93%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/related?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify related artists, normalized for agents.",
  "total": 40,
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala"
  },
  "source": "spotify",
  "artists": [
    {
      "id": "67hb7towEyKvt5Z8Bx306c",
      "uri": "spotify:artist:67hb7towEyKvt5Z8Bx306c",
      "url": "https://open.spotify.com/artist/67hb7towEyKvt5Z8Bx306c",
      "name": "Empire Of The Sun",
      "image": "https://i.scdn.co/image/ab6761610000e5ebc806f3e714afa21861e20248"
    }
  ],
  "preview": false,
  "complete": true,
  "returned": 40,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/discovered-on

Spotify playlists that surface an artist.

- URL: https://apistead.qd.je/api/v2/spotify/artist/discovered-on
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.701Z
- Latency: 15 ms
- Uptime (30d): 77.78%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/discovered-on?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify playlists that surface the artist, normalized for agents.",
  "total": 100,
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala"
  },
  "source": "spotify",
  "preview": false,
  "complete": false,
  "returned": 40,
  "playlists": [
    {
      "id": "4wmXlb759ceIV2O4JRWjSo",
      "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo",
      "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo",
      "name": "Tame Impala Complete",
      "owner": {
        "url": null,
        "name": "Tame Impala"
      },
      "followers": null,
      "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa",
      "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now."
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/artist/featuring

Spotify playlists featuring an artist.

- URL: https://apistead.qd.je/api/v2/spotify/artist/featuring
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.748Z
- Latency: 3 ms
- Uptime (30d): 75.93%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/artist/featuring?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb
```

Example response:

```json
{
  "note": "Spotify playlists featuring the artist, normalized for agents.",
  "total": 8,
  "artist": {
    "id": "5INjqkS1o8h1imAzPqGZBb",
    "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb",
    "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
    "name": "Tame Impala"
  },
  "source": "spotify",
  "preview": false,
  "complete": true,
  "returned": 8,
  "playlists": [
    {
      "id": "4wmXlb759ceIV2O4JRWjSo",
      "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo",
      "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo",
      "name": "Tame Impala Complete",
      "owner": {
        "url": null,
        "name": "Tame Impala"
      },
      "followers": null,
      "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa",
      "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now."
    }
  ],
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

### GET /spotify/track/similar-albums

Spotify albums similar to a track.

- URL: https://apistead.qd.je/api/v2/spotify/track/similar-albums
- Price: $0.03 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.768Z
- Latency: 3 ms
- Uptime (30d): 77.36%

Example request:

```http
GET https://apistead.qd.je/api/v2/spotify/track/similar-albums?url=https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq&limit=2
```

Example response:

```json
{
  "note": "Spotify albums similar to the supplied track, normalized for agents.",
  "total": 42,
  "track": {
    "id": "4whkhyXTrTgHKZzkUvdwoq",
    "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq",
    "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq"
  },
  "albums": [
    {
      "id": "31qVWUdRrlb8thMvts0yYL",
      "uri": "spotify:album:31qVWUdRrlb8thMvts0yYL",
      "url": "https://open.spotify.com/album/31qVWUdRrlb8thMvts0yYL",
      "name": "The Slow Rush",
      "type": "album",
      "artists": [
        {
          "id": "5INjqkS1o8h1imAzPqGZBb",
          "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb",
          "name": "Tame Impala"
        }
      ],
      "cover_image": "https://i.scdn.co/image/ab67616d0000b27358267bd34420a00d5cf83a49",
      "track_count": 12,
      "release_date": "2020-02-14"
    }
  ],
  "source": "spotify",
  "preview": false,
  "complete": false,
  "returned": 2,
  "retrieved_at": "2026-11-12T00:00:00Z"
}
```

## Payment

Every paid route uses x402 over HTTP. Call the route without payment to receive a 402 challenge, then pay the quoted USDC amount and retry. The 402 challenge is the authoritative source for price, asset, network and pay-to address. Reading this record and the discovery API is free.

- Protocol: x402 v2
- Asset: USDC
- Networks: Base
- Price: $0.03 per call

## Verification

- State: verified
- Routes verified: 23/23
- Last verified: 2026-11-13T13:53:04.807Z
- Receipt: https://basescan.org/tx/0x3f369c98f7753d3fda50495d941342c1880dd2480d6e80170fa235127b97ef1b

## FAQ

### What is the difference between Spotify v1 and v2?

v1 keeps playlist, album, artist, artist top-tracks and track metadata. v2 adds keyword search, complete artist discographies, artist playlists, related artists, discovered-on playlists, featuring playlists, similar albums and dedicated spoken-audio and user search. v2 returns the same core shapes as v1.

### Does v2 require a Spotify account?

No. The provider uses public catalogue metadata. There is no Spotify login, OAuth grant, user library scope or playback scope, and the buyer does not send a Spotify token.

### Is APIStead affiliated with Spotify?

No. APIStead is an independent first-party API and is not affiliated with or endorsed by Spotify. It reads public Spotify catalogue metadata without a buyer account.

### Does v2 include playlist creation or per-track added dates?

No. Playlist creation dates are not exposed in public playlist metadata. Per-track added dates are not exposed in public metadata. V2 does not return or fabricate either.

### Does v2 include artist genres or popularity?

No. The public catalogue source exposes world_rank but does not expose Spotify genre labels or popularity scores. V2 does not fabricate them.

### Does the v2 playlist endpoint limit tracks?

No. It pages through the complete playlist and returns every ordered track. album_limit only controls how many tracks receive album enrichment.

### What does v2 search return?

Search returns tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users with per-type counts and totals. Dedicated search routes return only podcasts, episodes, audiobooks or users. Detail routes return podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. Artist records include world_rank, and artist routes return playlists, related artists, discovered-on playlists and featuring playlists.

### What artist and recommendation routes does v2 include?

V2 includes artist playlists, related artists, discovered-on playlists, featuring playlists and similar albums based on a track. These return normalized JSON for agents.

### Does v2 include track, album or artist radio?

No. Radio is created by the playback client and is not exposed as a stable public catalogue query. V2 returns similar albums based on a track and related artists instead.

### Is the v2 discography complete?

v2 returns all albums, singles and EPs and marks complete as true when the release feed was fully read. The public Appears On section exposes up to 50 items and reports appears_on_total.

### Does v2 download or play music?

No. v2 returns metadata only. It does not download audio, stream audio, control playback or access a user library.

### How much does a v2 call cost?

Every v2 route costs $0.03 USDC on Base. The agent reads the x402 402 challenge, pays the provider wallet directly and retries. There is no API key or subscription.

## Code examples

### Python: v2 search

~~~python
import asyncio
import os

from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))


async def main():
    async with x402HttpxClient(client) as http:
        response = await http.get(
            "https://apistead.qd.je/api/v2/spotify/search",
            params={"q": "daft punk", "type": "track", "limit": 5},
        )
        response.raise_for_status()
        print(response.json())


asyncio.run(main())
~~~

### JavaScript: v2 search

~~~javascript
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const client = new x402Client();
client.register("eip155:8453", new ExactEvmScheme(account));

const paidFetch = wrapFetchWithPayment(fetch, client);
const response = await paidFetch(
  "https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=track&limit=5",
);

console.log(await response.json());
~~~

### cURL: v2 search challenge

~~~bash
curl -i "https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=track&limit=5"
~~~

### Python: v2 track

~~~python
import asyncio
import os

from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))


async def main():
    async with x402HttpxClient(client) as http:
        response = await http.get(
            "https://apistead.qd.je/api/v2/spotify/track",
            params={"id": "4cOdK2wGLETKBW3PvgPWqT"},
        )
        response.raise_for_status()
        print(response.json())


asyncio.run(main())
~~~

## Agent links

- JSON: https://x402.apistead.qd.je/api/apis/spotify-api-v2
- Markdown: https://x402.apistead.qd.je/api/apis/spotify-api-v2/md
- Routes: https://x402.apistead.qd.je/agent/routes?id=spotify-api-v2
- Receipts: https://x402.apistead.qd.je/agent/receipts?id=spotify-api-v2
- API reference: https://x402.apistead.qd.je/api
- MCP guide: https://x402.apistead.qd.je/mcp-docs
- Agent skill: https://x402.apistead.qd.je/skill
- OpenAPI: https://x402.apistead.qd.je/openapi.json
- MCP: https://apistead.qd.je/mcp
- Docs: https://apistead.qd.je/api


## Changelog

### 2.3.0 - Artist sections, similar albums and focused search

Added artist playlists, related artists, discovered-on and featuring playlists, similar albums based on a track, and dedicated podcast, episode, audiobook and user search routes. V2 now has twenty-three routes at /bin/bash.03 per call.

release · 2026-11-12 · APIStead Labs

### 2.2.0 - Podcasts, audiobooks, genres and users

Added podcast, podcast episode, episode, audiobook, audiobook chapter, genre search and public user profile routes. V2 now has fourteen routes at /bin/bash.03 per call.

release · 2026-11-12 · APIStead Labs

### 2.1.0 - Price update and release dates

V2 calls now cost /bin/bash.05 USDC. Search covers tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users. Playlists return every ordered track with no song limit. Track and release objects include release_date; artist records include world_rank. Appears On reports appears_on_total.

release · 2026-11-12 · APIStead Labs

### 2.0.1 - Full discographies and preview URLs

Discography returns all albums, singles and EPs by default. Track responses now include a 30-second preview_url when Spotify publishes one.

release · 2026-11-12 · APIStead Labs

### 2.0.0 - Spotify API v2

Added keyword search, complete artist discographies and seven v2 routes. All v2 routes are settlement-verified on Base mainnet.

release · 2026-11-12 · APIStead Labs