# Spotify API — artist monthly listeners and followers, track and album play counts, playlists, search, charts, podcasts, audiobooks and concerts

> Everything on one Spotify artist page: monthly listeners, followers, world rank, the top 5 listener cities, verified badge, biography, social links, avatar / header / gallery images, the 10 most popular tracks with their all-time play counts, latest and popular releases, the first albums / singles / compilations with totals, related artists, appears-on releases, playlists featuring the artist, the artist's own playlists, upcoming concerts and merch.
> ReefAPI engine `spotify` · 44 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/spotify/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/spotify/v1/artist — 2 credits
Everything on one Spotify artist page: monthly listeners, followers, world rank, the top 5 listener cities, verified badge, biography, social links, avatar / header / gallery images, the 10 most popular tracks with their all-time play counts, latest and popular releases, the first albums / singles / compilations with totals, related artists, appears-on releases, playlists featuring the artist, the artist's own playlists, upcoming concerts and merch.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{id, name, url, uri, verified, biography{text, type}, followers, monthly_listeners, world_rank, top_cities[]{city, region, country, listeners}, external_links[]{name, url}, images[], header_images[], gallery[], pinned_item, latest_release, popular_releases[], top_tracks[]{id, name, url, uri, track_number, disc_number, duration_ms, explicit, playable, has_video, playcount, artists[]{id, name, url}, album{id, name, url, release_date, images}, rank}, discography_counts{albums, singles, compilations, appears_on, music_videos}, albums[], singles[], compilations[], related_artists[], related_artists_total, appears_on[], discovered_on[], discovered_on_hidden, featuring_playlists[], artist_playlists[], concerts_total, concerts[], merch[]}

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_stats — 1 credit
The numbers of one artist in one small call: followers, monthly listeners, world rank, top 5 listener cities with listener counts, verified / registered flags, biography, social links and gallery.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{id, name, url, uri, verified, registered, followers, monthly_listeners, world_rank, top_cities[], biography, external_links[], images[], gallery[]}

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_top_tracks — 2 credits
The artist's 10 most popular tracks (Spotify's order) with each track's all-time play count, duration, album and artists.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{id, name, url} + results[]{id, name, url, uri, track_number, disc_number, duration_ms, explicit, playable, has_video, playcount, artists[]{id, name, url}, album{id, name, url, release_date, images}, rank} + count

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_discography — 1 credit
One page of an artist's releases: everything, or only albums / singles / compilations, newest or oldest first, with release date, label, track count, cover and copyright lines.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `type` (enum, optional, default "all") — Which releases (singular works too: album, single, compilation). [one of: all, albums, singles, compilations]
- `sort` (enum, optional, default "newest") — Order. [one of: newest, oldest]
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 20) — Rows per page (1-100).

**Returns:** artist{id, url} + results[]{id, name, url, uri, album_type, release_date, release_date_precision, label, total_tracks, playable, artists[], images[], copyrights[]} + total + page + limit + has_more + type + sort

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_related — 1 credit
Artists Spotify lists under "Fans also like" for this artist (Spotify's whole list in one call, 40 measured 2026-11-15; `total` says how many Spotify keeps).

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{id, name, url} + results[]{id, name, url, uri, verified, images} + count + total

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_appears_on — 1 credit
Releases by other artists this artist appears on. Spotify serves the first 50 to a logged-out viewer; `total` is its full count.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{...} + results[]{id, name, url, uri, album_type, release_date, release_date_precision, label, total_tracks, playable, artists[], images[], copyrights[]} + count + total

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_discovered_on — 1 credit
Playlists where listeners discovered this artist (Spotify serves the first 50; `total` is its full count). Spotify hides some entries from logged-out viewers; those are counted in `hidden_count`, not returned.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{...} + results[]{id, name, url, uri, description, format, followers, owner{id, name, url}, updated_at, images} + count + total + hidden_count

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_featuring — 1 credit
Spotify playlists featuring the artist (This Is …, Radio, editorial playlists).

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{...} + results[]{id, name, url, uri, description, format, followers, owner{id, name, url}, updated_at, images} + count + total

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_playlists — 1 credit
Public playlists the artist curates on their own profile.

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{...} + results[]{id, name, url, uri, description, format, followers, owner{id, name, url}, updated_at, images} + count + total

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_concerts — 1 credit
The artist's upcoming concerts on Spotify (date, venue, city, line-up).

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** artist{...} + results[]{id, title, url, starts_at, festival, venue, city, artists[]} + count

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/artist_radio — 3 credits
The artist's radio: the "<artist> Radio" playlist Spotify generates, with its tracks (play counts included).

**Parameters:**
- `artist_id` (string, required) — Spotify artist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-100).

