Returns a list of topics, feelings, and circumstances that motivate or fit with the music on an album release, along with weightings that reflect the relative importance of each. The themes recognized by Rovi Music are shown in the Music Themes table.
release/themes? | eanid=eanid upcid=upcid amgpopid=amgpopid releaseid=releaseid amgclassicalid=amgclassicalid |
&apikey=apikey&sig=sig [&format=format] [&offset=offset] [&count=count] [&country=country] [&language=language] |
Click to re-sort
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. | ||
amgclassicalid | Conditional | All Media Guide (AMG) ID for a classical music album, consisting of a ten-character string that starts with W and is followed by nine digits with leading spaces. For example: W 180317. When using an AMG Classical ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: W+++180317. AMG is a legacy database of entertainment information.
Condition: The request must contain just one of these parameters:
| ||
amgpopid | Conditional | All Media Guide (AMG) ID for a popular music album, consisting of a ten-character string that starts with R and is followed by nine digits with leading spaces. For example: R 1805889. When using an AMG Pop ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: R++1805889.
Condition: The request must contain just one of these parameters:
| ||
eanid | Conditional | The numbers from the EAN barcode that identifies the release.
Condition: The request must contain just one of these parameters:
| ||
releaseid | Conditional | Rovi Music ID for the release, consisting of the prefix MR followed by a ten-digit number. Your application can grab release IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
| ||
upcid | Conditional | The numbers from the barcode that identifies a music release:
Condition: The request must contain just one of these parameters:
| ||
count | No | Number of items to be returned. The default is zero, which returns all items after the offset.
Use count and offset to paginate the response. | ||
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. | ||
language | No | Language of the response data. This request supports only en (English). | ||
offset | No | Number of items at the start of the returned list to skip. The default is zero.
Use count and offset to paginate the response. |
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. |
parentIds | parentIds | All of the IDs for the requested object that are recognized by the API. |
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 |
---|---|---|
themes | Theme [ ] | Themes for the release specified in the request. |