Returns basic information about a classical music composition plus customized requests for all of the other Composition 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 the data and capture the request. You just add the signature parameter and execute the request.
The composition/info request also provides an optional parameter to include responses from any or all of the other Composition requests. This may return a large amount of data. To speed data transmission, do the following:
A variety of compositions may be performed on a classical music album. A composition can include multiple parts or movements, each of which is recorded as a single track.
composition/info? | compositionid=compositionid 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 classical music composition, consisting of a ten-character string that starts with C and is followed by nine digits with leading spaces. For example: C 43235. When using an AMG Classical ID in a request, replace any spaces in the ID with plus (+) or percent20 (%20) symbols, like this: C++++43235. AMG is a legacy database of entertainment information. Condition: The request must contain just one of these parameters:
|
compositionid | Conditional | Rovi Music ID for a classical music composition, consisting of the prefix MC followed by a ten-digit number. For example: MC0002369165. Your application can grab composition 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 requests to include in the request. To include the list of parts in the response, for example, add &include=parts.
You can specify multiple includes in either of the following ways:
You can also include all Music Service Composition requests with 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 |
---|---|---|
alternateTitle | string | Another title the composition is known by. |
avarageDuration | integer | Average performance time of the composition in seconds. |
composers | CompositionComposer [ ] | Composers of the composition. |
compositionDate | string | Date the composition was composed, in YYYY-MM-DD format. |
description | description | Description of the composition, returned only if the request specified an include=description argument. |
descriptionUri | string | The customized Composition/Description request, returned only if the data is available. |
firstPerformanceDate | string | Date the composition was first performed, in YYYY-MM-DD format. |
forms | CompositionForm [ ] | Classical forms that apply to the composition, sorted in alphabetical order. |
genres | Genre [ ] | Musical genres the composition falls into, along with a weighting that reflects the relative importance of each genre.
Genres are sorted in order of importance (highest to lowest weight) and, within the same weight, alphabetically by genre name. |
ids | ids | All of the IDs that are recognized by the API for a composition. The possible IDs are:
|
parts | string [ ] | Names of the parts or movements of a classical music composition, returned only if the request specified an include=parts argument. |
partsUri | string | The customized Composition/Parts request, returned only if the data is available. |
periods | CompositionPeriod [ ] | Musical periods the composition belongs in. |
publicationDate | string | The date the composition was published, in YYYY-MM-DD format. |
rating | integer | An editorially assigned rating of the composition from 0 to 5, where 0 is no rating and higher numbers indicate a higher rating. |
releases | CompositionRelease [ ] | Album releases that feature a performance of a composition, returned only if the request specified an include=releases argument. |
releasesUri | string | The customized Composition/Releases request, returned only if the data is available. |
revisionDate | string | The last date the composition was revised, in YYYY-MM-DD format. |
title | string | Title of the composition. |