Overview

The Echo Nest API allows you to call methods that respond in REST style XML. Individual methods are detailed in the menu on the left. The API root URL is located at http://developer.echonest.com/api/

You can call a method by using an HTTP GET to retrieve http://developer.echonest.com/api/[method] along with method specific arguments.

Keys

You must have your own API key to make use of The Echo Nest API. To obtain a key, register for an account.

Once you've logged in, the example method calls will include your API key instead of the guest API key shown to anonymous users. The guest API key is for demonstration purposes only and should not be used for any other application.

Caveats

Please use an identifiable User-Agent HTTP header for all requests. You avoid getting banned and it helps our logging.

Use common sense when deciding how many calls to make. For example, if you're making a web application, try not to hit the API on page load. Your account may be suspended if your key sees too much activity. See our terms of service for more information.

Encoding

Use UTF-8 encoding when sending arguments to API methods.

Discussion

Join our forums to provide feedback and discuss development with other developers.