Module Expr Str Import alias ImportFrom alias alias ImportFrom alias ClassDef bases NameLoad body Expr Str FunctionDef arguments args NameParam NameParam defaults kwarg body Expr Str Expr Call AttributeLoad Call NameLoad NameLoad NameLoad attr NameLoad NameLoad decorator_list FunctionDef arguments args NameParam defaults body Return BinOpMod Str TupleLoad Call AttributeLoad AttributeLoad NameLoad attr attr Str Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list FunctionDef arguments args NameParam defaults body Return Call AttributeLoad AttributeLoad NameLoad attr attr Str decorator_list FunctionDef arguments args NameParam NameParam defaults body Return Call NameLoad AttributeLoad NameLoad attr AttributeLoad NameLoad attr decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults Num Num NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num CompareEq NameLoad NameLoad body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num CompareEq NameLoad NameLoad body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num UnaryOpNot NameLoad body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore IfExp NameLoad Str Str Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If UnaryOpNot BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad SubscriptLoad NameLoad Index Str Index Str Return SubscriptLoad AttributeLoad NameLoad attr Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam defaults Str NameLoad body Expr Str If UnaryOpNot BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr Call NameLoad Lambda arguments args NameParam defaults CompareEq Call AttributeLoad NameLoad attr Str NameLoad SubscriptLoad AttributeLoad NameLoad attr Index Str body Assign NameStore Call AttributeLoad NameLoad attr Str keyword ListLoad BinOpAdd Str NameLoad Assign NameStore Call AttributeLoad SubscriptLoad NameLoad Index Str attr Str ListLoad Assign SubscriptStore AttributeLoad NameLoad attr Index Str BinOpAdd Call AttributeLoad AttributeLoad NameLoad attr attr Str ListLoad NameLoad Assign NameStore Call NameLoad Lambda arguments args NameParam defaults CompareEq Call AttributeLoad NameLoad attr Str Call AttributeLoad NameLoad attr NameLoad Call AttributeLoad AttributeLoad NameLoad attr attr Str Return IfExp NameLoad Call AttributeLoad SubscriptLoad NameLoad Index Num attr Str NameLoad decorator_list FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If UnaryOpNot BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call AttributeLoad SubscriptLoad NameLoad Index Str attr Str Return SubscriptLoad AttributeLoad NameLoad attr Index Str decorator_list FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If UnaryOpNot BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad SubscriptLoad NameLoad Index Str Index Str Return SubscriptLoad AttributeLoad NameLoad attr Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num CompareEq NameLoad NameLoad body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad keyword NameLoad Assign NameStore BoolOpOr Call AttributeLoad NameLoad attr Str Num If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num CompareEq NameLoad NameLoad body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num NameLoad Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad NameLoad decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num UnaryOpNot NameLoad body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore IfExp NameLoad Str Str Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam defaults Num Num NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad body Expr Str Assign NameStore BoolOpOr NameLoad ListLoad Assign NameStore Dict If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str Str If NameLoad body Assign SubscriptStore NameLoad Index Str Str If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num UnaryOpNot NameLoad body Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num UnaryOpNot NameLoad body Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad NameLoad Index Str Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam defaults NameLoad Num Num body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num body If UnaryOpNot Call NameLoad SubscriptLoad SubscriptLoad AttributeLoad NameLoad attr Index Str Index Num NameLoad body Assign NameStore ListLoad For NameStore SubscriptLoad AttributeLoad NameLoad attr Index Str body Expr Call AttributeLoad NameLoad attr Call NameLoad keyword SubscriptLoad NameLoad Index Str keyword SubscriptLoad NameLoad Index Str keyword AttributeLoad NameLoad attr keyword AttributeLoad NameLoad attr Assign SubscriptStore AttributeLoad NameLoad attr Index Str NameLoad Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad For NameStore SubscriptLoad NameLoad Index Str body Expr Call AttributeLoad NameLoad attr Dict Str Str AttributeLoad NameLoad attr AttributeLoad NameLoad attr Assign NameStore ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad NameLoad Index Str If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad NameLoad Num SubscriptLoad NameLoad Index Str Return Call NameLoad NameLoad NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam defaults Str NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Str body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad If CompareEq NameLoad Str body Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad NameLoad Index Str Return SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If UnaryOpNot BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad NameLoad Index Str Return SubscriptLoad AttributeLoad NameLoad attr Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam NameParam NameParam defaults Num Num NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr CompareEq NameLoad Num CompareEq NameLoad Num body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword NameLoad keyword NameLoad If BoolOpAnd CompareEq NameLoad Num CompareEq NameLoad Num body Assign SubscriptStore AttributeLoad NameLoad attr Index Str Call NameLoad SubscriptLoad NameLoad Index Str Num SubscriptLoad NameLoad Index Str Return Call NameLoad SubscriptLoad NameLoad Index Str NameLoad SubscriptLoad NameLoad Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If BoolOpAnd NameLoad CompareIn Str AttributeLoad NameLoad attr body Return SubscriptLoad AttributeLoad NameLoad attr Index Str orelse Assign NameStore Call AttributeLoad NameLoad attr Str keyword ListLoad Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad SubscriptLoad NameLoad Index Str Index Str Return SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list Assign NameStore Call NameLoad NameLoad FunctionDef arguments args NameParam NameParam defaults NameLoad body Expr Str If BoolOpOr UnaryOpNot NameLoad UnaryOpNot CompareIn Str AttributeLoad NameLoad attr body Assign NameStore Call AttributeLoad NameLoad attr Str keyword Str Assign SubscriptStore AttributeLoad NameLoad attr Index Str SubscriptLoad SubscriptLoad NameLoad Index Str Index Str Return SubscriptLoad AttributeLoad NameLoad attr Index Str decorator_list Assign NameStore Call NameLoad NameLoad decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad NameLoad NameLoad Num Num NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad body Expr Str Assign NameStore Call AttributeLoad Call NameLoad NameLoad attr Assign NameStore Call AttributeLoad Call NameLoad NameLoad attr Assign NameStore Call NameLoad Assign SubscriptStore NameLoad Index Str BoolOpOr NameLoad ListLoad Delete SubscriptDel NameLoad Index Str Expr Str Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam defaults Num Num NameLoad NameLoad body Expr Str Assign NameStore BoolOpOr NameLoad ListLoad Assign NameStore Dict If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str Str Expr Str Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam defaults Num body Expr Str Assign NameStore Dict If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad Expr Str Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam defaults body Expr Str Assign NameStore Dict Str NameLoad Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args defaults body Expr Str Assign NameStore Dict Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults NameLoad NameLoad Num Num NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad body Expr Str Assign NameStore BoolOpOr NameLoad ListLoad Assign NameStore Dict If NameLoad body If UnaryOpNot Call NameLoad NameLoad NameLoad body Assign NameStore ListLoad NameLoad Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body If UnaryOpNot Call NameLoad NameLoad NameLoad body Assign NameStore ListLoad NameLoad Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str Str If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults Str Num Num NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad body Expr Str Assign NameStore BoolOpOr NameLoad ListLoad Assign NameStore Dict Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str Str Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list FunctionDef arguments args NameParam NameParam NameParam NameParam NameParam NameParam NameParam NameParam defaults Str Num NameLoad NameLoad NameLoad NameLoad NameLoad NameLoad body Expr Str Assign NameStore BoolOpOr NameLoad ListLoad Assign NameStore Dict Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If CompareIsNot NameLoad NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str NameLoad If NameLoad body Assign SubscriptStore NameLoad Index Str Str Assign NameStore Call AttributeLoad NameLoad attr BinOpMod Str TupleLoad Str Str NameLoad Return ListComp Call NameLoad Call AttributeLoad NameLoad attr NameLoad comprehension NameStore SubscriptLoad SubscriptLoad NameLoad Index Str Index Str decorator_list
N/A N/A 
Copyright (c) 2010 The Echo Nest. All rights reserved.
Created by Tyler Williams on 2010-04-25.

