---
title: "Spotify API: JSON data, 18 endpoints, 1 credit per call"
description: "Get Spotify data as structured JSON with one API key: search, search suggestions, album and album tracks. Free credits every month."
url: https://perceptlayer.com/apis/spotify
---

[APIs](https://perceptlayer.com/apis) / [Apps and media](https://perceptlayer.com/verticals/apps) / Spotify

1 credit per call 18 endpoints

# Spotify API

Get Spotify data as structured JSON with one API key: search, search suggestions, album and album tracks. Free credits every month.

[Get a free API key](https://perceptlayer.com/signup) Run it below

Spotify

GET /v1/spotify/get-many 

```
curl "https://api.perceptlayer.com/v1/spotify/get-many" \
  -H "X-API-Key: $API_KEY"
```

cURL 1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

## Run this API

cURL shell 

```
curl "https://api.perceptlayer.com/v1/spotify/get-many" \
  -H "X-API-Key: $API_KEY"
```

Spotify · 18 endpoints

## Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

| Endpoint | Required parameters | Cost |
| --- | --- | --- |
| [GET `/v1/spotify/album`](https://perceptlayer.com/apis/spotify/album) | `id` | 1 credit |
| [GET `/v1/spotify/album-tracks`](https://perceptlayer.com/apis/spotify/album-tracks) | `id` +2 optional | 1 credit |
| [GET `/v1/spotify/artist`](https://perceptlayer.com/apis/spotify/artist) | `id` | 1 credit |
| [GET `/v1/spotify/artist-discography`](https://perceptlayer.com/apis/spotify/artist-discography) | `id` +2 optional | 1 credit |
| [GET `/v1/spotify/artist-related`](https://perceptlayer.com/apis/spotify/artist-related) | `id` | 1 credit |
| [GET `/v1/spotify/artist-top-tracks`](https://perceptlayer.com/apis/spotify/artist-top-tracks) | `id` | 1 credit |
| [GET `/v1/spotify/charts`](https://perceptlayer.com/apis/spotify/charts) | `key` +2 optional | 1 credit |
| [GET `/v1/spotify/discovery-audio-mix-seed`](https://perceptlayer.com/apis/spotify/discovery-audio-mix-seed) | `track_id` | 1 credit |
| [GET `/v1/spotify/episode`](https://perceptlayer.com/apis/spotify/episode) | `id` | 1 credit |
| [GET `/v1/spotify/get-many`](https://perceptlayer.com/apis/spotify/get-many) | none +2 optional | 1 credit |
| [GET `/v1/spotify/playlist`](https://perceptlayer.com/apis/spotify/playlist) | `id` | 1 credit |
| [GET `/v1/spotify/playlist-tracks`](https://perceptlayer.com/apis/spotify/playlist-tracks) | `id` +2 optional | 1 credit |
| [GET `/v1/spotify/search`](https://perceptlayer.com/apis/spotify/search) | `q` +2 optional | 1 credit |
| [GET `/v1/spotify/search-suggestions`](https://perceptlayer.com/apis/spotify/search-suggestions) | `q` | 1 credit |
| [GET `/v1/spotify/show`](https://perceptlayer.com/apis/spotify/show) | `id` | 1 credit |
| [GET `/v1/spotify/show-episodes`](https://perceptlayer.com/apis/spotify/show-episodes) | `id` +2 optional | 1 credit |
| [GET `/v1/spotify/track`](https://perceptlayer.com/apis/spotify/track) | `id` | 1 credit |
| [GET `/v1/spotify/track-colors`](https://perceptlayer.com/apis/spotify/track-colors) | `image_uri` | 1 credit |

Overview

## About the Spotify API

## What you can get

The Spotify API returns search, search suggestions, album and album tracks as clean JSON. Each successful call costs one credit, and calls that fail are free.

Apps and media JSON REST MCP

### More apps and media APIs

[Apple App Store](https://perceptlayer.com/apis/apple-app-store) [Bandcamp](https://perceptlayer.com/apis/bandcamp) [Genius](https://perceptlayer.com/apis/genius) [GitHub](https://perceptlayer.com/apis/github) [Google Play](https://perceptlayer.com/apis/google-play) [Product Hunt](https://perceptlayer.com/apis/producthunt) [Steam](https://perceptlayer.com/apis/steam)

Use cases

### Track artists' top tracks and discographies

`Use the Spotify API to track artists' top tracks and discographies` 

### Monitor charts

`Use the Spotify API to monitor charts` 

### Map related artists for discovery and recommendations

`Use the Spotify API to map related artists for discovery and recommendations` 

FAQ

## Questions

**How much does the Spotify API cost?**

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

**What format are responses in?**

Every endpoint returns JSON, with no HTML parsing on your side.

**Do I need a separate key for Spotify?**

No. One key works for every API in the catalogue.

## Try the Spotify API with 1,000 free credits

No credit card. Failed calls are never billed.

[Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)
