Skip to content
Python client for the Echo Nest API
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
doc
examples
pyechonest
.gitmodules
AUTHORS
INSTALL
LICENSE
README
generate_dist.sh
mkrelease.sh
setup.cfg
setup.py

README

Welcome to pyechonest, a python wrapper around the Echo Nest API (v4).

This client library should allow you to get started using the Echo Nest API quickly and easily. The only requirement is a developer API key, which you can get for free from http://developer.echonest.com/account/register/.

For documentation questions, please refer to the official api docs, which are available at http://developer.echonest.com/.

IMPORTANT: You must let pyechonest know about your API key before you use it. There are two ways to let pyechonest know about your API key:
	
	1. Set the variable ECHO_NEST_API_KEY in your environment to your key.
		(bourne-like shells) 	$ export ECHO_NEST_API_KEY=YOUR_API_KEY
		(c-like shells)		$ setenv ECHO_NEST_API_KEY YOUR_API_KEY
	
	2. In Python, do this:
		>>> from pyechonest import config
		>>> config.ECHO_NEST_API_KEY = YOUR_API_KEY


Examples:
	Search for artist:
		>>> from pyechonest import artist
		>>> weezer_results = artist.search(name='weezer')
		>>> weezer = weezer_results[0]
		>>> weezer_blogs = weezer.blogs
		>>> print 'Blogs about weezer:', [blog.get('url') for blog in weezer_blogs]
	
	Get an artist by name:
	       	>>> from pyechonest import artist
	       	>>> a = artist.Artist('lady gaga')
	    	>>> print a.id
	
	Get an artist from their Musicbrainz ID:
		>>> from pyechonest import artist
		>>> a = artist.Artist('musicbrainz:artist:a74b1b7f-71a5-4011-9441-d0b5e4122711')
		>>> print a.name

	Get the top hottt artists:
		>>> from pyechonest import artist
		>>> for hottt_artist in artist.top_hottt():
		>>>     print hottt_artist.name, hottt_artist.hotttnesss
    
	Search for songs:
		>>> from pyechonest import song
		>>> rkp_results = song.search(artist='radiohead', title='karma police')
		>>> karma_police = rkp_results[0]
		>>> print karma_police.artist_location
		>>> print 'tempo:',karma_police.audio_summary['tempo'],'duration:',karma_police.audio_summary['duration']

	Get a song's audio_url and analysis_url:
		>>> from pyechonest import song
		>>> wn_results = song.search(combined='the national - wasp nest', buckets=['id:7digital'], limit=True)
		>>> wasp_nest = wn_results[0]
		>>> wn_tracks = wasp_nest.get_tracks('7digital')
		>>> print wn_tracks[0].get('preview_url')
	

Something went wrong with that request. Please try again.