get_similar
Return similar artists given one or more artists for comparison. The Echo Nest provides up-to-the-minute artist similarity and recommendations from their real-time musical and cultural analysis of what people are saying across the Internet and what the music sounds like.
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 | yes | Identifier | An Echo Nest Identifier |
| bucket | optional | yes | String 'audio,' 'biographies,' 'blogs,' 'familiarity,' 'hotttnesss,' 'images,' 'news,' 'reviews,' 'urls,' or 'video' | Flag for additional information to return with each artist result. |
| start | optional | no | Integer | This parameter is deprecated. Must be 0. |
| rows | optional | no | Integer <= 100 | Defaults to 15. The number of results to return |
Note: This method requires an HTTP GET request.
Note: you can boost an artist's weight in calculating similarity by appending a boost to the artists' identifier.
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<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="id">music://id.echonest.com/~/AR/AR2UWUD1187B9B3B01</parameter>
<parameter name="start">0</parameter>
<parameter name="rows">3</parameter>
</query>
<similar>
<artist>
<id>music://id.echonest.com/~/AR/ARKG7TE1187B9A45D8</id>
<name>Dinah Washington</name>
<rank>1</rank>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AR7BGWD1187FB59CCB</id>
<name>music://id.echonest.com/~/AR/Aretha Franklin</name>
<rank>2</rank>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AREQIT21187B9AEB7F</id>
<name>Dusty Springfield</name>
<rank>3</rank>
</artist>
</similar>
</response>
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 |