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:Wether 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.