analyze

Re-analyze a previously uploaded track.


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 one of id or md5 no Identifier An Echo Nest Identifier
md5 one of id or md5 no MD5 File Hash The MD5 hash of a previously uploaded file
analysis_version optional no Integer Defaults to 3. Analyzer version to use.

Note: This method requires an HTTP 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="id">music://id.echonest.com/~/TR/TRLFPPE11C3F10749F</parameter>
  </query>
</response>

Response Codes

-1Unknown error
0Success
1Missing/Invalid API key
2This API key is not allowed to call this method
3Rate limit exceeded
4Missing parameter
5Invalid parmameter