Returns descriptions of genres used in Rovi Cloud Services, plus optional lists of subgenres and musical styles.
descriptor/genres?apikey=apikey&sig=sig [&genreids=genreids] [&include=include] [&language=language] [&country=country] [&format=format]
Parameter | Required | Description | ||||
---|---|---|---|---|---|---|
apikey | Yes | Access code that authorizes your request for data from Rovi. | ||||
sig | Yes | A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
Perform the calculation at the time of each request to be sure it's within a five-minute window of the server time. If you're testing the call in a browser, use our online signature generator to perform the calculation. | ||||
country | No | Country of the language of the response. The current release of the API supports only US. | ||||
format | No | Format of the returned data: json or xml. The default is JSON. | ||||
genreids | No | Specific genre IDs you want information about. Replace any spaces in an ID with plus (+) or percent20 (%20) symbols. To specify multiple IDs, use a comma-separated list like this: genreids=MA0000002467,D+++646,D+++647.
If not specified, information about all genres is returned. | ||||
include | No | Additional information you want to be included about each genre. The possible values are:
| ||||
language | No | Language of the response data. This request supports only en (English). |
Response | Type | Description |
---|---|---|
build | String | The software release level of the API. |
code | Integer | HTTP status code. See the status field for the text part of the code. |
duration | Integer | Server processing time in milliseconds. The difference between startTime and endTime. |
endTime | String | When the server sent the response (UTC time). |
messages | Message [ ] | Elements of a multiple HTTP response status message. |
parameters | parameters | List of the parameters included in the request. |
serverName | String | Name of the server that processed the request. |
startTime | String | When the server received the request (UTC time). |
status | String | Text part of the HTTP status code that is shown in the code field. |
view | view | Summary of items returned in a list of items. |
Response | Type | Description |
---|---|---|
genres | Genre [ ] | Genre descriptions and, if requested, a list of the subgenres of each genre. |