<svgxmlns="http://www.w3.org/2000/svg"aria-hidden="true"x="0px"y="0px"viewBox="0 0 100 100"width="15"height="15"class="icon outbound"><pathfill="currentColor"d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygonfill="currentColor"points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></a></nav><ulclass="sidebar-links"><li><sectionclass="sidebar-group depth-0"><pclass="sidebar-heading open"><span>Search</span><!----></p><ulclass="sidebar-links sidebar-group-items"><li><ahref="/SpotifyAPI-NET/web/search.html#searchitems"class="sidebar-link">SearchItems</a></li><li><ahref="/SpotifyAPI-NET/web/search.html#searchitemsescaped"class="sidebar-link">SearchItemsEscaped</a></li></ul></section></li></ul></aside><mainclass="page"><divclass="theme-default-content content__default"><h1id="search"><ahref="#search"aria-hidden="true"class="header-anchor">#</a> Search</h1><h2id="searchitems"><ahref="#searchitems"aria-hidden="true"class="header-anchor">#</a> SearchItems</h2><blockquote><p>Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.</p></blockquote><divclass="custom-block warning"><pclass="custom-block-title">WARNING</p><p>You may want to use <code>SearchItemsEscaped</code> if you're processing user-input without validation</p></div><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>q</td><td>The search query's keywords (and optional field filters and operators), for example q=roadhouse+blues.</td><td><code>"roadhouse+blues"</code></td></tr><tr><td>type</td><td>A list of item types to search across.</td><td><code>SearchType.Album</code></td></tr><tr><td>[limit]</td><td>The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.</td><td><code>20</code></td></tr><tr><td>[offset]</td><td>The index of the first result to return. Default: 0</td><td><code>0</code></td></tr><tr><td>[market]</td><td>An ISO 3166-1 alpha-2 country code or the string from_token.</td><td><code>"de"</code></td></tr></tbody></table><p>Returns a <code>SearchItem</code> which contains the properties <code>Paging<FullArtist> Artists</code>,<code>Paging<FullTrack> Tracks</code>, <code>Paging<SimpleAlbum> Albums</code>, <code>Paging<SimplePlaylist> Playlists</code>. They are filled based on your search-type.</p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">SearchItem</span> item <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">SearchItems</span><spanclass="token punctuation">(</span><spanclass="token string">"roadhouse+blues"</span><spanclass="token punctuation">,</span> SearchType<spanclass="token punctuation">.</span>Album <spanclass="token operator">|</span> SearchType<spanclass="token punctuation">.</span>Playlist<spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
</code></pre></div><hr><h2id="searchitemsescaped"><ahref="#searchitemsescaped"aria-hidden="true"class="header-anchor">#</a> SearchItemsEscaped</h2><blockquote><p>Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.</p></blockquote><p>Works like <code>SearchItems</code>, but URL escapes all characters</p></div><footerclass="page-edit"><divclass="edit-link"><ahref="https://github.com/JohnnyCrazy/SpotifyAPI-NET/edit/master/SpotifyAPI.Docs/docs/web/search.md"target="_blank"rel="noopener noreferrer">Help us improve this page!</a><svgxmlns="http://www.w3.org/2000/svg"aria-hidden="true"x="0px"y="0px"viewBox="0 0 100 100"width="15"height="15"class="icon outbound"><pathfill="currentColor"d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygonfill="currentColor"points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg></div><divclass="last-updated"><spanclass="prefix">Last Updated:</span><spanclass="time">4/29/2020, 1:45:52 PM</span></div></footer><!----></main></div><divclass="global-ui"></div></div>