<linkrel="alternate"type="application/rss+xml"href="/SpotifyAPI-NET/news/rss.xml"title="SpotifyAPI-NET Blog RSS Feed">
<linkrel="alternate"type="application/atom+xml"href="/SpotifyAPI-NET/news/atom.xml"title="SpotifyAPI-NET Blog Atom Feed"><titledata-react-helmet="true">Search | SpotifyAPI-NET</title><metadata-react-helmet="true"property="og:url"content="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/5.1.1/web/search"><metadata-react-helmet="true"name="docusaurus_locale"content="en"><metadata-react-helmet="true"name="docusaurus_version"content="5.1.1"><metadata-react-helmet="true"name="docusaurus_tag"content="docs-default-5.1.1"><metadata-react-helmet="true"property="og:title"content="Search | SpotifyAPI-NET"><metadata-react-helmet="true"name="description"content="SearchItems"><metadata-react-helmet="true"property="og:description"content="SearchItems"><linkdata-react-helmet="true"rel="shortcut icon"href="/SpotifyAPI-NET/img/favicon.ico"><linkdata-react-helmet="true"rel="canonical"href="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/5.1.1/web/search"><linkdata-react-helmet="true"rel="alternate"href="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/5.1.1/web/search"hreflang="en"><linkdata-react-helmet="true"rel="alternate"href="https://johnnycrazy.github.io/SpotifyAPI-NET/docs/5.1.1/web/search"hreflang="x-default"><linkrel="stylesheet"href="/SpotifyAPI-NET/assets/css/styles.fa980c59.css">
:::</p><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="codeBlockContainer_K1bP"><divclass="codeBlockContent_hGly csharp"><divtabindex="0"class="prism-code language-csharp codeBlock_23N8 thin-scrollbar"><divclass="codeBlockLines_39YC"style="color:#bfc7d5;background-color:#292d3e"><divclass="token-line"style="color:#bfc7d5"><spanclass="token plain">SearchItem item = _spotify.SearchItems("roadhouse+blues", SearchType.Album | SearchType.Playlist);</span></div><divclass="token-line"style="color:#bfc7d5"><spanclass="token plain">Console.WriteLine(item.Albums.Total); //How many results are there in total? NOTE: item.Tracks = item.Artists = null</span></div></div></div><buttontype="button"aria-label="Copy code to clipboard"class="copyButton_Ue-o">Copy</button></div></div><hr><h2><aaria-hidden="true"tabindex="-1"class="anchor enhancedAnchor_2LWZ"id="searchitemsescaped"></a>SearchItemsEscaped<aclass="hash-link"href="#searchitemsescaped"title="Direct link to heading">#</a></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></article><divclass="margin-vert--xl"><divclass="row"><divclass="col"><ahref="https://github.com/JohnnyCrazy/SpotifyAPI-NET/edit/master/SpotifyAPI.Docs/versioned_docs/version-5.1.1/web/search.md"target="_blank"rel="noreferrer noopener"><svgfill="currentColor"height="1.2em"width="1.2em"preserveAspectRatio="xMidYMid meet"role="img"viewBox="0 0 40 40"class="iconEdit_2_ui"aria-label="Edit page"><g><pathd="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><divclass="col text--right"><em><small>Last updated on <timedatetime="2021-06-20T18:51:17.000Z"class="lastUpdatedDate_1WI_">6/20/2021</time> by <strong>dependabot[bot]</strong></small></em></div></div></div><divclass="margin-vert--lg"><navclass="pagination-nav"aria-label="Docs pages navigation"><divclass="pagination-nav__item"><aclass="pagination-nav__link"href="/SpotifyAPI-NET/docs/5.1.1/web/proxy"><divclass="pagination-nav__sublabel">Previous</div><divclass="pagination-nav__label">« Proxy Settings</div></a></div><divclass="pagination-nav__item pagination-nav__item--next"><aclass="pagination-nav__link"href="/SpotifyAPI-NET/docs/5.1.1/web/tracks"><divclass="pagination-nav__sublabel">Next</div><divclass="pagination-nav__label">Tracks »</div></a></div></nav></div></div></div><divclass="col col--3"><divclass="tableOfContents_35-E thin-scrollbar"><ulclass="table-of-contents table-of-contents__left-border"><li><ahref="#searchitems"class="table-of-contents__link">SearchItems</a></li><li><ahref="#searchitemsescaped"class="table-of-contents__link">SearchItemsEscaped</a></li></ul></div></div></div></div></main></div></div><footercl