get_reviews
Get found reviews for an artist's work.
Input Parameters
| Name | Required | Multiple | Data Type | Description |
|---|---|---|---|---|
| version | yes | no | String | The API version you are calling: '3' |
| context | optional | no | Context | A free-form identifier for the request |
| api_key | yes | no | API Key | Your Echo Nest API Key |
| id | yes | no | Identifier | An Echo Nest Identifier |
| start | optional | no | Integer | The row number to begin with |
| rows | optional | no | Integer <= 15 | Defaults to 15. The number of results to return |
Note: This method requires an HTTP GET request.
Example Response
<response version="3"> <status> <code>0</code> <message>Success</message> </status> <query> <parameter name="api_key">5ZAOMB3BUR8QUN4PE</parameter> <parameter name="id">music://id.echonest.com/~/AR/ARH6W4X1187B99274F</parameter> <parameter name="start">0</parameter> <parameter name="rows">2</parameter> </query> <artist> <name>Radiohead</name> <id>music://id.echonest.com/~/AR/ARH6W4X1187B99274F</id> </artist> <results found="188" shown="2" start="0"> <doc id="e390f344b28e0c6fd4965b04ded7ea53" type="web"> <name> Radiohead - Hail to the Thief (from Robert Christgau) </name> <review_text>See: No Hope Radio.</review_text> <url> http://www.robertchristgau.com/get_artist.php id=1113&name=Radiohead#Radiohead__Hail%20to%20the%20Thief </url> <summary>See: No Hope Radio.</summary> <date_found>2009-01-26T23:54:41</date_found> </doc> <doc id="5b319703c7a5800c461bd1fccccb1527" type="web"> <name>Radiohead - Kid A (from Robert Christgau)</name> <review_text> I guess the fools who ceded these bummed-out Brits U2's world's-greatest-rock-band slot actually did care about what bigger fool Thom Yorke had to say as well as how he made it sound. Why else the controversy over this bag of sonics Me, I'm so relieved Yorke's doing without lyrics. Presaging too damn much but no more a death knell for song than OK Computer was for organic life, this is an imaginative, imitative variation on a pop staple: sadness made pretty. Alienated masterpiece nothing--it's dinner music. More claret </review_text> <url> http://www.robertchristgau.com/get_artist.php id=1113&name=Radiohead#Radiohead__Kid%20A </url> <summary> I guess the fools who ceded these bummed-out Brits U2's world's-greatest-rock-band slot actually did care about what bigger fool Thom Yorke had to say as well as how he made it sound. Why else the controversy over this bag of sonics Me, I'm so relieved Yorke's doing without lyrics. Presaging too damn much but no more a death knell for song than OK Computer was for organic life, this is an imaginative, imitative variation on a pop staple: sadness made pretty. Alienated masterpiece nothing--it's ... </summary> <date_found>2009-01-26T23:54:41</date_found> </doc> </results> </response>
Other Formats
- Also available as a feed in rss, atom formats
- e.g. http://developer.echonest.com/artist/Modest+Mouse/reviews.rss
- e.g. http://developer.echonest.com/artist/Modest+Mouse/reviews.atom
Response Codes
| -1 | Unknown error |
| 0 | Success |
| 1 | Missing/Invalid API key |
| 2 | This API key is not allowed to call this method |
| 3 | Rate limit exceeded |
| 4 | Missing parameter |
| 5 | Invalid parmameter |