**Returns:** seed{type, id, url} + playlist{id, name, url, total_items} + results[]{position, item{track}} + total + page + limit + has_more

**Example request body:**
```json
{
  "artist_id": "06HL4z0CvFAxyc27GXpf02"
}
```

### POST https://api.reefapi.com/spotify/v1/track — 3 credits
One track: all-time play count, duration, explicit / playable flags, artists, album (type, release date, label, copyrights, cover), the 30-second preview link and the full credits (writers, producers, performers with roles, and the label / distributor credited as source).

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** track{id, name, url, uri, track_number, duration_ms, explicit, playable, playability_reason, has_video, playcount, artists[], album{...}, preview_url, credits{contributors[]{name, role, role_group, artist_id, url}, sources[]}}

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_playcount — 2 credits
Just the all-time play count of one track, with its name, artists and duration — the small call for play-count tracking (one track per call; `album` returns the play count of every track on an album in one call).

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** track{id, name, url, artists[], duration_ms, playcount}

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_credits — 1 credit
Songwriters, producers, performers and other contributors of a track with their roles, plus the label / distributor credited as source.

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** track{id, name, url} + contributors[]{name, role, role_group, artist_id, url} + sources[]

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_previews — 1 credit
The public 30-second MP3 preview link of up to 50 tracks (null where Spotify publishes none).

**Parameters:**
- `track_ids` (array, required) — Up to 50 Spotify track ids, URIs or links (array, or one comma-separated string).

**Returns:** results[]{id, url, preview_url} + count

