get_audio
Get a list of audio documents found on the web related to an artist.
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 |
| format | optional | no | String 'xml' or 'xspf' | Defaults to 'xml'. Response format |
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">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="980" shown="2" start="0">
<doc id="26e8c680acae9f93dd0062e51069d0dd" type="audio">
<artist>Radiohead</artist>
<release>Winter Wonderland</release>
<title>Winter Wonderland</title>
<url>http://www.vaguespace.net/files/radiohead---winter-wonderland.mp3</url>
<link>http://www.vaguespace.net</link>
<date>2008-12-09 07:30:20.903000</date>
<length>215.0</length>
</doc>
<doc id="c3c6636af07b60f0a0a7376b31f4c76f" type="audio">
<artist>Radiohead</artist>
<release>Me & this Army: Radiohead Remi</release>
<title>Creep (Fitter Happier Remix)</title>
<url>http://www.rollogrady.org/media/wp-content/uploads/2008/12/creep-fitter-happier-remix-1.mp3</url>
<link>http://www.rollogrady.com</link>
<date>2008-12-07 07:30:00.605000</date>
<length>209.0</length>
</doc>
</results>
</response>
Other Formats
- Also available as a feed in xspf, rss, atom formats
- e.g. http://developer.echonest.com/artist/Modest+Mouse/audio.xspf
- e.g. http://developer.echonest.com/artist/Modest+Mouse/audio.rss
- e.g. http://developer.echonest.com/artist/Modest+Mouse/audio.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 |