Descriptor/SignificantComposers
Returns the top composers in a classical music subgenre. By design, the list is limited to a maximum of 100 per subgenre.
Significant composers are defined for these classical music subgenres:
- MA0000004505—Ballet
- MA0000004501—Band Music
- MA0000004500—Chamber Music
- MA0000004509—Choral
- MA0000012338—Concerto
- MA0000012306—Film Score
- MA0000011828—Keyboard
- MA0000012215—Miscellaneous (Classical)
- MA0000004512—Opera
- MA0000004499—Orchestral
- MA0000004506—Show/Musical
- MA0000012291—Symphony
- MA0000004520—Vocal Music
Syntax
descriptor/significantcomposers?apikey=apikey&sig=sig&genreids=genreids [&format=format] [&offset=offset] [&count=count] [&country=country] [&language=language]
Request Example 1
- Request the top composers in the Band Music and Ballet subgenres.
Request Example 2
- Request the top composer in the Band Music subgenre.
Request Example 3
- Request the second top composer in the Band Music subgenre in an XML response.
Request Parameters
Click to re-sort
Parameter | Required | Description |
apikey | Yes | Access code that authorizes your request for data from Rovi. |
genreids | Yes | Genre ID or subgenre ID. You can get IDs of musical genres and subgenres from Descriptor/Genres or Descriptor/MusicGenres.
To specify multiple IDs, use a comma-separated list, like this: genreids=MA0000002467,MA0000002944. |
sig | Yes | A calculated authorization code. To perform the calculation, execute the MD5 function on the concatenation of the following three strings:
- Your API key.
- The secret key you received with your API key.
- The Unix time. Unix time is a timestamp supported in most development environments, and is generally defined as the number of seconds since January 1, 1970 00:00:00 GMT.
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. |
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
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 for Descriptor/SignificantComposers
Response | Type | Description |
composers | SignificantComposer [ ] | Top composers in the genres or subgenres specified in the request. |
JSON Response Example
- Here's the response to Request Example 2. It is formatted with extra spaces and carriage returns to make it easy to read.
{
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"MA0000004501"
"offset":0,
"count":1
},
"view":{
"offset":0,
"count":1,
"total":10
},
"serverName":"tul1cssw3",
"startTime":"2011-04-29T00:55:22.8148939Z",
"endTime":"2011-04-29T00:55:22.8617698Z",
"duration":46,
"composers":[
{
"genre":{
"id":"MA0000004501",
"name":"Band Music"
},
"rank":9,
"id":"MN0001576229",
"name":"Henry Fillmore",
"active":[
"1990s"
],
"thumbnail":"http:\/\/actual-url-concealed.jpg"
}
]
}
XML Response Example
- Here's the response to Request Example 3.
<SignificantComposers xmlns="com.rovicorp.metadataservice" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>MA0000004501</id>
<offset>1</offset>
<count>1</count>
<format>xml</format>
</parameters>
<view>
<offset>1</offset>
<count>1</count>
<total>10</total>
</view>
<serverName>tul1cssw1</serverName>
<startTime>2011-04-29T00:55:07.7554565Z</startTime>
<endTime>2011-04-29T00:55:07.7710816Z</endTime>
<duration>15</duration>
<composers>
<SignificantComposer>
<genre>
<id>MA0000004501</id>
<name>Band Music</name>
</genre>
<rank>9</rank>
<id>MN0001862683</id>
<name>Julius Fucik</name>
<active xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
<thumbnail>http://actual-url-concealed.jpg</thumbnail>
</SignificantComposer>
</composers>
</SignificantComposers>
See Also
↑ Top