Artist – artist methods

class pyechonest.artist.Artist(id, **kwargs)

An Artist object

Attributes:

id (str): Echo Nest Artist ID

name (str): Artist Name

audio (list): Artist audio

biographies (list): Artist biographies

blogs (list): Artist blogs

familiarity (float): Artist familiarity

hotttnesss (float): Artist hotttnesss

images (list): Artist images

news (list): Artist news

reviews (list): Artist reviews

similar (list): Similar Artists

songs (list): A list of song objects

terms (list): Terms for an artist

urls (list): Artist urls

video (list): Artist video

You create an artist object like this:

>>> a = artist.Artist('ARH6W4X1187B99274F')
>>> a = artist.Artist('the national')
>>> a = artist.Artist('musicbrainz:artist:a74b1b7f-71a5-4011-9441-d0b5e4122711')

__cmp__(other)

__init__(id, **kwargs)

Artist class

Args:

id (str): an artistw ID

Returns:

An artist object

Example:

>>> a = artist.Artist('ARH6W4X1187B99274F', buckets=['hotttnesss'])
>>> a.hotttnesss
0.80098515900997658
>>>

__repr__()

__str__()

get_audio(results=15, start=0, cache=True)

Get a list of audio documents found on the web related to an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

Returns:

A list of audio document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('alphabeat')
>>> a.get_audio()[0]
{u'artist': u'Alphabeat',
 u'date': u'2010-04-28T01:40:45',
 u'id': u'70be4373fa57ac2eee8c7f30b0580899',
 u'length': 210.0,
 u'link': u'http://iamthecrime.com',
 u'release': u'The Beat Is...',
 u'title': u'DJ',
 u'url': u'http://iamthecrime.com/wp-content/uploads/2010/04/03_DJ_iatc.mp3'}
>>> 

get_biographies(results=15, start=0, license='', cache=True)

Get a list of artist biographies

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

license (str): A string specifying the desired license type

Returns:

A list of biography document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('britney spears')
>>> bio = a.get_biographies(results=1)[0]
>>> bio['url']
u'http://www.mtvmusic.com/spears_britney'
>>> 

get_blogs(results=15, start=0, cache=True, high_relevance=False)

Get a list of blog articles related to an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An ingteger starting value for the result set

Returns:

A list of blog document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('bob marley')
>>> blogs = a.get_blogs(results=1,start=4)
>>> blogs.total
4068
>>> blogs[0]['summary']
But the Kenyans I know relate to music about the same way Americans do. They like their Congolese afropop, 
and I've known some to be big fans of international acts like <span>Bob</span> <span>Marley</span> and Dolly Parton. 
They rarely talk about music that's indigenous in the way a South African or Malian or Zimbabwean would, and it's 
even rarer to actually hear such indigenous music. I do sometimes hear ceremonial chanting from the Maasai, but only 
when they're dancing for tourists. If East Africa isn't the most musical part ... "
>>> 

get_familiarity(cache=True)

Get our numerical estimation of how familiar an artist currently is to the world

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

Returns:

A float representing familiarity.

Example:

>>> a = artist.Artist('frank sinatra')
>>> a.get_familiarity()
0.65142555825947457
>>> a.familiarity
0.65142555825947457
>>>

get_foreign_id(idspace='musicbrainz', cache=True)

Get the foreign id for this artist for a specific id space

Args:

Kwargs:

idspace (str): A string indicating the idspace to fetch a foreign id for.

Returns:

A foreign ID string

Example:

>>> a = artist.Artist('fabulous')
>>> a.get_foreign_id('7digital')
u'7digital:artist:186042'
>>> 

get_hotttnesss(cache=True)

Get our numerical description of how hottt an artist currently is

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

Returns:

float: the hotttnesss value

Example:

>>> a = artist.Artist('hannah montana')
>>> a.get_hotttnesss()
0.59906022155998995
>>> a.hotttnesss
0.59906022155998995
>>>

get_images(results=15, start=0, license='', cache=True)

Get a list of artist images

Args:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

license (str): A string specifying the desired license type

Returns:

A list of image document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('Captain Beefheart')
>>> images = a.get_images(results=1)
>>> images.total
49
>>> images[0]['url']
u'http://c4.ac-images.myspacecdn.com/images01/5/l_e1a329cdfdb16a848288edc6d578730f.jpg'
>>> 

get_news(results=15, start=0, cache=True, high_relevance=False)

Get a list of news articles found on the web related to an artist

Args:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

Returns:

