# Spotify API

> 5 public methods for Spotify (spotify.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by Spotify.

- Page: https://fous.com/methods/spotify.com

## Methods

### [List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md)

`open.spotify.com/list_top_podcasts`, read. Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.

Returns: rank, movement, places_moved, podcast name, publisher, cover image URL, Spotify URL

### [Search music](https://fous.com/methods/spotify.com/search-music.md)

`spotify.com/search_music`, read. Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date.

Returns: name, type, artists, owner, publisher, album, release date, length, image link, Spotify link, Spotify ID

### [Get song](https://fous.com/methods/open.spotify.com/get-song.md)

`open.spotify.com/get_song`, read. Finds a Spotify song by title (optionally narrowed by artist), track link, URI or track ID and returns its public play count and details. Without an artist, the most-played exact title match wins. Previews and ISRC may be unavailable for some tracks.

Returns: title, artists, album, release date, length, play count, explicit flag, track number, preview link, cover image, Spotify link, track ID, ISRC, length in ms

### [Get artist](https://fous.com/methods/open.spotify.com/get-artist.md)

`open.spotify.com/get_artist`, read. Gets a Spotify artist's public profile from their name, artist link or ID: listeners, followers, world rank, top cities, popular tracks, latest release and release counts.

Returns: artist name, verified, monthly listeners, followers, world rank, top cities, popular tracks, latest release, album and single counts, image, link

### [Get album](https://fous.com/methods/open.spotify.com/get-album.md)

`open.spotify.com/get_album`, read. Gets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts.

Returns: album name, artists, release date, type, label, copyright, cover, total length, tracks with featured artists, lengths, play counts, explicit flags
