Home > Documentation > cuteRadio Data API > Genres

Genres

About

A genre resource identifies a genre to which one or more station resources belongs. Below is a JSON representation of a genre:

{"name": "A Genre", "count": 100}

Properties

A genre resource has the following properties:

Name Description
count integer
The number of stations belonging to the genre.
name string
The name the genre.

Methods

The API supports the following methods:

Method Endpoint Description
GET /genres Retrieves a list of genres to which one or more stations belong.

GET /genres

Request

GET http://marxoft.co.uk/api/cuteradio/genres

Parameters

Name Description
limit integer
The maximum number of results that should be returned. Must be between 1 and 50. The default is 20.
offset integer
The index of the first result to be returned. The index is 0-based.
search string
The keyword(s) to be used to filter results.
sort string
The property used to sort the results. The default is 'name'.
sortDescending boolean
Whether result should be sorted in descending order. The default is false.

Response

{
"items": [
$GENRE
],
"next": "/genres?limit=20&offset=20&sort=name&sortDescending=false"
}