A list of news document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('Henry Threadgill')
>>> news = a.news
>>> news.total
41
>>> news[0]['name']
u'Jazz Journalists Association Announces 2010 Jazz Award Winners'
>>> 

get_reviews(results=15, start=0, cache=True)

Get reviews related to an artist’s work

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

Returns:

A list of review document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('Ennio Morricone')
>>> reviews = a.reviews
>>> reviews.total
17
>>> reviews[0]['release']
u'For A Few Dollars More'
>>> 

get_similar(results=15, start=0, buckets=None, limit=False, cache=True, max_familiarity=None, min_familiarity=None, max_hotttnesss=None, min_hotttnesss=None, min_results=None, reverse=False)

Return similar artists to this one

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

max_familiarity (float): A float specifying the max familiarity of artists to search for

min_familiarity (float): A float specifying the min familiarity of artists to search for

max_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

min_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

reverse (bool): A boolean indicating whether or not to return dissimilar artists (wrecommender). Defaults to False.

Returns:

A list of similar Artist objects

Example:

>>> a = artist.Artist('Sleater Kinney')
>>> similars = a.similar[:5]
>>> similars
[<artist - Bikini Kill>, <artist - Pretty Girls Make Graves>, <artist - Huggy Bear>, <artist - Bratmobile>, <artist - Team Dresch>]
>>> 

get_songs(cache=True, results=15, start=0)

Get the songs associated with an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

Results:

A list of Song objects; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('Strokes')
>>> a.get_songs(results=5)
[<song - Fear Of Sleep>, <song - Red Light>, <song - Ize Of The World>, <song - Evening Sun>, <song - Juicebox>]
>>> 

get_terms(sort='weight', cache=True)

Get the terms associated with an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

sort (str): A string specifying the desired sorting type (weight or frequency)

Results:

A list of term document dicts

Example:

>>> a = artist.Artist('tom petty')
>>> a.terms
[{u'frequency': 1.0, u'name': u'heartland rock', u'weight': 1.0},
 {u'frequency': 0.88569401860168606,
  u'name': u'jam band',
  u'weight': 0.9116501862732439},
 {u'frequency': 0.9656145118557401,
  u'name': u'pop rock',
  u'weight': 0.89777934440040685},
 {u'frequency': 0.8414744288140491,
  u'name': u'southern rock',
  u'weight': 0.8698567153186606},
 {u'frequency': 0.9656145118557401,
  u'name': u'hard rock',
  u'weight': 0.85738022655218893},
 {u'frequency': 0.88569401860168606,
  u'name': u'singer-songwriter',
  u'weight': 0.77427243392312772},
 {u'frequency': 0.88569401860168606,
  u'name': u'rock',
  u'weight': 0.71158718989399083},
 {u'frequency': 0.60874110500110956,
  u'name': u'album rock',
  u'weight': 0.69758668733499629},
 {u'frequency': 0.74350792060935744,
  u'name': u'psychedelic',
  u'weight': 0.68457367494207944},
 {u'frequency': 0.77213698386292873,
  u'name': u'pop',
  u'weight': 0.65039556639337293},
 {u'frequency': 0.41747136183050298,
  u'name': u'bar band',
  u'weight': 0.54974975024767025}]
>>> 

get_urls(cache=True)

Get the urls for an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

Results:

A url document dict

Example:

>>> a = artist.Artist('the unicorns')
>>> a.get_urls()
{u'amazon_url': u'http://www.amazon.com/gp/search?ie=UTF8&keywords=The Unicorns&tag=httpechonecom-20&index=music',
 u'aolmusic_url': u'http://music.aol.com/artist/the-unicorns',
 u'itunes_url': u'http://itunes.com/TheUnicorns',
 u'lastfm_url': u'http://www.last.fm/music/The+Unicorns',
 u'mb_url': u'http://musicbrainz.org/artist/603c5f9f-492a-4f21-9d6f-1642a5dbea2d.html',
 u'myspace_url': u'http://www.myspace.com/iwasbornunicorn'}
>>> 

get_video(results=15, start=0, cache=True)

Get a list of video documents found on the web related to an artist

Args:

Kwargs:

cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.

results (int): An integer number of results to return

start (int): An integer starting value for the result set

Returns:

A list of video document dicts; list contains additional attributes ‘start’ and ‘total’

Example:

