get_top_hottt_artists
Retrieves a list of the top hottt artists.
- Example: http://developer.echonest.com/api/get_top_hottt_artists?api_key=5ZAOMB3BUR8QUN4PE&rows=2&version=3
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 |
| rows | optional | no | Integer <= 1000 | Defaults to 15. The number of results to return |
| 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. |
| idlimit | optional | no | Character 'Y' or 'N' | Defaults to 'N'. Whether to limit results to artists in your id space. |
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="api_key">VW2XZJWVTDSZELREO</parameter>
<parameter name="action">index</parameter>
<parameter name="method">get_top_hottt_artists</parameter>
<parameter name="rows">2</parameter>
</query>
<artists>
<artist>
<id>music://id.echonest.com/~/AR/ARI7DOB1187FB37AA4</id>
<hotttnesss>1.0</hotttnesss>
</artist>
<artist>
<id>music://id.echonest.com/~/AR/ARGHEC01187FB597B0</id>
<hotttnesss>0.847318545736</hotttnesss>
</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 |