Search subsystem

The Results class

class spotify.Results

Results corresponding to a search query.

albums()
Return type:list of Album
Returns:albums found by the search.
artists()
Return type:list of Artist
Returns:artists found by the search.
did_you_mean()
Return type:string
Returns:A query suggestion by Spotify.
error()
Return type:int
Returns:check if an error happened. 0 means no error.
is_loaded()
Return type:int
Returns:Whether the results metadata are loaded.
query()
Return type:string
Returns:the query expression that generated these results.
total_albums()
Return type:int
Returns:the total number of albums available for this search query.

Note

If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.

total_artists()
Return type:int
Returns:the total number of artists available for this search query.

Note

If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.

total_tracks()
Return type:int
Returns:the total number of tracks available for this search query.

Note

If this value is larger than the interval specified at creation of the search object, more search results are available. To fetch these, create a new search object with a new interval.

tracks()
Return type:list of Track
Returns:tracks found by the search.