upload
Upload a track to The Echo Nest's analyzer for analysis and later retrieval of track information.
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 |
| url | one of url or file | no | URL | A publicly available resource on the web |
| file | one of url or file | no | File | A local file to POST as an upload |
| analysis_version | optional | no | Integer | Defaults to 3. |
| wait | optional | no | Character 'Y' or 'N' | Defaults to 'N'. Whether to wait on the analyzer to complete; automatically cuts off after a minute |
Note: This method requires an HTTP GET or POST 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="url">http://mutedandtender.com/mp3/ThereThere.mp3</parameter>
<parameter name="wait">N</parameter>
</query>
<track id="music://id.echonest.com/~/TR/TRMVA0211BC6E08329" md5="2f45abacba9e9d2312afa63a8df10d23" ready="false" />
</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 |