The Echo Nest / Spotify APIs

Build your music apps with the industry’s best music APIs.


What's this?

The Echo Nest and Spotify APIs provides broad and deep data on millions of artists and songs, making it easy for you to create an awesome listening experience for your users. You can tap into the power of the tightly linked Echo Nest and Spotify APIs to build world-class music apps that take advantage of all of the capabilities and deep data provided by both APIs. The Spotify and Echo Nest teams are working to make it as easy as possible for developers to use the Spotify and The Echo Nest APIs together. In particular we’re working to make sure that the Echo Nest has the most up-to-date view of the Spotify catalog and you can use Spotify artist and track IDs in any Echo Nest call that accepts Echo Nest artist and track IDs.

Getting Started

To get started, you’ll need to take two quick steps. It should take less than a minute!

    Register for an Echo Nest API key Register your Spotify application
Once you've created an account, have received your API key and application credentials, check out some of our demos, take a look at the examples, get inspiration from the labs, download one of our client libraries and start building cool stuff.

Demos

We have a number of demonstration and example apps that show you how to do just about anything possible with The Spotify and Echo Nest APIs, from retrieving basic artist data, to advanced personalized, dynamic playlisting.

Examples

The best way to understand an API is by diving in and seeing working examples in action. Check out the examples on the Echo Nest / Spotify git repo.

Demonstrations

These are more sophisticated apps that demonstrate the power of using The Echo Nest and the Spotify APIs together.

    The 3D Music Maze

    Music exploration as a game

    The 3D Music Maze is a WebGL app that lets you wander around a Castle Wolfenstein style maze and sample music and enjoy the album art.

    The Source



    The Genre Browser

    Browse through the many hundreds of genres to discover new artists

    With The Genre Browser you can learn about a new genres. You can read about the background and history of the genre, listen to its music, learn about the genre’s key artists and more.

    The Source



    Music Popcorn

    Dynamic visualization of the genre space

    Music Popcorn is a visualization of the music space that lets you explore and learn about the many different music genres.

    The Source



    Boil the Frog

    Create seamless genre-transitioning playlists between artists

    Boil the Frog lets you create a playlist of songs that gradually takes you from one music style to another. It's like the proverbial frog in the pot of water. If you heat up the pot slowly enough, the frog will never notice that he's being made into a stew and jump out of the pot. With a Boil the frog playlist you can do the same, but with music. You can generate a playlist that will take the listener from one style of music to the other, without the listener ever noticing that they are being made into a stew. The Source



    The Set Listener

    Listen to your favorite artist's most recent show

    Going to a show? Not totally familiar with an artist’s catalog? Give The Set Listener a try. The Set Listener is a web app that will create a Spotify playlist of an artist’s most recent show. The Source



    Roadtrip Mixtape

    Create a mixtape of local artists for your roadtrip

    Roadtrip Mixtape is an application that you can use to create road trip playlists. Type in the name of your starting and ending points, and the application will create a playlist of music by artists that from the area you are traveling through.

    The Source



    Acrostify

    Create a Spotify playlist with a secret message hidden as an acrostic.

    Acrostify creates a Spotify playlist that embeds a secret message in the first character of each song in the playlist.

    The Source




Resources

Download one of our many Echo Nest and Spotify client libraries. Follow along with our tutorials (Echo Nest, Spotify).

API Documentation

Detailed API documentation can be found online at:

Need more help?

If you have a problem or need more help with the Echo Nest or Spotify APIs check out our Echo Nest support forums and the Spotify support page.


How to use the Echo Nest and Spotify APIs together

We use The Echo Nest’s Project Rosetta Stone to make it easy to work with Spotify IDs with The Echo Nest API. For example, Radiohead has a Spotify ID of 'spotify:artist:4Z8W4fKeB5YxbusRsdQVPb'. To find biographies for Radiohead using The Echo Nest API, starting from the Spotify ID, you would issue a query like this:
http://developer.echonest.com/api/v4/artist/biographies?api_key=YOUR_API_KEY&id=spotify:artist:4Z8W4fKeB5YxbusRsdQVPb
Similarly, you can query for detailed information for a Spotify track with a query like so:
http://developer.echonest.com/api/v4/song/profile?api_key=YOUR_API_KEY&track_id=spotify:track:4toSP60xmDNCFuXly8ywNZ&bucket=id:spotify&bucket=audio_summary

You can also retrieve Spotify IDs from any Echo Nest call that returns artist, song or track info. To do this, you use the bucket=id:spotify parameter on any call that returns artists, songs or tracks. As an example, to find artists similar to Radiohead, with Spotify foreign IDs returned, issue a call like this:

http://developer.echonest.com/api/v4/artist/similar?api_key=YOUR_API_KEY&id=spotify:artist:4Z8W4fKeB5YxbusRsdQVPb&bucket=id:spotify

The returned list of similar artists include the spotify IDs in the output like so:

{
    "foreign_ids": [
        {
            "catalog": "spotify",
            "foreign_id": "spotify:artist:4CvTDPKA6W06DRfBnZKrau"
        }
    ],
    "id": "ARH1N081187B9AC562",
    "name": "Thom Yorke"
}