Search

Search…
Search through songs, albums, artists and playlists
Inputs
query (string) : The search query (what you'd type into the search box if you were to search directly in the spotify app)
searchType (string) : Comma-separated list of the types of resources you'd like to search through. The possible values of resource types are "artist", "track", "album", and "playlist". If you want to search for playlists, you cannot include any other resource type in the search, i.e., "playlist,track" is not a valid value.
Outputs
searchResults (JSON object) : Contains the search results. If you searched for playlists, you can get an idea of what searchResults containshere. For everything else, you can refer to this.
Search result structure
Tracks
A single track will have this structure. There can be multiple tracks in the search results array
type: always equal to "track"
name: name of the track
artists: comma-separated list of artists in the track
uri: spotify URI of the track
score: numeric value representing how relevant the track is with respect to the search
images: array of image URLs for the track's cover art, by resolution. May not always exist
imageUrl: image URL of the smallest-resolution available image of the track's cover art
Artists
A single artist will have this structure. There can be multiple artists in the search results array
type: always equal to "artist"
name: name of the artist
uri: spotify URI of the artist
score: numeric value representing how relevant the artist is with respect to the search
images: array of image URLs for the artist's profile photo, by resolution. May not always exist
imageUrl: image URL of the smallest-resolution available image of the artist's profile photo
Albums
A single album will have this structure. There can be multiple albums in the search results array
type: always equal to "album"
name: name of the album
artists: comma-separated list of artists in the album
uri: spotify URI of the album
images: array of image URLs for the album's cover art, by resolution. May not always exist
imageUrl: image URL of the smallest-resolution available image of the album's cover art
Playlists
A single playlist will have this structure. There can be multiple playlists in the search results array
type: always equal to "playlist"
name: name of the playlist
uri: spotify URI of the playlist
images: array of image URLs for the track's album art, by resolution. May not always exist
imageUrl: image URL of the smallest-resolution available image of the track's album art
Playlist
Next - Product
Web Extension
Last modified 7mo ago
Copy link
Contents
Inputs
Outputs
Search result structure