GET/spotify/albumapiKey3 credits/request
Returns a Spotify album from `uri` (a Spotify URI or open.spotify.com URL) or `id`: name, album type, artists, release date, copyrights, cover images, total tracks and duration. The `tracks` page is set by `offset` (default 0) and `limit` (1 to 50, default 50). A missing or invalid identifier returns 400.
Optional: uri, id, offset, limit.
Sampled 14 Oct 2026: 18 items. Filled in every item: uri, title, externalUrl. In the sample: uri: “spotify:track:6OmhkSOpvYBokMKQxpIGx2” and 17 other values; externalUrl: open.spotify.com; title: “Global Warming (feat. Sensato)” and 17 other values.
Open in Playground
GET/spotify/album/tracksapiKey3 credits/request
Lists the tracks of a Spotify album, identified by `uri` (a Spotify URI or open.spotify.com URL) or `id`. `offset` defaults to 0 and `limit` runs 1 to 50, default 50. Each track has its title, URI, subtitle, image and URL. The album's name, artists and track total come back alongside. An invalid identifier returns 400.
Optional: uri, id, offset, limit.
Sampled 14 Oct 2026: 18 items. Filled in every item: uri, title, externalUrl. In the sample: uri: “spotify:track:6OmhkSOpvYBokMKQxpIGx2” and 17 other values; externalUrl: open.spotify.com; title: “Global Warming (feat. Sensato)” and 17 other values.
Open in Playground
GET/spotify/albums/searchapiKey3 credits/request
Returns Spotify album search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 52 items. Filled in every item: uri, title, externalUrl. Not in every item: type (24), imageUrl (24), images (24). In the sample: uri: “spotify:album:0Wtp1qSPNv4SmtwmPf8x9n” and 51 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “Hello” and 45 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/artistapiKey3 credits/request
Returns a Spotify artist's profile by artist URI, `open.spotify.com` URL or id: name, verified flag, follower count, monthly listeners (`monthlyUsers`), biography and images, plus top tracks, selected discography, related artists and artist playlists when Spotify returns them.
Optional: uri, id.
Sampled 14 Oct 2026: 10 items. Filled in every item: uri, title, imageUrl, images, externalUrl. In the sample: uri: “spotify:track:3C0nOe05EIt1390bVABLyN” and 9 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “On The Floor” and 9 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/artist/albumsapiKey3 credits/request
Returns an artist's Spotify discography by artist URI, `open.spotify.com` URL or id. Choose `type` (`album`, `single`, `compilation`, `appears_on` or `all`; default `album`) and `order` (default `date_desc`), and page with `offset` and `limit` (1-50, default 50). Each item has a type, title, subtitle, Spotify URI, external URL and images; `total` gives the full count.
Optional: uri, id, type (5 allowed values: album, single, compilation, appears_on, all), order (4 allowed values: date_desc, date_asc, name_asc, name_desc), offset, limit.
Sampled 14 Oct 2026: 22 items. Filled in every item: uri, title, imageUrl, images, externalUrl. In the sample: uri: “spotify:album:4Lkkfpt8ZkDmw4viHHi0IM” and 21 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “PITCOIN” and 21 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/artist/playlistsapiKey3 credits/request
Returns the Spotify playlists associated with an artist, by artist URI, `open.spotify.com` URL or id. Each playlist has a title, subtitle, description, Spotify URI, external URL and images. Some artists have no playlists, in which case `items` is empty.
Optional: uri, id.
Sampled 14 Oct 2026: 5 items. Filled in every item: uri, type, title, description, imageUrl, images, externalUrl. In the sample: uri: “spotify:playlist:4n7OwdXR0saBXWlHdOuiT4” and 4 other values; imageUrl: image-cdn-fa.spotifycdn.com and 1 other host; description: median 116 characters; images: median 1 entry; title: “Mr. Worldwide's Dance Party” and 4 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/artist/relatedapiKey3 credits/request
Returns the artists Spotify lists as related to a given artist, by artist URI, `open.spotify.com` URL or id. Each related artist has a title, Spotify URI, external URL and images. An invalid identifier returns `400`.
Optional: uri, id.
Sampled 14 Oct 2026: 40 items. Filled in every item: uri, title, imageUrl, images, externalUrl. In the sample: uri: “spotify:artist:0jnsk9HBra6NMjO2oANoPY” and 39 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “Flo Rida” and 39 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/artists/searchapiKey3 credits/request
Searches Spotify for artists matching a term, with `offset` and `limit` (1-50). Each artist has a title, Spotify URI, external URL and images. Matching artists are returned in both `results` and `artists`.
Required: q. Optional: offset, limit.
Sampled 14 Oct 2026: 78 items. Filled in every item: uri, title, externalUrl. Not in every item: type (29), imageUrl (28), images (28). In the sample: uri: “spotify:artist:1bj5GrcLom5gZFF5t949Xl” and 77 other values; externalUrl: open.spotify.com; images: median 3 entries; title: “Martin Solveig” and 67 other values; imageUrl: i.scdn.co.
Open in Playground
GET/spotify/audiobookapiKey3 credits/request
Returns a Spotify audiobook by `uri` or `id`; Spotify identifies audiobooks with show URIs (`spotify:show:...`). The response has name, authors, narrators, publisher, description, `totalChapters`, explicit flag and cover images. Passing a podcast show instead of an audiobook returns an upstream error, and an invalid identifier returns 400.
Optional: uri, id.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: uri: “spotify:show:40ygvasZaqVMMBkgYoUy8C”; imageUrl: i.scdn.co; description: 2,040 characters; narrators: 1 entry; type: “Audiobook”; name: “Atomic Habits: An Easy & Proven Way to Build Good Habits &…”; publisher: “James Clear”; mediaType: “AUDIO”.
Open in Playground
GET/spotify/audiobook/chaptersapiKey3 credits/request
Returns the chapters of a Spotify audiobook by URI, `open.spotify.com` URL or id, with `offset` and `limit` (1-50, default 50). Each chapter has its name, description, duration in milliseconds, release date, explicit and playable flags, Spotify URI, external URL and images; `total` gives the chapter count.
Optional: uri, id, offset, limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: uri, type, name, durationMs, imageUrl, images, externalUrl. In the sample: durationMs: 17,589 to 1,490,041, median 921,327; uri: “spotify:episode:4vxkqkMeYRgpMzQa7yyKN0” and 9 other values; imageUrl: i.scdn.co; images: median 3 entries; name: “Opening Credits” and 9 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/audiobooks/searchapiKey3 credits/request
Returns Spotify audiobook search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 57 items. Filled in every item: uri, title. Not in every item: type (30), description (30), imageUrl (30), images (30), externalUrl (30). In the sample: uri: “spotify:show:40ygvasZaqVMMBkgYoUy8C” and 56 other values; imageUrl: i.scdn.co; description: median 1,225 characters; images: median 3 entries; title: “Atomic Habits: An Easy & Proven Way to Build Good Habits &…” and 56 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/chapterapiKey2 credits/request
Returns a Spotify audiobook chapter by `uri` or `id`; chapters are often addressed with `spotify:episode:` identifiers. Fields include name, description, duration, release date, explicit and paywall flags, playability reasons, preview audio URL, cover images and the parent show. An invalid identifier returns 400.
Optional: uri, id.
Sampled 14 Oct 2026: 29 fields returned with a value. In the sample: releaseDate: 2026-05-08; durationMs: 9,761,982; uri: “spotify:episode:2C2Y5kNq7qCVOVhbA0G3os”; imageUrl: i.scdn.co; isExplicit: true; description: 529 characters; mediaTypes: 2 entries; type: “Episode”.
Open in Playground
GET/spotify/episodes/searchapiKey3 credits/request
Searches Spotify podcast episodes for the search term `q`, paged with `offset` (default 0) and `limit` (1 to 50). Each episode has its title, URI, description, publisher, images and Spotify URL. Episode matches appear under both `results` and `episodes`. A missing `q` returns 400.
Required: q. Optional: offset, limit.
Sampled 14 Oct 2026: 30 items. Filled in every item: uri, type, title, description, imageUrl, images, externalUrl. In the sample: uri: “spotify:episode:3hqE3ujrS5cpX70BcUDsa9” and 29 other values; imageUrl: i.scdn.co; description: median 1,706 characters; images: median 3 entries; title: “ChatGPT Work 1 HOUR COURSE: Automate Anything!” and 29 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/featured-charts-by-countryapiKey3 credits/request
Returns Spotify country hub content. Defaults to the CHARTS content shelf for the requested country.
Optional: country_code, content_id (4 allowed values: CHARTS, POPULAR_ALBUMS, POPULAR_ARTISTS, TRENDING_SONGS).
Sampled 14 Oct 2026: 4 items. Filled in every item: uri, type, title, subtitle, description, imageUrl, images, attributes and 1 more. In the sample: uri: “spotify:user:spotifycharts:playlist:37i9dQZEVXbIZK8aUquyx8” and 3 other values; imageUrl: charts-images.scdn.co; images: median 1 entry; title: “Top Songs - Indonesia” and 3 other values; description: “Your weekly update of the most played tracks right now - In…” and 3 other values.
Open in Playground
GET/spotify/genreapiKey3 credits/request
Returns the sections of a Spotify genre or browse page for `uri` (default `spotify:page:0JQ5DAB3zgCauRwnvdEQjJ`). Each section has a title, type, `totalCount` and items with title, subtitle, image and Spotify URL. `page_limit` and `section_limit` default to 10 and run 1 to 50; matching offsets default to 0.
Optional: uri, page_offset, page_limit, section_offset, section_limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 1 item. Filled in every item: uri, type, totalCount, items. In the sample: uri: “spotify:section:0JQ5DAob0LrW8pqFzVs4ut”; items: median 10 entries; type: “BrowseGenericSectionData”.
Open in Playground
GET/spotify/homeapiKey3 credits/request
Returns Spotify home shelves and items. Caller-supplied Spotify bearer or client tokens are not required.
Optional: time_zone, sp_t, facet, section_items_limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 5 items. Filled in every item: uri, type, title, totalCount, items. In the sample: totalCount: 4 to 50, median 30; uri: “spotify:section:0JQ5DB5E8N831KzFzsBBQ2” and 4 other values; items: median 10 entries; title: “Trending songs” and 4 other values.
Open in Playground
GET/spotify/playlistapiKey3 credits/request
Returns Spotify playlist metadata and items. Provide either uri or id; defaults to a known public playlist when omitted.
Optional: uri, id, offset, limit, enable_watch_feed_entrypoint, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 25 items. Filled in every item: uri, type, title, imageUrl, images, externalUrl. In the sample: uri: “spotify:track:7yi7r8GxBX82iwVet5VBG5” and 24 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “寂寞圓舞” and 24 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/playlists/searchapiKey3 credits/request
Returns Spotify playlist search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 52 items. Filled in every item: uri, type, title, externalUrl. Not in every item: description (23), imageUrl (49), images (49). In the sample: type: Playlist (30), User (22); uri: “spotify:playlist:2yAdfFOQ2lbhA03Jc9oFvx” and 51 other values; imageUrl: image-cdn-ak.spotifycdn.com and 6 other hosts; images: median 1 entry; title: “im not his bitch no more” and 51 other values; description: “hello??? (thank you for the saves 🫂 i follow back ❤️)” and 22 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/popular-by-countryapiKey3 credits/request
Returns Spotify country hub shelves. The country_code parameter accepts Spotify popular-in country codes from open.spotify.com/popular-in/us.
Optional: country_code.
Sampled 14 Oct 2026: 184 items. Filled in every item: code, name. In the sample: name: “Andorra” and 183 other values.
Open in Playground
GET/spotify/profileapiKey3 credits/request
Returns public Spotify profile metadata and preview playlists. Provide username, uri, or url; defaults to Spotify's official profile.
Optional: username, uri, url, playlist_limit, artist_limit, episode_limit.
Sampled 14 Oct 2026: 10 items. Filled in every item: uri, id, name, imageUrl, followersCount, ownerName, ownerUri, ownerUsername and 2 more. In the sample: followersCount: 4,154,912 to 33,729,177, median 7,638,922; imageUrl: i.scdn.co; externalUrl: open.spotify.com; ownerUrl: open.spotify.com.
Open in Playground
GET/spotify/profile/followersapiKey3 credits/request
Returns public Spotify follower profiles. Spotify exposes this publicly for some profiles; private or restricted profiles may return an upstream error.
Optional: username, uri, url, offset, limit.
Sampled 14 Oct 2026: 50 items. Filled in every item: uri, username, name, followersCount, color, externalUrl. Not in every item: imageUrl (2). In the sample: followersCount: 1,619 to 46,527, median 3,098; externalUrl: open.spotify.com; color: 1,697,420 to 16,737,335, median 13,139,285; imageUrl: i.scdn.co.
Open in Playground
GET/spotify/profile/playlistsapiKey3 credits/request
Returns public Spotify playlists. Provide username, uri, or url; defaults to Spotify's official profile.
Optional: username, uri, url, offset, limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: uri, id, name, imageUrl, followersCount, ownerName, ownerUri, ownerUsername and 2 more. In the sample: followersCount: 521,562 to 33,729,176, median 6,016,332; imageUrl: i.scdn.co; externalUrl: open.spotify.com; ownerUrl: open.spotify.com.
Open in Playground
GET/spotify/profiles/searchapiKey3 credits/request
Returns Spotify profile search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 3 fields returned with a value, 1 empty (results).
Open in Playground
GET/spotify/searchapiKey3 credits/request
Returns Spotify catalog search results across tracks, artists, albums, playlists, shows, episodes, audiobooks, and top results. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_artist_has_concerts_field, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2, is_prefix.
Sampled 14 Oct 2026: 122 items. Filled in every item: uri, title. Not in every item: type (82), imageUrl (89), images (89), externalUrl (109), description (26), subtitle (18), publisher (18). In the sample: type: Podcast (18), Audiobook (10), Episode (10) and 5 more; uri: “spotify:album:0Wtp1qSPNv4SmtwmPf8x9n” and 121 other values; imageUrl: i.scdn.co and 5 other hosts; description: median 615 characters; images: median 3 entries; title: “Hello” and 109 other values; externalUrl: open.spotify.com; subtitle: “juilet” and 17 other values.
Open in Playground
GET/spotify/sectionapiKey3 credits/request
Returns the items of one Spotify browse section for `uri` (default `spotify:section:0JQ5IMCbQBLqNPkcmYxQPQ`), with its title, subtitle and `totalCount`. Each item has a type, title, subtitle, images and Spotify URL. `offset` defaults to 0; `limit` runs 1 to 50 and defaults to 20.
Optional: uri, offset, limit, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 4 fields returned with a value, 1 empty (items). In the sample: uri: “spotify:section:0JQ5IMCbQBLqNPkcmYxQPQ”; type: “BrowseGenericSectionData”.
Open in Playground
GET/spotify/shows/searchapiKey3 credits/request
Searches Spotify podcast shows for the search term `q`, paged with `offset` (default 0) and `limit` (1 to 50). Each show has its title, URI, publisher, description, images and Spotify URL. Show matches appear under both `results` and `shows`. A missing `q` returns 400.
Required: q. Optional: offset, limit.
Sampled 14 Oct 2026: 49 items. Filled in every item: uri, type, title, subtitle, publisher, imageUrl, images, externalUrl. In the sample: uri: “spotify:show:1aT2HaX87aIdK7MONPnrfJ” and 48 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “The Stocks and Savings Podcast” and 47 other values; subtitle: “Stocks and Savings” and 46 other values; publisher: “Stocks and Savings” and 46 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/trackapiKey2 credits/request
Returns Spotify track metadata. Provide either uri or id; defaults to a known public track when omitted.
Optional: uri, id.
Sampled 14 Oct 2026: 3 items. Filled in every item: url, width, height. In the sample: url: i.scdn.co.
Open in Playground
GET/spotify/track/recommendedapiKey2 credits/request
Returns Spotify's recommendations for a track, given its URI, `open.spotify.com` URL or track id. Each recommendation has a type, title, subtitle, description, Spotify URI, external URL and images. `limit` is clamped to 1-50 and defaults to 5.
Optional: uri, id, limit.
Sampled 14 Oct 2026: 5 items. Filled in every item: uri, title, externalUrl. Not in every item: type (3), imageUrl (3), images (3). In the sample: uri: “spotify:track:0KMxxchUDpKAR9bq34WdKP” and 4 other values; imageUrl: i.scdn.co; images: median 3 entries; type: “Track”; title: “傷口上灑辣椒醬” and 4 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/track/similar-albumsapiKey3 credits/request
Lists albums similar to a Spotify track, identified by `uri` or `id`. `limit` runs 1 to 50, default 50, and `albums_only` requests albums-only recommendations. Each album has its title, subtitle, publisher, images and Spotify URL. With neither `uri` nor `id`, a known public track is used.
Optional: uri, id, limit, albums_only.
Sampled 14 Oct 2026: 7 items. Filled in every item: uri, type, title, imageUrl, images, externalUrl. In the sample: uri: “spotify:album:02naurUJ6jYrqIYOe8vxQ9” and 6 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “BEST BALLADS OF 關於...情歌” and 6 other values; externalUrl: open.spotify.com.
Open in Playground
GET/spotify/tracks/searchapiKey3 credits/request
Returns Spotify track search results for a search term. Caller-supplied Spotify bearer or client tokens are not required.
Required: q. Optional: offset, limit, number_of_top_results, include_audiobooks, include_pre_releases, include_album_pre_releases, include_authors, include_episode_content_ratings_v2.
Sampled 14 Oct 2026: 62 items. Filled in every item: uri, title, externalUrl. Not in every item: type (20), imageUrl (40), images (40). In the sample: uri: “spotify:track:1Yk0cQdMLx5RzzFTYwmuld” and 61 other values; imageUrl: i.scdn.co; images: median 3 entries; title: “Hello” and 46 other values; externalUrl: open.spotify.com.
Open in Playground