Docs menu

API Reference

Spotify API endpoints

30 Spotify API endpoints for web scraping workflows, with REST paths, authentication requirements, parameters, examples, and MCP tool metadata where supported.

Try Playground Examples

GET/spotify/albumapiKey3 credits/request

Retrieve Spotify album details

Returns normalized Spotify Web Player album metadata and tracks from private Pathfinder responses.

Params: uri:query, id:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/album/tracksapiKey3 credits/request

Retrieve Spotify album tracks

Returns normalized Spotify Web Player album tracks from private Pathfinder responses.

Params: uri:query, id:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/albums/searchapiKey3 credits/request

Search Spotify albums

Returns normalized Spotify Web Player album search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Params: q:query, offset:query, limit:query, number_of_top_results:query, include_audiobooks:query, include_pre_releases:query, include_album_pre_releases:query, include_authors:query, include_episode_content_ratings_v2:query, x-api-key:header

Details Open in Playground

GET/spotify/artistapiKey3 credits/request

Retrieve Spotify artist details

Returns normalized Spotify Web Player artist overview data from private Pathfinder responses.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/artist/albumsapiKey3 credits/request

Retrieve Spotify artist albums

Returns artist discography items from Spotify Web Player private Pathfinder responses.

Params: uri:query, id:query, type:query, order:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/artist/playlistsapiKey3 credits/request

Retrieve Spotify artist playlists

Returns artist playlists from Spotify Web Player private Pathfinder responses.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/artist/relatedapiKey3 credits/request

Retrieve Spotify related artists

Returns related artists from Spotify Web Player private Pathfinder responses.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/artists/searchapiKey3 credits/request

Search Spotify artists

Returns normalized Spotify Web Player artist search results for a search term.

Params: q:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/audiobookapiKey3 credits/request

Retrieve Spotify audiobook details

Returns Spotify Web Player audiobook metadata from private Pathfinder responses. Spotify exposes audiobooks through show URIs.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/audiobook/chaptersapiKey3 credits/request

Retrieve Spotify audiobook chapters

Returns audiobook chapters from Spotify Web Player private Pathfinder responses.

Params: uri:query, id:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/audiobooks/searchapiKey3 credits/request

Search Spotify audiobooks

Returns normalized Spotify Web Player audiobook search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Details Open in Playground

GET/spotify/chapterapiKey2 credits/request

Retrieve Spotify audiobook chapter details

Returns a Spotify chapter from the same private Pathfinder operation used for episodes and chapters.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/episodes/searchapiKey3 credits/request

Search Spotify episodes

Returns normalized Spotify Web Player episode search results for a search term.

Params: q:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/featured-charts-by-countryapiKey3 credits/request

Retrieve Spotify featured charts by country

Returns normalized Spotify country hub content from Spotify's countryHubContent Pathfinder response. Defaults to the CHARTS content shelf for the requested country.

Params: country_code:query, content_id:query, x-api-key:header

Details Open in Playground

GET/spotify/genreapiKey3 credits/request

Retrieve Spotify genre page

Returns normalized sections and items from Spotify's browsePage Pathfinder response for a Spotify genre or page URI.

Params: uri:query, page_offset:query, page_limit:query, section_offset:query, section_limit:query, include_episode_content_ratings_v2:query, x-api-key:header

Details Open in Playground

GET/spotify/homeapiKey3 credits/request

Retrieve Spotify home sections

Returns normalized shelves and items from Spotify's Web Player home Pathfinder response. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Params: time_zone:query, sp_t:query, facet:query, section_items_limit:query, include_episode_content_ratings_v2:query, x-api-key:header

Details Open in Playground

GET/spotify/playlistapiKey3 credits/request

Retrieve Spotify playlist details

Returns normalized Spotify Web Player playlist metadata and items from Spotify's fetchPlaylist Pathfinder response. Provide either uri or id; defaults to a known public playlist when omitted.

Params: uri:query, id:query, offset:query, limit:query, enable_watch_feed_entrypoint:query, include_episode_content_ratings_v2:query, x-api-key:header

Details Open in Playground

GET/spotify/playlists/searchapiKey3 credits/request

Search Spotify playlists

Returns normalized Spotify Web Player playlist search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Details Open in Playground

GET/spotify/popular-by-countryapiKey3 credits/request

Retrieve Spotify popular by country

Returns normalized Spotify country hub shelves from Spotify's countryHubsPage Pathfinder response. The country_code parameter accepts Spotify popular-in country codes from open.spotify.com/popular-in/us.

Params: country_code:query, x-api-key:header

Details Open in Playground

GET/spotify/profileapiKey3 credits/request

Retrieve Spotify public profile

Returns normalized public profile metadata and preview playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.

Params: username:query, uri:query, url:query, playlist_limit:query, artist_limit:query, episode_limit:query, x-api-key:header

Details Open in Playground

GET/spotify/profile/followersapiKey3 credits/request

Retrieve Spotify public profile followers

Returns normalized public follower profiles from Spotify's Web Player user-profile service. Spotify exposes this as a public anonymous response for some profiles; private or restricted profiles may return an upstream error.

Params: username:query, uri:query, url:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/profile/playlistsapiKey3 credits/request

Retrieve Spotify public profile playlists

Returns normalized public playlists from Spotify's Web Player user-profile service. Provide username, uri, or url; defaults to Spotify's official profile.

Params: username:query, uri:query, url:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/profiles/searchapiKey3 credits/request

Search Spotify profiles

Returns normalized Spotify Web Player profile search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Details Open in Playground

GET/spotify/searchapiKey3 credits/request

Search Spotify catalog

Returns normalized Spotify Web Player catalog search results across tracks, artists, albums, playlists, shows, episodes, audiobooks, and top results. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Params: q:query, offset:query, limit:query, number_of_top_results:query, include_audiobooks:query, include_artist_has_concerts_field:query, include_pre_releases:query, include_album_pre_releases:query, include_authors:query, include_episode_content_ratings_v2:query, is_prefix:query, x-api-key:header

Details Open in Playground

GET/spotify/sectionapiKey3 credits/request

Retrieve Spotify browse section

Returns normalized items from Spotify's browseSection Pathfinder response for a Spotify section URI.

Params: uri:query, offset:query, limit:query, include_episode_content_ratings_v2:query, x-api-key:header

Details Open in Playground

GET/spotify/shows/searchapiKey3 credits/request

Search Spotify shows

Returns normalized Spotify Web Player show search results for a search term.

Params: q:query, offset:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/trackapiKey2 credits/request

Retrieve Spotify track details

Returns normalized Spotify Web Player track metadata from Spotify's getTrack Pathfinder response. Provide either uri or id; defaults to a known public track when omitted.

Params: uri:query, id:query, x-api-key:header

Details Open in Playground

GET/spotify/track/recommendedapiKey2 credits/request

Retrieve Spotify recommended tracks

Returns normalized recommended Spotify entities from the internalLinkRecommenderTrack Pathfinder response.

Params: uri:query, id:query, limit:query, x-api-key:header

Details Open in Playground

GET/spotify/track/similar-albumsapiKey3 credits/request

Retrieve Spotify track similar albums

Returns normalized albums from the similarAlbumsBasedOnThisTrack Pathfinder response.

Params: uri:query, id:query, limit:query, albums_only:query, x-api-key:header

Details Open in Playground

GET/spotify/tracks/searchapiKey3 credits/request

Search Spotify tracks

Returns normalized Spotify Web Player track search results for a search term. The endpoint fetches anonymous Spotify credentials at request time; caller-supplied Spotify bearer or client tokens are not required.

Details Open in Playground

Back to docs