get_sections
Retrieve a set of the locations of sections of a track in seconds after previously calling for analysis via upload. Sections are the largest chunks in the track and usually correspond to structural units (verse, bridge, solo).
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 | Analyzer version to use. |
| format | optional | no | String 'xml' or 'json' | 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/~/TR/TRLFPPE11C3F10749F</parameter>
</query>
<analysis>
<section start="0.00000" duration="7.54832"/>
<section start="7.54832" duration="25.36527"/>
<section start="32.91359" duration="18.43553"/>
<section start="51.34912" duration="7.16131"/>
<section start="58.51043" duration="17.94054"/>
<section start="76.45097" duration="17.88857"/>
<section start="94.33954" duration="16.83672"/>
<section start="111.17626" duration="8.27232"/>
<section start="119.44857" duration="69.72994"/>
<section start="189.17851" duration="26.47864"/>
<section start="215.65715" duration="6.26623"/>
<section start="221.92338" duration="6.96680"/>
<section start="228.89018" duration="7.67263"/>
</analysis>
</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 |