GET (/3/content/{namespace}/catalog/genres)

Get a list of genres available for a locale.

Remarks

The BrowseGenres request is composed of mandatory and optional URL parts and query parameters. A request containing all parameters would resemble the following string:

/1/content/{namespace}/catalog/genres?language={language}&country={country}

Authorization: Bearer [...]

For parameters common to every Groove RESTful API, see Parameters common to every Groove RESTful API. For a table of error codes, see Error (JSON). For HTTP status codes, see Groove RESTful API HTTP Status Codes.

Response object

ContentResponse (JSON)

Examples

Browse genres

Request

GET /3/content/music/catalog/genres?country=us&language=en

Authorization: Bearer [...]

Response (list truncated)

{
  "CatalogGenres": [
    {
      "ParentName": "Blues / Folk",
      "HasEditorialPlaylists": false,
      "Name": "Acoustic Blues"
    },
    {
      "ParentName": "Electronic / Dance",
      "HasEditorialPlaylists": false,
      "Name": "Ambient"
    },
    {
      "HasEditorialPlaylists": false,
      "Name": "Electronic / Dance"
    },
    {
      "ParentName": "Country",
      "HasEditorialPlaylists": false,
      "Name": "Americana / Roots"
    },
    {
      "HasEditorialPlaylists": true,
      "Name": "Country"
    },
    {
      "ParentName": "More",
      "HasEditorialPlaylists": false,
      "Name": "Avant-Garde / Experimental"
    },
    {
      "HasEditorialPlaylists": false,
      "Name": "More"
    },
        {
      "ParentName": "Country",
      "HasEditorialPlaylists": false,
      "Name": "Bluegrass"
    },
    {
      "HasEditorialPlaylists": false,
      "Name": "Blues / Folk"
    },
    {
      "ParentName": "Electronic / Dance",
      "HasEditorialPlaylists": false,
      "Name": "Breakbeat / Electro"
    },
    {
      "ParentName": "World",
      "HasEditorialPlaylists": false,
      "Name": "Caribbean"
    },
    {
      "ParentName": "Classical",
      "HasEditorialPlaylists": false,
      "Name": "Chamber"
    },
    {
      "HasEditorialPlaylists": false,
      "Name": "Christian / Gospel"
    },
    {
      "ParentName": "Christian / Gospel",
      "HasEditorialPlaylists": false,
      "Name": "Christian Rock / Hip Hop"
    },
    {
      "ParentName": "More",
      "HasEditorialPlaylists": false,
      "Name": "Christmas Music"
    },
    {
      "HasEditorialPlaylists": false,
      "Name": "World"
    },
    {
      "HasEditorialPlaylists": true,
      "Name": "Classical"
    },
    {
      "ParentName": "Classical",
      "HasEditorialPlaylists": false,
      "Name": "Classical Guitar"
    },
    {
      "ParentName": "Classical",
      "HasEditorialPlaylists": false,
      "Name": "Classical Period"
    }
  ],
  "Culture": "en-US"
}

Parent

Groove Service REST Reference