**Example request body:**
```json
{
  "track_ids": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_related — 1 credit
Tracks Spotify recommends next to this one on its track page (with play counts).

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `limit` (integer, optional, default 20) — How many tracks (1-50).

**Returns:** track{id, url} + results[]{id, name, url, uri, track_number, disc_number, duration_ms, explicit, playable, has_video, playcount, artists[]{id, name, url}, album{id, name, url, release_date, images}} + count

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_similar_albums — 1 credit
Albums Spotify lists as similar to the album this track is on.

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `limit` (integer, optional, default 20) — How many albums (1-100); Spotify keeps 60-70 per track.

**Returns:** track{id, url} + results[]{id, name, url, uri, album_type, release_date, release_date_precision, label, total_tracks, playable, artists[], images[], copyrights[]} + count + total

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/track_radio — 3 credits
The track's radio: the "<track> Radio" playlist Spotify generates, with its tracks.

**Parameters:**
- `track_id` (string, required) — Spotify track: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-100).

**Returns:** same shape as artist_radio

**Example request body:**
```json
{
  "track_id": "4uLU6hMCjMI75M1A2tKUQC"
}
```

### POST https://api.reefapi.com/spotify/v1/album — 1 credit
One album with every track and each track's all-time play count, label, release date, copyrights, disc count, other editions and more albums by the artist.

**Parameters:**
- `album_id` (string, required) — Spotify album: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** album{id, name, url, uri, album_type, release_date, release_date_precision, label, total_tracks, playable, artists[], images[], copyrights[], playability_reason, prerelease_ends_at, courtesy_line, total_discs, tracks[]{id, name, url, uri, track_number, disc_number, duration_ms, explicit, playable, has_video, playcount, artists[]{id, name, url}, album{id, name, url, release_date, images}}, other_editions[], more_by_artist[]}

**Example request body:**
```json
{
  "album_id": "4m2880jivSbbyEGAKfITCa"
}
```

### POST https://api.reefapi.com/spotify/v1/album_tracks — 1 credit
One page of an album's tracks with play counts.

**Parameters:**
- `album_id` (string, required) — Spotify album: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-300).

**Returns:** album{id, name, url} + results[]{id, name, url, uri, track_number, disc_number, duration_ms, explicit, playable, has_video, playcount, artists[]{id, name, url}, album{id, name, url, release_date, images}} + total + page + limit + has_more

**Example request body:**
```json
{
  "album_id": "4m2880jivSbbyEGAKfITCa"
}
```

### POST https://api.reefapi.com/spotify/v1/playlist — 3 credits
One playlist: name, description, owner, followers, collaborators, last update, chart info for chart playlists, and its first rows — each with position, date added, the track's play count, BPM and musical key, and for chart playlists the chart position, previous position, movement and plays.

**Parameters:**
- `playlist_id` (string, required) — Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `limit` (integer, optional, default 100) — How many rows (1-100).

**Returns:** playlist{id, name, url, uri, description, format, followers, total_items, owner, members[], chart{entity_type, rank_type, new_entries}, updated_at, images, items[]{position, added_at, added_by, chart{position, previous_position, movement, plays}, item{track fields + audio{bpm, key, mode, camelot}}}, unavailable_rows}

**Example request body:**
```json
{
  "playlist_id": "37i9dQZEVXbMDoHDwVN2tF"
}
```

### POST https://api.reefapi.com/spotify/v1/playlist_tracks — 2 credits
One page of a playlist's rows (tracks and episodes) in playlist order, same row shape as `playlist`.

**Parameters:**
- `playlist_id` (string, required) — Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 100) — Rows per page (1-100).

**Returns:** playlist{id, name, url, followers, total_items} + results[] + total + page + limit + has_more

**Example request body:**
```json
{
  "playlist_id": "37i9dQZEVXbMDoHDwVN2tF"
}
```

### POST https://api.reefapi.com/spotify/v1/playlist_followers — 1 credit
Just the follower count of a playlist (the cheap call for follower tracking).

**Parameters:**
- `playlist_id` (string, required) — Spotify playlist: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** playlist{id, url, followers}

**Example request body:**
```json
{
  "playlist_id": "37i9dQZEVXbMDoHDwVN2tF"
}
```

### POST https://api.reefapi.com/spotify/v1/search — 2 credits
Spotify search. `type: all` returns the top results plus the first rows and the total of every section (tracks, artists, albums, playlists, podcasts, episodes, audiobooks, genres, users); any other type returns one paged list (up to 100 rows per page). Spotify serves the first 1000 results of a query (page × limit ≤ 1000). Rows inside one page are always distinct, but Spotify re-ranks track results between requests, so consecutive track pages can repeat rows (measured: "love", 4 pages of 25, 23 repeats; artists and playlists 0) — ask for up to 100 rows in one page to avoid it.

**Parameters:**
- `query` (string, required) — Search words.
- `type` (enum, optional, default "all") — What to search for (singular works too: track, artist, album, playlist, podcast, episode, audiobook, genre, user). [one of: all, tracks, artists, albums, playlists, podcasts, episodes, audiobooks, genres, users]
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 20) — Rows per page (1-100).

**Returns:** type all: top_results[] + featured[] + tracks{total, results[]} + artists{...} + albums{...} + playlists{...} + podcasts{...} + episodes{...} + audiobooks{...} + genres{...} + users{...}; one type: results[] + total + page + limit + has_more

**Example request body:**
```json
{
  "query": "daft punk",
  "type": "tracks"
}
```

### POST https://api.reefapi.com/spotify/v1/search_suggestions — 1 credit
Autocomplete as typed into the Spotify search box: query completions plus the artists / tracks / albums / playlists it suggests.

**Parameters:**
- `query` (string, required) — What the user typed so far.
- `limit` (integer, optional, default 10) — Maximum suggestions (1-20).

**Returns:** query + suggestions[] + results[]{type, id, name, url, …}

**Example request body:**
```json
{
  "query": "daft punk"
}
```

### POST https://api.reefapi.com/spotify/v1/charts — 2 credits
Spotify's public global weekly chart (charts.spotify.com): Top Songs, Top Albums or Top Artists, 50 rows with rank, previous rank, peak rank and date, weeks on chart and entry status; songs carry labels, producers and songwriters.

**Parameters:**
- `chart` (enum, optional, default "tracks") — Which global weekly chart (track / album / artist work too). [one of: tracks, albums, artists]

**Returns:** chart{name, alias, date, period, country, earliest_date, latest_date} + highlights[] + results[]{rank, previous_rank, peak_rank, peak_date, weeks_on_chart, consecutive_weeks, entry_status, track|album|artist{id, name, url, image, artists[], labels[], producers[], songwriters[], release_date}} + count

**Example request body:**
```json
{
  "chart": "tracks"
}
```

### POST https://api.reefapi.com/spotify/v1/country_chart — 3 credits
A country's chart playlist on Spotify: `top_songs` ("Top Songs - <country>", weekly) or `top_50` ("Top 50 - <country>", daily), each row with chart position, previous position, movement, plays and the track's all-time play count. `country: global` for the global playlists.

**Parameters:**
- `country` (string, required) — Two-letter country code (e.g. DE, US, BR, TR) or `global`.
- `chart` (enum, optional, default "top_songs") — Which chart playlist (also: weekly, daily, top50). [one of: top_songs, top_50]

**Returns:** chart{name, country, period, updated_at, new_entries, playlist{id, url, followers}} + results[]{position, previous_position, movement, plays, track{...}} + count

**Example request body:**
```json
{
  "country": "DE"
}
```

### POST https://api.reefapi.com/spotify/v1/home — 2 credits
The home feed Spotify shows logged-out visitors (US): trending songs, popular artists, albums, radio and featured charts, shelf by shelf.

**Parameters:**
- `section_limit` (integer, optional, default 10) — Items per shelf (1-50).

**Returns:** greeting + sections[]{id, title, subtitle, total, results[]{type, id, name, url, …}} + count

**Example request body:**
```json
{
  "section_limit": 10
}
```

### POST https://api.reefapi.com/spotify/v1/browse_categories — 1 credit
Every Browse-all category (genres, moods, charts, podcasts …) with its id for `browse_category`.

**Parameters:** none

**Returns:** results[]{id, name, url, uri, images, color} + count

### POST https://api.reefapi.com/spotify/v1/browse_category — 3 credits
One browse category page (e.g. Pop): its shelves with their first playlists / albums; a shelf's `id` pages further with `browse_section`.

**Parameters:**
- `category_id` (string, required) — Category id from `browse_categories` (or the open.spotify.com/genre/<id> link).
- `section_limit` (integer, optional, default 20) — Items per shelf (1-50).

**Returns:** category{id, name, url, images} + sections[]{id, title, subtitle, total, results[]} + count

**Example request body:**
```json
{
  "category_id": "0JQ5DAqbMKFEC4WFtoNRpw"
}
```

### POST https://api.reefapi.com/spotify/v1/browse_section — 1 credit
One browse shelf, paged.

**Parameters:**
- `section_id` (string, required) — Shelf id from `browse_category` sections[].id.
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-100).

**Returns:** section{id, title, subtitle} + results[] + total + page + limit + has_more

**Example request body:**
```json
{
  "section_id": "0JQ5IMCbQBLBdLiG2IRf0j"
}
```

### POST https://api.reefapi.com/spotify/v1/country_hub — 1 credit
A country's music hub on Spotify: its chart playlists, popular artists, popular albums and trending songs.

**Parameters:**
- `country` (string, required) — Two-letter country code.

**Returns:** country + charts[] + popular_artists[] + popular_albums[] + trending_songs[]

**Example request body:**
```json
{
  "country": "DE"
}
```

### POST https://api.reefapi.com/spotify/v1/podcast — 3 credits
One podcast: publisher, description, rating and rating count, topics, explicit flag, episode order, trailer, total episodes and the latest 10 episodes.

**Parameters:**
- `podcast_id` (string, required) — Spotify podcast (show): the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** podcast{id, name, url, uri, publisher, description, media_type, consumption_order, explicit, playable, rating{average, count}, total_episodes, topics[], images, trailer, latest_episodes[]}

**Example request body:**
```json
{
  "podcast_id": "4rOoJ6Egrf8K2IrywzwOMk"
}
```

### POST https://api.reefapi.com/spotify/v1/podcast_episodes — 2 credits
One page of a podcast's episodes, newest first.

**Parameters:**
- `podcast_id` (string, required) — Spotify podcast (show): the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-100).

**Returns:** podcast{id, url} + results[]{id, name, url, description, release_date, released_at, duration_ms, explicit, playable, paywalled, media_types, preview_url, images} + total + page + limit + has_more

**Example request body:**
```json
{
  "podcast_id": "4rOoJ6Egrf8K2IrywzwOMk"
}
```

### POST https://api.reefapi.com/spotify/v1/episode — 1 credit
One podcast episode: description, release time, duration, explicit / paywall flags, media types, transcript flag, 30-second preview and its podcast.

**Parameters:**
- `episode_id` (string, required) — Spotify podcast episode: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** episode{id, name, url, uri, description, release_date, released_at, duration_ms, explicit, playable, paywalled, media_types, preview_url, images, has_transcript, playability_reason, podcast{id, name, url, publisher}}

**Example request body:**
```json
{
  "episode_id": "7Hf1JDw7XuetyEqlrIQLaG"
}
```

### POST https://api.reefapi.com/spotify/v1/audiobook — 3 credits
One audiobook (US store): authors, narrators, publisher, publish date, duration, rating, price and list price, genres, copyrights, trailer, total chapters and the first 10 chapters.

**Parameters:**
- `audiobook_id` (string, required) — Spotify audiobook: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** audiobook{id, name, url, uri, authors[], narrators[], publisher, publish_date, duration_ms, description, summary, explicit, playable, is_prerelease, rating, price{price, list_price, currency}, genres[], copyrights[], total_chapters, trailer, first_chapters[]}

**Example request body:**
```json
{
  "audiobook_id": "2IEBhnu61ieYGFRPEJIO40"
}
```

### POST https://api.reefapi.com/spotify/v1/audiobook_chapters — 1 credit
One page of an audiobook's chapters in reading order.

**Parameters:**
- `audiobook_id` (string, required) — Spotify audiobook: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).
- `page` (integer, optional, default 1) — 1-based page number.
- `limit` (integer, optional, default 50) — Rows per page (1-100).

**Returns:** audiobook{id, url} + results[]{number, id, name, url, duration_ms, …} + total + page + limit + has_more

**Example request body:**
```json
{
  "audiobook_id": "2IEBhnu61ieYGFRPEJIO40"
}
```

### POST https://api.reefapi.com/spotify/v1/chapter — 1 credit
One audiobook chapter.

**Parameters:**
- `chapter_id` (string, required) — Spotify audiobook chapter: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** chapter{id, name, url, description, duration_ms, explicit, playable, preview_url, audiobook{...}}

**Example request body:**
```json
{
  "chapter_id": "4twr9j4P9xgnyNFYpuhWDa"
}
```

### POST https://api.reefapi.com/spotify/v1/user — 1 credit
A public Spotify user profile: display name, avatar, verified flag, public playlist count and the first 10 public playlists with follower counts.

**Parameters:**
- `user_id` (string, required) — Spotify username (e.g. `spotify`), the spotify:user: URI or the open.spotify.com/user/<name> link.

**Returns:** user{id, name, url, verified, total_public_playlists, images, public_playlists[]}

**Example request body:**
```json
{
  "user_id": "spotify"
}
```

### POST https://api.reefapi.com/spotify/v1/user_playlists — 1 credit
A user's public playlists with follower counts. Spotify serves a logged-out viewer the first 10 (offset and larger limits are ignored, measured); `total` is the user's full public playlist count.

**Parameters:**
- `user_id` (string, required) — Spotify username (e.g. `spotify`), the spotify:user: URI or the open.spotify.com/user/<name> link.

**Returns:** user{id, name, url} + results[]{id, name, url, uri, description, format, followers, owner{id, name, url}, updated_at, images} + count + total + has_more

**Example request body:**
```json
{
  "user_id": "spotify"
}
```

### POST https://api.reefapi.com/spotify/v1/concert_locations — 1 credit
Cities matching a name, each with the geohash `concerts_nearby` takes.

**Parameters:**
- `query` (string, required) — City name.

**Returns:** results[]{name, full_name, country, geohash, geoname_id} + count

**Example request body:**
```json
{
  "query": "daft punk"
}
```

### POST https://api.reefapi.com/spotify/v1/concerts_nearby — 3 credits
Popular upcoming concerts Spotify lists near a city.

**Parameters:**
- `location` (string, required) — City name (first match is used) or a geohash from `concert_locations`.

**Returns:** location{name, geohash} + results[]{id, title, url, starts_at, festival, venue, city, artists[]} + count

**Example request body:**
```json
{
  "location": "berlin"
}
```

### POST https://api.reefapi.com/spotify/v1/concert — 1 credit
One concert: date and doors time, venue with coordinates, line-up, genres, ticket sellers with links, sale window and price range, festival flag, age restriction and related concerts.

**Parameters:**
- `concert_id` (string, required) — Spotify concert: the 22-character id, the spotify: URI or the open.spotify.com link (spotify.link short links too).

**Returns:** concert{id, title, url, starts_at, doors_open_at, status, festival, age_restriction, venue{id, name, city, region, country, metro_area, latitude, longitude}, artists[], genres[], tickets[]{seller, url, sale_type, availability, min_price, max_price, currency, first_party, sale_starts_at, sale_ends_at}, related_concerts[]}

**Example request body:**
```json
{
  "concert_id": "5aVmPSGVZQza7QII6UjVbe"
}
```

### POST https://api.reefapi.com/spotify/v1/resolve — 0 credits
Any Spotify link, URI or spotify.link short link → its type, id, canonical link and URI (no lookup of the item itself).

**Parameters:**
- `link` (string, required) — open.spotify.com link, spotify: URI or spotify.link short link.

**Returns:** input + type + id + url + uri + expanded_url

**Example request body:**
```json
{
  "link": "https://open.spotify.com/intl-de/track/4uLU6hMCjMI75M1A2tKUQC?si=x"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=spotify
- Human docs page: https://reefapi.com/docs/spotify
- Overview page: https://reefapi.com/spotify-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
