Tools
Album/PrimaryReview
Returns the most recent major review of an album.
Syntax
| album/primaryreview? | album=album albumid=albumid amgpopid=amgpopid amgclassicalid=amgclassicalid |
&apikey=apikey&sig=sig [&format=format] [&country=country] [&language=language] |
Request Example 1
- Request the primary review for the album Birth of the Cool.
Request Example 2
- Request the primary review in XML format.
Request Parameters
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. |
| album | Conditional | Keywords from the album title. This searches for the most popular title with that combination of words. Replace spaces with plus (+) or percent20 (%20) symbols.
Condition: The request must contain just one of these parameters:
|
| albumid | Conditional | Rovi Music ID for an album, consisting of the prefix MW followed by a ten-digit number. For example: MW0000056882. You can grab album IDs from responses to the following requests:
Condition: The request must contain just one of these parameters:
|
| 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:
|
| 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. |
| language | No | Language of the response. This request supports only en, English. |
Response
Response Header
| 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. |
| 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, which is shown in the code field. |
Response for Album/PrimaryReview
| Response | Type | Description |
|---|---|---|
| author | string | Author of the review. |
| text | string | The full text of the review. |
JSON Response Example
- Here's the response to Request Example 1, which asks for the primary review for the album Birth of the Cool. The response is formatted with extra spaces and carriage returns to make it easy to read.
- Requested with http://api.rovicorp.com/data/v1.1/album/primaryreview?apikey=apikey&sig=sig&
albumid=MW0000111184.
{
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"MW0000111184"
},
"serverName":"tul1cssw3",
"startTime":"2011-04-27T21:53:38.6728286Z",
"endTime":"2011-04-27T21:53:38.6728286Z",
"duration":0,
"parentIds":{
"albumId":"MW0000111184",
"amgPopId":"R 104727"
},
"primaryReview":{
"text":"So dubbed because these three sessions -- two from early 1949, one from March 1950 -- are where the sound known as cool jazz essentially formed, [roviLink=\"MW\"]Birth of the Cool[\/roviLink] remains one of the defining, pivotal moments in jazz. This is where the elasticity of bop was married with skillful, big-band arrangements and a relaxed, subdued mood that made it all seem easy, even at its most intricate. After all, there's a reason why this music was called cool; it has a hip, detached elegance, never getting too hot, even as the rhythms skip and jump. Indeed, the most remarkable thing about these sessions -- arranged by [roviLink=\"MN0000551815\"]Gil Evans[\/roviLink] and featuring such heavy-hitters as [roviLink=\"MN0000352164\"]Kai Winding[\/roviLink], [roviLink=\"MN0000542549\"]Gerry Mulligan[\/roviLink], [roviLink=\"MN0000227776\"]Lee Konitz[\/roviLink], and [roviLink=\"MN0000396372\"]Max Roach[\/roviLink] -- is that they sound intimate, as the nonet never pushes too hard, never sounds like the work of nine musicians. Furthermore, the group keeps things short and concise (probably the result of the running time of singles, but the results are the same), which keeps the focus on the tones and tunes. The virtuosity led to relaxing, stylish mood music as the end result -- the very thing that came to define West Coast or \"cool\" jazz -- but this music is so inventive, it remains alluring even after its influence has been thoroughly absorbed into the mainstream ~ Stephen Thomas Erlewine",
"author":"Stephen Thomas Erlewine"
}
}
"status":"ok",
"code":200,
"messages":null,
"build":"1.5.1.9",
"parameters":{
"apiKey":"apikey",
"id":"MW0000111184"
},
"serverName":"tul1cssw3",
"startTime":"2011-04-27T21:53:38.6728286Z",
"endTime":"2011-04-27T21:53:38.6728286Z",
"duration":0,
"parentIds":{
"albumId":"MW0000111184",
"amgPopId":"R 104727"
},
"primaryReview":{
"text":"So dubbed because these three sessions -- two from early 1949, one from March 1950 -- are where the sound known as cool jazz essentially formed, [roviLink=\"MW\"]Birth of the Cool[\/roviLink] remains one of the defining, pivotal moments in jazz. This is where the elasticity of bop was married with skillful, big-band arrangements and a relaxed, subdued mood that made it all seem easy, even at its most intricate. After all, there's a reason why this music was called cool; it has a hip, detached elegance, never getting too hot, even as the rhythms skip and jump. Indeed, the most remarkable thing about these sessions -- arranged by [roviLink=\"MN0000551815\"]Gil Evans[\/roviLink] and featuring such heavy-hitters as [roviLink=\"MN0000352164\"]Kai Winding[\/roviLink], [roviLink=\"MN0000542549\"]Gerry Mulligan[\/roviLink], [roviLink=\"MN0000227776\"]Lee Konitz[\/roviLink], and [roviLink=\"MN0000396372\"]Max Roach[\/roviLink] -- is that they sound intimate, as the nonet never pushes too hard, never sounds like the work of nine musicians. Furthermore, the group keeps things short and concise (probably the result of the running time of singles, but the results are the same), which keeps the focus on the tones and tunes. The virtuosity led to relaxing, stylish mood music as the end result -- the very thing that came to define West Coast or \"cool\" jazz -- but this music is so inventive, it remains alluring even after its influence has been thoroughly absorbed into the mainstream ~ Stephen Thomas Erlewine",
"author":"Stephen Thomas Erlewine"
}
}
XML Response Example
- Here's the response to Request Example 2, which asks for the primary review for the album Birth of the Cool in an XML format.
- Requested with http://api.rovicorp.com/data/v1.1/album/primaryreview?apikey=apikey&sig=sig&
albumid=MW0000111184&format=xml.
<AlbumPrimaryReview 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>MW0000111184</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw4</serverName>
<startTime>2011-04-27T21:53:52.6108767Z</startTime>
<endTime>2011-04-27T21:53:52.6108767Z</endTime>
<duration>0</duration>
<parentIds>
<albumId>MW0000111184</albumId>
<amgPopId>R 104727</amgPopId>
</parentIds>
<primaryReview>
<text>So dubbed because these three sessions -- two from early 1949, one from March 1950 -- are where the sound known as cool jazz essentially formed, [roviLink="MW"]Birth of the Cool[/roviLink] remains one of the defining, pivotal moments in jazz. This is where the elasticity of bop was married with skillful, big-band arrangements and a relaxed, subdued mood that made it all seem easy, even at its most intricate. After all, there's a reason why this music was called cool; it has a hip, detached elegance, never getting too hot, even as the rhythms skip and jump. Indeed, the most remarkable thing about these sessions -- arranged by [roviLink="MN0000551815"]Gil Evans[/roviLink] and featuring such heavy-hitters as [roviLink="MN0000352164"]Kai Winding[/roviLink], [roviLink="MN0000542549"]Gerry Mulligan[/roviLink], [roviLink="MN0000227776"]Lee Konitz[/roviLink], and [roviLink="MN0000396372"]Max Roach[/roviLink] -- is that they sound intimate, as the nonet never pushes too hard, never sounds like the work of nine musicians. Furthermore, the group keeps things short and concise (probably the result of the running time of singles, but the results are the same), which keeps the focus on the tones and tunes. The virtuosity led to relaxing, stylish mood music as the end result -- the very thing that came to define West Coast or "cool" jazz -- but this music is so inventive, it remains alluring even after its influence has been thoroughly absorbed into the mainstream ~ Stephen Thomas Erlewine</text>
<author>Stephen Thomas Erlewine</author>
</primaryReview>
</AlbumPrimaryReview>
<status>ok</status>
<code>200</code>
<messages i:nil="true"/>
<build>1.5.1.9</build>
<parameters>
<apiKey>apikey</apiKey>
<id>MW0000111184</id>
<format>xml</format>
</parameters>
<serverName>tul1cssw4</serverName>
<startTime>2011-04-27T21:53:52.6108767Z</startTime>
<endTime>2011-04-27T21:53:52.6108767Z</endTime>
<duration>0</duration>
<parentIds>
<albumId>MW0000111184</albumId>
<amgPopId>R 104727</amgPopId>
</parentIds>
<primaryReview>
<text>So dubbed because these three sessions -- two from early 1949, one from March 1950 -- are where the sound known as cool jazz essentially formed, [roviLink="MW"]Birth of the Cool[/roviLink] remains one of the defining, pivotal moments in jazz. This is where the elasticity of bop was married with skillful, big-band arrangements and a relaxed, subdued mood that made it all seem easy, even at its most intricate. After all, there's a reason why this music was called cool; it has a hip, detached elegance, never getting too hot, even as the rhythms skip and jump. Indeed, the most remarkable thing about these sessions -- arranged by [roviLink="MN0000551815"]Gil Evans[/roviLink] and featuring such heavy-hitters as [roviLink="MN0000352164"]Kai Winding[/roviLink], [roviLink="MN0000542549"]Gerry Mulligan[/roviLink], [roviLink="MN0000227776"]Lee Konitz[/roviLink], and [roviLink="MN0000396372"]Max Roach[/roviLink] -- is that they sound intimate, as the nonet never pushes too hard, never sounds like the work of nine musicians. Furthermore, the group keeps things short and concise (probably the result of the running time of singles, but the results are the same), which keeps the focus on the tones and tunes. The virtuosity led to relaxing, stylish mood music as the end result -- the very thing that came to define West Coast or "cool" jazz -- but this music is so inventive, it remains alluring even after its influence has been thoroughly absorbed into the mainstream ~ Stephen Thomas Erlewine</text>
<author>Stephen Thomas Erlewine</author>
</primaryReview>
</AlbumPrimaryReview>