>>> a = artist.Artist('the vapors')
>>> a.get_video(results=1, start=2)
[{u'date_found': u'2009-12-28T08:27:48',
  u'id': u'd02f9e6dc7904f70402d4676516286b9',
  u'image_url': u'http://i1.ytimg.com/vi/p6c0wOFL3Us/default.jpg',
  u'site': u'youtube',
  u'title': u'The Vapors-Turning Japanese (rectangular white vinyl promo)',
  u'url': u'http://youtube.com/watch?v=p6c0wOFL3Us'}]
>>> 

static artist.search(name=None, description=None, results=15, buckets=None, limit=False, fuzzy_match=False, sort=None, max_familiarity=None, min_familiarity=None, max_hotttnesss=None, min_hotttnesss=None)

Search for artists by name, description, or constraint.

Args:

Kwargs:

name (str): the name of an artist

description (str): A string describing the artist

results (int): An integer number of results to return

buckets (list): A list of strings specifying which buckets to retrieve

limit (bool): A boolean indicating whether or not to limit the results to one of the id spaces specified in buckets

fuzzy_match (bool): A boolean indicating whether or not to search for similar sounding matches (only works with name)

max_familiarity (float): A float specifying the max familiarity of artists to search for

min_familiarity (float): A float specifying the min familiarity of artists to search for

max_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

min_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

Returns:

A list of Artist objects

Example:

>>> results = artist.search(name='t-pain')
>>> results
[<artist - T-Pain>, <artist - T-Pain & Lil Wayne>, <artist - T Pain & 2 Pistols>, <artist - Roscoe Dash & T-Pain>, <artist - Tony Moxberg & T-Pain>, <artist - Flo-Rida (feat. T-Pain)>, <artist - Shortyo/Too Short/T-Pain>]
>>> 

static artist.top_hottt(start=0, results=15, buckets=None, limit=False)

Get the top hotttest artists, according to The Echo Nest

Args:

Kwargs:

results (int): An integer number of results to return

start (int): An integer starting value for the result set

buckets (list): A list of strings specifying which buckets to retrieve

limit (bool): A boolean indicating whether or not to limit the results to one of the id spaces specified in buckets

Returns:

A list of hottt Artist objects

Example:

>>> hot_stuff = artist.top_hottt()
>>> hot_stuff
[<artist - Deerhunter>, <artist - Sufjan Stevens>, <artist - Belle and Sebastian>, <artist - Glee Cast>, <artist - Linkin Park>, <artist - Neil Young>, <artist - Jimmy Eat World>, <artist - Kanye West>, <artist - Katy Perry>, <artist - Bruno Mars>, <artist - Lady Gaga>, <artist - Rihanna>, <artist - Lil Wayne>, <artist - Jason Mraz>, <artist - Green Day>]
>>> 

static artist.top_terms(results=15)

Get a list of the top overall terms

Args:

Kwargs:

results (int): An integer number of results to return

Returns:

A list of term document dicts

Example:

>>> terms = artist.top_terms(results=5)
>>> terms
[{u'frequency': 1.0, u'name': u'rock'},
 {u'frequency': 0.99054710039307992, u'name': u'electronic'},
 {u'frequency': 0.96131624654034398, u'name': u'hip hop'},
 {u'frequency': 0.94358477322411127, u'name': u'jazz'},
 {u'frequency': 0.94023302416455468, u'name': u'pop rock'}]
>>> 

static artist.similar(names=None, ids=None, start=0, results=15, buckets=None, limit=False, max_familiarity=None, min_familiarity=None, max_hotttnesss=None, min_hotttnesss=None)

Return similar artists to this one

Args:

Kwargs:

ids (str/list): An artist id or list of ids

names (str/list): An artist name or list of names

results (int): An integer number of results to return

buckets (list): A list of strings specifying which buckets to retrieve

limit (bool): A boolean indicating whether or not to limit the results to one of the id spaces specified in buckets

start (int): An integer starting value for the result set

max_familiarity (float): A float specifying the max familiarity of artists to search for

min_familiarity (float): A float specifying the min familiarity of artists to search for

max_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

min_hotttnesss (float): A float specifying the max hotttnesss of artists to search for

Returns:

A list of similar Artist objects

Example:

>>> some_dudes = [artist.Artist('weezer'), artist.Artist('radiohead')]
>>> some_dudes
[<artist - Weezer>, <artist - Radiohead>]
>>> sims = artist.similar(ids=[art.id for art in some_dudes], results=5)
>>> sims
[<artist - The Smashing Pumpkins>, <artist - Biffy Clyro>, <artist - Death Cab for Cutie>, <artist - Jimmy Eat World>, <artist - Nerf Herder>]
>>>