search_artists
Search for an artist using a query on the artist name. This may perform a sounds-like search to correct common spelling mistakes.
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 |
| query | yes | no | String | |
| exact | optional | no | Character 'Y' or 'N' | Defaults to 'N'. Whether to perform the exact look up of the artist name specified in the query. |
| sounds_like | optional | no | Character 'Y' or 'N' | Defaults to 'Y'. Whether to include in the search the artists whose names sound like your query. |
| idlimit | optional | no | Character 'Y' or 'N' | Defaults to 'N'. Limit results to the id spaces specified in the bucket parameter. |
| bucket | optional | yes | String 'audio,' 'biographies,' 'blogs,' 'familiarity,' 'hotttnesss,' 'images,' 'news,' 'reviews,' 'urls,' 'video,' or 'id:musicbrainz' | Flag for additional information to return with each artist result. |
| rows | optional | no | Integer <= 15 | Defaults to 15. The number of results to return |
Note: This method requires an HTTP GET request.
Example Response
<?xml version="1.0" encoding="UTF-8"?>
<response version="3">
<status>
<code>0</code>
<message>Success</message>
</status>
<query>
<parameter name="query">evanessence</parameter>
<parameter name="api_key">5ZAOMB3BUR8QUN4PE</parameter>
<parameter name="action">index</parameter>
<parameter name="method">search_artists</parameter>
</query>
<artists>
<artist>
<id>music://id.echonest.com/~/AR/AR99C2L1187B99316A</id>
<name>Evanesce</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARVXU2X1187B9AE6D8</id>
<name>Evanescence</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AR4PTOO1187FB3AC58</id>
<name>eufonius</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AREYQ3A1187B98BA0C</id>
<name>E-Fans</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AR56TKE1187B99EC17</id>
<name>EVANSCAPPS</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARW2RXE1187B9A338F</id>
<name>Iuvenes</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARGJSCJ1187FB55A94</id>
<name>Affonsinho</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/AR0P8PN1187FB46663</id>
<name>evenstar</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARO5QL31187FB52748</id>
<name>Offensor</name>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARTLL9E1187FB4436F</id>
<name>Bill Evans</name>
</artist>
</artists>
</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 |