The Artist module loosely covers http://developer.echonest.com/docs/v4/artist.html
Refer to the official api documentation if you are unsure about something.
 N/A util proxies ArtistProxy ResultList song Song Artist N/A ArtistProxy N/A N/A 
    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
        
        years_active (list): A list of dictionaries containing start and stop years
        
    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')
        
     __init__ N/A N/A self id N/A kwargs N/A N/A 
        Artist class
        
        Args:
            id (str): an artistw ID 
            
        Returns:
            An artist object
            
        Example:
        
        >>> a = artist.Artist('ARH6W4X1187B99274F', buckets=['hotttnesss'])
        >>> a.hotttnesss
        0.80098515900997658
        >>>
        
         N/A N/A N/A N/A super Artist self __init__ id kwargs N/A __repr__ N/A N/A self N/A N/A N/A N/A <%s - %s> N/A N/A N/A N/A self _object_type encode utf-8 N/A N/A N/A self name encode utf-8 N/A __str__ N/A N/A self N/A N/A N/A N/A N/A N/A self name encode utf-8 N/A __cmp__ N/A N/A self other N/A N/A N/A N/A cmp N/A self id N/A other id N/A get_audio N/A N/A self results start cache N/A 15 0 True N/A N/A 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'}
        >>> 
         N/A N/A cache N/A audio N/A self cache N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A audio N/A N/A response N/A N/A self get_attribute audio results results start start N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A audio N/A ResultList N/A response N/A audio 0 N/A response N/A total N/A N/A ResultList N/A response N/A audio start N/A response N/A total N/A N/A audio N/A property get_audio get_biographies N/A N/A self results start license cache N/A 15 0 None True N/A N/A 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'
        >>> 
         N/A N/A cache N/A biographies N/A self cache N/A results 15 N/A start 0 N/A license None N/A N/A N/A N/A self cache N/A biographies N/A N/A response N/A N/A self get_attribute biographies results results start start license license N/A N/A N/A results 15 N/A start 0 N/A license None N/A N/A N/A N/A self cache N/A biographies N/A ResultList N/A response N/A biographies 0 N/A response N/A total N/A N/A ResultList N/A response N/A biographies start N/A response N/A total N/A N/A biographies N/A property get_biographies get_blogs N/A N/A self results start cache high_relevance N/A 15 0 True False N/A N/A 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 ... "
        >>> 
         N/A N/A cache N/A blogs N/A self cache N/A results 15 N/A start 0 N/A high_relevance N/A N/A N/A N/A self cache N/A blogs N/A N/A high_relevance N/A high_relevance true false N/A response N/A N/A self get_attribute blogs results results start start high_relevance high_relevance N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A blogs N/A ResultList N/A response N/A blogs 0 N/A response N/A total N/A N/A ResultList N/A response N/A blogs start N/A response N/A total N/A N/A blogs N/A property get_blogs get_familiarity N/A N/A self cache N/A True N/A N/A 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
        >>>
         N/A N/A N/A cache N/A familiarity N/A self cache N/A N/A response N/A N/A self get_attribute familiarity N/A N/A N/A self cache N/A familiarity N/A N/A response N/A artist N/A familiarity N/A N/A N/A self cache N/A familiarity N/A N/A familiarity N/A property get_familiarity get_foreign_id N/A N/A self idspace cache N/A musicbrainz True N/A N/A 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'
        >>> 
         N/A N/A N/A cache N/A foreign_ids N/A self cache N/A filter N/A N/A N/A d N/A N/A N/A N/A d get catalog idspace N/A N/A self cache N/A foreign_ids N/A N/A response N/A N/A self get_attribute profile bucket N/A N/A id: idspace N/A foreign_ids N/A N/A N/A response N/A artist get foreign_ids N/A N/A N/A N/A self cache N/A foreign_ids N/A N/A N/A N/A self cache get foreign_ids N/A foreign_ids N/A cval N/A filter N/A N/A N/A d N/A N/A N/A N/A d get catalog N/A N/A util map_idspace idspace N/A N/A N/A self cache get foreign_ids N/A N/A cval N/A N/A N/A cval N/A 0 get foreign_id None N/A get_twitter_id N/A N/A self cache N/A True N/A N/A Get the twitter id for this artist if it exists

        Args:

        Kwargs:

        Returns:
            A twitter ID string

        Example:

        >>> a = artist.Artist('big boi')
        >>> a.get_twitter_id()
        u'BigBoi'
        >>>
         N/A N/A N/A cache N/A twitter N/A self cache N/A N/A response N/A N/A self get_attribute twitter N/A N/A N/A self cache N/A twitter N/A N/A N/A response N/A artist get twitter N/A N/A N/A self cache N/A twitter N/A get_hotttnesss N/A N/A self cache N/A True N/A N/A 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
        >>>
         N/A N/A N/A cache N/A hotttnesss N/A self cache N/A N/A response N/A N/A self get_attribute hotttnesss N/A N/A N/A self cache N/A hotttnesss N/A N/A response N/A artist N/A hotttnesss N/A N/A N/A self cache N/A hotttnesss N/A N/A hotttnesss N/A property get_hotttnesss get_images N/A N/A self results start license cache N/A 15 0 None True N/A N/A 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'
        >>> 
         N/A N/A cache N/A images N/A self cache N/A results 15 N/A start 0 N/A license None N/A N/A N/A N/A self cache N/A images N/A N/A response N/A N/A self get_attribute images results results start start license license N/A total N/A N/A N/A response get total 0 N/A N/A N/A results 15 N/A start 0 N/A license None N/A N/A N/A N/A self cache N/A images N/A ResultList N/A response N/A images 0 total N/A N/A ResultList N/A response N/A images start total N/A N/A images N/A property get_images get_news N/A N/A self results start cache high_relevance N/A 15 0 True False N/A N/A 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'
        >>> 
         N/A N/A cache N/A news N/A self cache N/A results 15 N/A start 0 N/A high_relevance N/A N/A N/A N/A self cache N/A news N/A N/A high_relevance N/A high_relevance true false N/A response N/A N/A self get_attribute news results results start start high_relevance high_relevance N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A news N/A ResultList N/A response N/A news 0 N/A response N/A total N/A N/A ResultList N/A response N/A news start N/A response N/A total N/A N/A news N/A property get_news get_reviews N/A N/A self results start cache N/A 15 0 True N/A N/A 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'
        >>> 
         N/A N/A cache N/A reviews N/A self cache N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A reviews N/A N/A response N/A N/A self get_attribute reviews results results start start N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A reviews N/A ResultList N/A response N/A reviews 0 N/A response N/A total N/A N/A ResultList N/A response N/A reviews start N/A response N/A total N/A N/A reviews N/A property get_reviews get_similar N/A N/A self results start buckets limit cache max_familiarity min_familiarity max_hotttnesss min_hotttnesss min_results reverse artist_start_year_before artist_start_year_after artist_end_year_before artist_end_year_after N/A 15 0 None False True None None None None None False None None None None N/A N/A 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>]
        >>> 
         N/A buckets N/A buckets N/A N/A kwargs N/A N/A max_familiarity N/A N/A N/A kwargs N/A max_familiarity max_familiarity N/A min_familiarity N/A N/A N/A kwargs N/A min_familiarity min_familiarity N/A max_hotttnesss N/A N/A N/A kwargs N/A max_hotttnesss max_hotttnesss N/A min_hotttnesss N/A N/A N/A kwargs N/A min_hotttnesss min_hotttnesss N/A min_results N/A N/A N/A kwargs N/A min_results min_results N/A buckets N/A N/A N/A kwargs N/A bucket buckets N/A limit N/A N/A N/A kwargs N/A limit true N/A reverse N/A N/A N/A kwargs N/A reverse true N/A artist_start_year_before N/A N/A N/A kwargs N/A artist_start_year_before artist_start_year_before N/A artist_start_year_after N/A N/A N/A kwargs N/A artist_start_year_after artist_start_year_after N/A artist_end_year_before N/A N/A N/A kwargs N/A artist_end_year_before artist_end_year_before N/A artist_end_year_after N/A N/A N/A kwargs N/A artist_end_year_after artist_end_year_after N/A N/A cache N/A similar N/A self cache N/A results 15 N/A start 0 N/A kwargs N/A N/A N/A N/A Artist N/A N/A util fix a N/A a N/A N/A self cache N/A similar N/A N/A response N/A N/A self get_attribute similar results results start start kwargs N/A N/A N/A results 15 N/A start 0 N/A kwargs N/A N/A N/A N/A self cache N/A similar N/A response N/A artists N/A N/A N/A Artist N/A N/A util fix a N/A a N/A response N/A artists N/A N/A similar N/A property get_similar get_songs N/A N/A self cache results start N/A True 15 0 N/A N/A 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>]
        >>> 
         N/A N/A cache N/A songs N/A self cache N/A results 15 N/A start 0 N/A N/A N/A N/A isinstance N/A N/A N/A self cache N/A songs N/A 0 Song N/A N/A song_objects N/A N/A s N/A N/A self cache N/A songs N/A N/A N/A N/A song_objects append N/A Song id N/A s N/A id title N/A s N/A title artist_name N/A self name artist_id N/A self id N/A N/A N/A self cache N/A songs song_objects N/A N/A N/A self cache N/A songs N/A N/A response N/A N/A self get_attribute songs results results start start N/A s N/A response N/A songs N/A N/A N/A N/A s update N/A artist_id artist_name N/A self id N/A self name N/A songs N/A N/A Song N/A N/A util fix s N/A s N/A response N/A songs N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A songs N/A ResultList songs 0 N/A response N/A total N/A N/A ResultList songs start N/A response N/A total N/A N/A songs N/A property get_songs get_terms N/A N/A self sort cache N/A weight True N/A N/A 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}]
        >>> 

         N/A N/A cache N/A terms N/A self cache N/A sort weight N/A N/A N/A N/A self cache N/A terms N/A N/A response N/A N/A self get_attribute terms sort sort N/A N/A sort weight N/A N/A N/A N/A self cache N/A terms N/A response N/A terms N/A N/A response N/A terms N/A N/A terms N/A property get_terms get_urls N/A N/A self cache N/A True N/A N/A 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'}
        >>> 

         N/A N/A N/A cache N/A urls N/A self cache N/A N/A response N/A N/A self get_attribute urls N/A N/A N/A self cache N/A urls N/A response N/A urls N/A N/A N/A self cache N/A urls N/A N/A urls N/A property get_urls get_video N/A N/A self results start cache N/A 15 0 True N/A N/A 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'}]
        >>> 

         N/A N/A cache N/A video N/A self cache N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A video N/A N/A response N/A N/A self get_attribute video results results start start N/A N/A N/A results 15 N/A start 0 N/A N/A N/A N/A self cache N/A video N/A ResultList N/A response N/A video 0 N/A response N/A total N/A N/A ResultList N/A response N/A video start N/A response N/A total N/A N/A video N/A property get_video get_years_active N/A N/A self cache N/A True N/A N/A Get a list of years active dictionaries for an artist
        
        Args:
        
        Kwargs:
            cache (bool): A boolean indicating whether or not the cached value should be used (if available). Defaults to True.
        
        Returns:
            A list of years active dictionaries; list contains additional attributes 'start' and 'total'
            
        Example:

        >>> a = artist.Artist('yelle')
        >>> a.get_years_active()
        [{ start: 2005 }]
        >>> 

         N/A N/A cache N/A years_active N/A self cache N/A N/A N/A N/A self cache N/A years_active N/A N/A response N/A N/A self get_attribute profile bucket N/A years_active N/A N/A N/A self cache N/A years_active N/A N/A response N/A artist N/A years_active N/A N/A N/A response N/A artist N/A years_active N/A N/A years_active N/A property get_years_active get_doc_counts N/A N/A self cache N/A True N/A N/A 
        Get the number of related documents of various types for the artist.
        The types include audio, biographies, blogs, images, news, reviews, songs, videos.
        
        Note that these documents can be retrieved by calling artist.<document type>, for example,
        artist.biographies.
        
        Args:
        
        Kwargs:
            cache (bool): A boolean indicating whether or not the cached value should be used (if available).
            Defaults to True.
        
        Returns:
            A dictionary with one key for each document type, mapped to an integer count of documents.
        
        Example:
        
        >>> a = artist.Artist("The Kinks")

        >>> a.get_doc_counts()
        {u'audio': 194,
         u'biographies': 9,
         u'blogs': 379,
         u'images': 177,
         u'news': 84,
         u'reviews': 110,
         u'songs': 499,
         u'videos': 340}
         >>>
         N/A N/A N/A cache N/A N/A doc_counts N/A self cache N/A N/A response N/A N/A self get_attribute profile bucket doc_counts N/A N/A N/A self cache N/A doc_counts N/A N/A response N/A artist N/A doc_counts N/A N/A N/A self cache N/A doc_counts N/A N/A doc_counts N/A property get_doc_counts N/A search N/A N/A name description style mood start results buckets limit fuzzy_match sort max_familiarity min_familiarity max_hotttnesss min_hotttnesss test_new_things rank_type artist_start_year_after artist_start_year_before artist_end_year_after artist_end_year_before N/A None None None None 0 15 None False False None None None None None None None None None None None N/A N/A Search for artists by name, description, or constraint.
    
    Args:
    
    Kwargs:
        name (str): the name of an artist
        
        description (str): A string describing the artist
        
        style (str): A string describing the style/genre of the artist
        
        mood (str): A string describing the mood of the artist
        
        start (int): An integer starting value for the result set

        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
        
        artist_start_year_before (int): Returned artists will have started recording music before this year.
        
        artist_start_year_after (int): Returned artists will have started recording music after this year.
        
        artist_end_year_before (int): Returned artists will have stopped recording music before this year.
        
        artist_end_year_after (int): Returned artists will have stopped recording music after this year.
        
        rank_type (str): A string denoting the desired ranking for description searches, either 'relevance' or 'familiarity'

    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>]
    >>> 

     N/A limit N/A N/A N/A str limit lower N/A fuzzy_match N/A N/A N/A str fuzzy_match lower N/A kwargs N/A locals N/A N/A kwargs N/A bucket N/A buckets N/A N/A N/A kwargs N/A buckets N/A Search for artists N/A result N/A N/A util callm N/A %s/%s N/A artist search kwargs N/A N/A N/A Artist N/A N/A util fix a_dict N/A a_dict N/A N/A result N/A response N/A artists N/A top_hottt N/A N/A start results buckets limit N/A 0 15 None False N/A N/A 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>]
    >>> 

     N/A buckets N/A buckets N/A N/A kwargs N/A N/A start N/A N/A N/A kwargs N/A start start N/A results N/A N/A N/A kwargs N/A results results N/A buckets N/A N/A N/A kwargs N/A bucket buckets N/A limit N/A N/A N/A kwargs N/A limit true N/A Get top hottt artists N/A result N/A N/A util callm N/A %s/%s N/A artist top_hottt kwargs N/A N/A N/A Artist N/A N/A util fix a_dict N/A a_dict N/A N/A result N/A response N/A artists N/A top_terms N/A N/A results N/A 15 N/A N/A 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'}]
    >>> 
     N/A kwargs N/A N/A results N/A N/A N/A kwargs N/A results results N/A Get top terms N/A result N/A N/A util callm N/A %s/%s N/A artist top_terms kwargs N/A N/A N/A result N/A response N/A terms N/A list_terms N/A N/A type N/A N/A N/A Get a list of best terms to use with search
    
    Args:
    
    Kwargs:
        type (str): the type of term to return, either 'mood' or 'style'
    
    Example:
    
    >>> best_terms = artist.list_terms('mood')
    >>> best_terms
    [{u'name': u'aggressive'},
     {u'name': u'ambient'},
     {u'name': u'angry'},
     {u'name': u'angst-ridden'},
     {u'name': u'bouncy'},
     {u'name': u'calming'},
     {u'name': u'carefree'}, etc.]
     N/A kwargs N/A type type N/A result N/A N/A util callm N/A %s/%s N/A artist list_terms kwargs N/A N/A N/A result N/A response N/A terms N/A list_genres N/A N/A N/A N/A N/A Get a list of best genres to use with genre-radio playlisting
    
    Args:
    
    Example:
    
    >>> best_terms = artist.list_genres()
    >>> best_terms
    [{u'name': u'pop'},
     {u'name': u'rock'},
     {u'name': u'country'},
     N/A kwargs N/A N/A result N/A N/A util callm N/A %s/%s N/A artist list_genres kwargs N/A N/A N/A result N/A response N/A genres N/A similar N/A N/A names ids start results buckets limit max_familiarity min_familiarity max_hotttnesss min_hotttnesss seed_catalog artist_start_year_before artist_start_year_after artist_end_year_before artist_end_year_after N/A None None 0 15 None False None None None None None None None None None N/A N/A 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
        
        seed_catalog (str): A string specifying the catalog similar artists are restricted to
    
    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>]
    >>> 

     N/A buckets N/A buckets N/A N/A kwargs N/A N/A ids N/A N/A N/A N/A isinstance ids list N/A N/A ids N/A ids N/A N/A kwargs N/A id ids N/A names N/A N/A N/A N/A isinstance names list N/A N/A names N/A names N/A N/A kwargs N/A name names N/A N/A max_familiarity None N/A N/A N/A kwargs N/A max_familiarity max_familiarity N/A N/A min_familiarity None N/A N/A N/A kwargs N/A min_familiarity min_familiarity N/A N/A max_hotttnesss None N/A N/A N/A kwargs N/A max_hotttnesss max_hotttnesss N/A N/A min_hotttnesss None N/A N/A N/A kwargs N/A min_hotttnesss min_hotttnesss N/A N/A seed_catalog None N/A N/A N/A kwargs N/A seed_catalog seed_catalog N/A start N/A N/A N/A kwargs N/A start start N/A results N/A N/A N/A kwargs N/A results results N/A buckets N/A N/A N/A kwargs N/A bucket buckets N/A limit N/A N/A N/A kwargs N/A limit true N/A artist_start_year_before N/A N/A N/A kwargs N/A artist_start_year_before artist_start_year_before N/A artist_start_year_after N/A N/A N/A kwargs N/A artist_start_year_after artist_start_year_after N/A artist_end_year_before N/A N/A N/A kwargs N/A artist_end_year_before artist_end_year_before N/A artist_end_year_after N/A N/A N/A kwargs N/A artist_end_year_after artist_end_year_after N/A result N/A N/A util callm N/A %s/%s N/A artist similar kwargs N/A N/A N/A Artist N/A N/A util fix a_dict N/A a_dict N/A N/A result N/A response N/A artists N/A extract N/A N/A text start results buckets limit max_familiarity min_familiarity max_hotttnesss min_hotttnesss N/A 0 15 None False None None None None N/A N/A Extract artist names from a block of text.
    
    Args:
    
    Kwargs:
        text (str): The text to extract artists from
    
        start (int): An integer starting value for the result set
    
        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
    
        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.extract(text='i saw beyonce at burger king, she was eatin, she was eatin')
    >>> results

    >>> 
    
     N/A buckets N/A buckets N/A N/A kwargs N/A N/A N/A kwargs N/A text text N/A N/A max_familiarity None N/A N/A N/A kwargs N/A max_familiarity max_familiarity N/A N/A min_familiarity None N/A N/A N/A kwargs N/A min_familiarity min_familiarity N/A N/A max_hotttnesss None N/A N/A N/A kwargs N/A max_hotttnesss max_hotttnesss N/A N/A min_hotttnesss None N/A N/A N/A kwargs N/A min_hotttnesss min_hotttnesss N/A start N/A N/A N/A kwargs N/A start start N/A results N/A N/A N/A kwargs N/A results results N/A buckets N/A N/A N/A kwargs N/A bucket buckets N/A limit N/A N/A N/A kwargs N/A limit true N/A result N/A N/A util callm N/A %s/%s N/A artist extract kwargs N/A N/A N/A Artist N/A N/A util fix a_dict N/A a_dict N/A N/A result N/A response N/A artists N/A suggest N/A N/A q results buckets limit max_familiarity min_familiarity max_hotttnesss min_hotttnesss N/A 15 None False None None None None N/A N/A Suggest artists based upon partial names.

    Args:

    Kwargs:
        q (str): The text to suggest artists from

        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

        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.suggest(text='rad')
    >>> results

    >>> 

     N/A buckets N/A buckets N/A N/A kwargs N/A N/A N/A kwargs N/A q q N/A N/A max_familiarity None N/A N/A N/A kwargs N/A max_familiarity max_familiarity N/A N/A min_familiarity None N/A N/A N/A kwargs N/A min_familiarity min_familiarity N/A N/A max_hotttnesss None N/A N/A N/A kwargs N/A max_hotttnesss max_hotttnesss N/A N/A min_hotttnesss None N/A N/A N/A kwargs N/A min_hotttnesss min_hotttnesss N/A results N/A N/A N/A kwargs N/A results results N/A buckets N/A N/A N/A kwargs N/A bucket buckets N/A limit N/A N/A N/A kwargs N/A limit true N/A result N/A N/A util callm N/A %s/%s N/A artist suggest kwargs N/A N/A N/A Artist N/A N/A util fix a_dict N/A a_dict N/A N/A result N/A response N/A artists N/A