Returns information about the tracks on a release of an album.
This request may return a large amount of data. To speed data transmission, do the following:
release/tracks? | 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 |
---|---|---|
tracks | Track [ ] | Tracks on the release specified in the request. |