Method: Artist Picks

Returns "editor's picks" for artists, for a given time frame (i.e., top 10 "editor's picks" artists this month by "number of downloads"). Results are sorted and filtered.

Request URL

The object is artist and the action is picks. The base request URL is:

http://api.emusic.com/artist/picks?apiKey=myKey

Request Parameters

Following is a list of required and optional query string parameters for the Artist Picks method. For more information about individual request parameters, see request parameters.
Name Required Default Description
apiKey YES none The developer API key. This is required for all methods.
primarySort no artistDownloadsMonth The charts sort. Recommended values: artistDownloadsMonth, artistDownloadsWeek, artistDownloadsToday
primaryAscending no false The results sort direction. Note that a "top 10" editor's picks would use a primaryAscending value of "false" (largest to least number of downloads...).
page no 1 The starting page index of returned artists. (Used for paginating through longer result lists.)
perPage no 20 The number of artists to return per page.
format no XML The format of the response (XML, JSON, JSONP).
callback depends none The name of the JavaScript callback method for the JSONP format. (Required for JSONP responses only.)
fref no none The eMusic partner tag. If provided, the FREF value is automatically added to all appropriate eMusic links.
Example Requests

// Returns "editor's picks" for artists (all default values).
http://api.emusic.com/artist/picks?apiKey=myKey

// Returns the third page of 10 "editor's picks" artists for the week.
http://api.emusic.com/artist/picks?apiKey=myKey&primarySort=artistDownloadsWeek&perPage=10&page=3

Response Format

Following is a list of returned elements for the Artist Picks method. For more information about individual response elements, see Response Elements.
Name Type Returned Description
status status always Contains a result code.
messages list on error Contains one or more messages.
options options on ok Contains a list of method options.
browse browse on ok Contains the <browse> filters and sorts.
view view on ok Contains the paginate result counts.
artists list on ok Contains a paged list of "editor's picks" artists, filtered and sorted by the given criteria. See the example response below for typical artist elements.
Example Response

<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <status code="200">ok</status>
    <options format="xml"/>
    <browse country="US" filter="editorsPicks" primaryAscending="false" primarySort="artistDownloadsMonth" type="artist"/>
    <view page="1" pages="419" perPage="20" total="8364"/>
    <artists list="true" size="20">
        <artist id="11956549" name="She &amp; Him" url="http://www.emusic.com/artist/She-Him-MP3-Download/11956549.html"/>
        <artist id="11759074" name="Led Zeppelin" url="http://www.emusic.com/artist/Led-Zeppelin-MP3-Download/11759074.html"/>
        <artist id="11599806" name="Sharon Jones and the Dap-Kings" url="http://www.emusic.com/artist/Sharon-Jones-and-the-Dap-Kings-MP3-Download/11599806.html"/>
        <artist id="12667456" name="The Doors" url="http://www.emusic.com/artist/The-Doors-MP3-Download/12667456.html"/>
        <artist id="11804826" name="Paul McCartney" url="http://www.emusic.com/artist/Paul-McCartney-MP3-Download/11804826.html"/>
        <artist id="11612100" name="Michael Jackson" url="http://www.emusic.com/artist/Michael-Jackson-MP3-Download/11612100.html"/>
        <artist id="11654614" name="Caribou" url="http://www.emusic.com/artist/Caribou-MP3-Download/11654614.html"/>
        <artist id="11630066" name="Bonobo" url="http://www.emusic.com/artist/Bonobo-MP3-Download/11630066.html"/>
        <artist id="10561971" name="Johnny Cash" url="http://www.emusic.com/artist/Johnny-Cash-MP3-Download/10561971.html"/>
        <artist id="11757819" name="Frightened Rabbit" url="http://www.emusic.com/artist/Frightened-Rabbit-MP3-Download/11757819.html"/>
        <artist id="11687059" name="The Morning Benders" url="http://www.emusic.com/artist/The-Morning-Benders-MP3-Download/11687059.html"/>
        <artist id="11607208" name="Jimmy Page" url="http://www.emusic.com/artist/Jimmy-Page-MP3-Download/11607208.html"/>
        <artist id="11552223" name="Drive-By Truckers" url="http://www.emusic.com/artist/Drive-By-Truckers-MP3-Download/11552223.html"/>
        <artist id="11487121" name="Neil Young" url="http://www.emusic.com/artist/Neil-Young-MP3-Download/11487121.html"/>
        <artist id="11692763" name="Iron &amp; Wine" url="http://www.emusic.com/artist/Iron-Wine-MP3-Download/11692763.html"/>
        <artist id="12389722" name="The Smiths" url="http://www.emusic.com/artist/The-Smiths-MP3-Download/12389722.html"/>
        <artist id="11487788" name="Eric Clapton" url="http://www.emusic.com/artist/Eric-Clapton-MP3-Download/11487788.html"/>
        <artist id="12268951" name="Kenny Chesney" url="http://www.emusic.com/artist/Kenny-Chesney-MP3-Download/12268951.html"/>
        <artist id="11607523" name="Bob Dylan" url="http://www.emusic.com/artist/Bob-Dylan-MP3-Download/11607523.html"/>
        <artist id="11984298" name="Titus Andronicus" url="http://www.emusic.com/artist/Titus-Andronicus-MP3-Download/11984298.html"/>
    </artists>
</response>

version 1 as of 2 years ago by eMusic Admin

0 Comments

Please sign in to post a comment.