Returns basic information about a classical music performance plus customized requests for all of the other Performance content that is available. These customized requests are designed to make your programming easy and efficient: in a single step you both verify availability of data and capture the request. You just add your signature argument and execute the request.
The performance/info request also provides an optional argument to include responses from any or all of the other Performance requests. This may return a large amount of data. To speed data transmission, do the following:
performance/info? | performanceid=performanceid amgclassicalid=amgclassicalid |
&apikey=apikey&sig=sig [&include=include] [&format=format] [&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, 32-hex-digit authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three ASCII strings:
Express the alpha hex digits as lower case. 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 performance, consisting of a string that starts with F and is followed by 9 digits with leading spaces. For example, F 2229909. AMG is a legacy database of entertainment information. When using an AMG classical ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: F++2229909. Condition: The request must contain just one of these parameters:
|
performanceid | Conditional | Rovi Music ID for a classical music performance, consisting of the prefix MQ followed by a ten-digit number. For example, MQ0001169372. Your application can grab performance IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
|
country | No | Country the language parameter applies to. The current release of the API supports only US. |
format | No | Format of the returned data: json or xml. The default is JSON. |
include | No | Other Performance requests to include in the request. To include credits, for example, add include=credits.
You can specify multiple includes in either of the following ways:
You can also include all Performance requests with include=all. The possible values are: For information about a request, please see the documentation for the request. Reminder: These options may return a large amount of data. To speed data transmission, do the following:
|
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 | The parameters that were 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, which is shown in the code field. |
Response | Type | Description |
---|---|---|
composition | composition | Information about the compositions performed in a classical music performance, returned only if the request specified an include=composition argument. |
compositionUri | string | The customized Performance/Composition request, returned only if the data is available. |
credits | PerformanceCredit [ ] | Production credits for the classical music performance, returned only if the request specified an include=credits argument. |
creditsUri | string | The customized Performance/Credits request, returned only if the data is available. |
duration | integer | Length of the performance in seconds. |
excerpt | string | Title of the part performed if only part of the composition was performed. |
ids | ids | All of the IDs that are recognized by the API for a performance. The possible IDs are:
|
images | images | URLs to images of the album that contains the recording the classical music performance, returned only if the request specified an include=images argument and your subscription level enables access to images. |
imagesUri | string | The customized Performance/Images request, returned only if the data is available. |
isPick | Boolean | Whether the performance is recommended by Rovi: true or false. |
notes | string | Short notes about the performance. |
performers | albumArtist [ ] | List of the soloists, conductors, orchestras, and other performers. |
rating | integer | An editorially assigned rating of the performance from 0 to 9, where 0 is no rating and higher numbers indicate a higher rating. |
recordingDate | string | Date of the performance in YYYY-MM-DD format. |
recordingPlace | string | Location of the performance. |
release | release | Information about an album release that contains the recording of the classical music performance, returned only if the request specified an include=release argument. |
releaseUri | string | The customized Performance/Release request, returned only if the data is available. |
soundRating | integer | An editorially assigned rating of the sound quality from 0 to 10, where 0 is no rating and higher numbers indicate a higher rating. |