<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>Browse</span><!----></p><ulclass="sidebar-links sidebar-group-items"><li><ahref="/SpotifyAPI-NET/web/browse.html#getfeaturedplaylists"class="sidebar-link">GetFeaturedPlaylists</a></li><li><ahref="/SpotifyAPI-NET/web/browse.html#getnewalbumreleases"class="sidebar-link">GetNewAlbumReleases</a></li><li><ahref="/SpotifyAPI-NET/web/browse.html#getcategories"class="sidebar-link">GetCategories</a></li><li><ahref="/SpotifyAPI-NET/web/browse.html#getcategory"class="sidebar-link">GetCategory</a></li><li><ahref="/SpotifyAPI-NET/web/browse.html#getcategoryplaylists"class="sidebar-link">GetCategoryPlaylists</a></li></ul></section></li></ul></aside><mainclass="page"><divclass="theme-default-content content__default"><h1id="browse"><ahref="#browse"aria-hidden="true"class="header-anchor">#</a> Browse</h1><h2id="getfeaturedplaylists"><ahref="#getfeaturedplaylists"aria-hidden="true"class="header-anchor">#</a> GetFeaturedPlaylists</h2><blockquote><p>Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>[locale]</td><td>The desired language, consisting of a lowercase ISO 639 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore.</td><td><code>"de_DE" //Germany</code></td></tr><tr><td>[country]</td><td>A country: an ISO 3166-1 alpha-2 country code.</td><td><code>"DE"</code></td></tr><tr><td>[timestamp]</td><td>A timestamp in ISO 8601 format</td><td><code>DateTime.Now</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 item to return. Default: 0</td><td><code>0</code></td></tr></tbody></table><p>Returns a <code>FeaturedPlaylists</code> object, which has 2 properties. <code>String Message</code> and <code>Paging<SimplePlaylist> Playlists</code></p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">FeaturedPlaylists</span> playlists <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">GetFeaturedPlaylists</span><spanclass="token punctuation">(</span><spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
</code></pre></div><hr><h2id="getnewalbumreleases"><ahref="#getnewalbumreleases"aria-hidden="true"class="header-anchor">#</a> GetNewAlbumReleases</h2><blockquote><p>Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>[country]</td><td>A country: an ISO 3166-1 alpha-2 country code.</td><td><code>"DE"</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 item to return. Default: 0</td><td><code>0</code></td></tr></tbody></table><p>Returns a <code>NewAlbumReleases</code> object, which has the property <code>Paging<SimpleAlbum> Albums</code>.</p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">NewAlbumReleases</span> newAlbums <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">GetNewAlbumReleases</span><spanclass="token punctuation">(</span><spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
</code></pre></div><hr><h2id="getcategories"><ahref="#getcategories"aria-hidden="true"class="header-anchor">#</a> GetCategories</h2><blockquote><p>Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>[country]</td><td>A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country</td><td><code>"DE"</code></td></tr><tr><td>[locale]</td><td>The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore</td><td><code>"de_DE"</code></td></tr><tr><td>[limit]</td><td>The maximum number of categories 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 item to return. Default: 0 (the first object).</td><td><code>0</code></td></tr></tbody></table><p>Returns a <code>CategoryList</code> object, which has the property <code>Paging<Category> Categories</code>.</p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">CategoryList</span> categoryList <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">GetCategories</span><spanclass="token punctuation">(</span><spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
</code></pre></div><hr><h2id="getcategory"><ahref="#getcategory"aria-hidden="true"class="header-anchor">#</a> GetCategory</h2><blockquote><p>Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>categoryId</td><td>The Spotify category ID for the category.</td><td><code>"party"</code></td></tr><tr><td>[country]</td><td>A country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country.</td><td><code>"DE"</code></td></tr><tr><td>[locale]</td><td>The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore</td><td><code>"de_DE"</code></td></tr></tbody></table><p>Returns a <ahref="https://developer.spotify.com/web-api/object-model/#category-object"target="_blank"rel="noopener noreferrer">Category<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></p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">Category</span> cat <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">GetCategory</span><spanclass="token punctuation">(</span><spanclass="token string">"party"</span><spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
</code></pre></div><hr><h2id="getcategoryplaylists"><ahref="#getcategoryplaylists"aria-hidden="true"class="header-anchor">#</a> GetCategoryPlaylists</h2><blockquote><p>Get a list of Spotify playlists tagged with a particular category.</p></blockquote><p><strong>Parameters</strong></p><table><thead><tr><th>Name</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>categoryId</td><td>The Spotify category ID for the category.</td><td><code>"party"</code></td></tr><tr><td>[country]</td><td>A country: an ISO 3166-1 alpha-2 country code.</td><td><code>"DE"</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 item to return. Default: 0</td><td><code>0</code></td></tr></tbody></table><p>Returns a <code>CategoryPlaylist</code> object, which has the property <code>Paging<SimplePlaylist> Playlists</code></p><p><strong>Usage</strong></p><divclass="language-csharp extra-class"><preclass="language-csharp"><code><spanclass="token class-name">CategoryPlaylist</span> playlists <spanclass="token operator">=</span> _spotify<spanclass="token punctuation">.</span><spanclass="token function">GetCategoryPlaylists</span><spanclass="token punctuation">(</span><spanclass="token string">"party"</span><spanclass="token punctuation">)</span><spanclass="token punctuation">;</span>
