mirror of
https://github.com/Sarsoo/Spotify.NET.git
synced 2024-12-29 01:06:26 +00:00
1.4 KiB
1.4 KiB
Search
SearchItems
Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.
::: warning
You may want to use SearchItemsEscaped if you're processing user-input without validation
:::
Parameters
| Name | Description | Example |
|---|---|---|
| q | The search query's keywords (and optional field filters and operators), for example q=roadhouse+blues. | "roadhouse+blues" |
| type | A list of item types to search across. | SearchType.Album |
| [limit] | The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. | 20 |
| [offset] | The index of the first result to return. Default: 0 | 0 |
| [market] | An ISO 3166-1 alpha-2 country code or the string from_token. | "de" |
Returns a SearchItem which contains the properties Paging<FullArtist> Artists,Paging<FullTrack> Tracks, Paging<SimpleAlbum> Albums, Paging<SimplePlaylist> Playlists. They are filled based on your search-type.
Usage
SearchItem item = _spotify.SearchItems("roadhouse+blues", SearchType.Album | SearchType.Playlist);
Console.WriteLine(item.Albums.Total); //How many results are there in total? NOTE: item.Tracks = item.Artists = null
SearchItemsEscaped
Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.
Works like SearchItems, but URL escapes all characters