Method: Artist Charts

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

Request URL

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

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

Request Parameters

Following is a list of required and optional query string parameters for the Artist Charts 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.
filter no downloadedThisMonth The charts filter. Recommended values: downloadedThisMonth, downloadedThisWeek, downloadedToday
primarySort no artistDownloadsMonth The charts sort. Recommended values: artistDownloadsMonth, artistDownloadsWeek, artistDownloadsToday
primaryAscending no false The charts sort direction. Note that a "top 10" chart 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 artist charts (all default values).
http://api.emusic.com/artist/charts?apiKey=myKey

// Returns top artists for the week.
http://api.emusic.com/artist/charts?apiKey=myKey&primaryFilter=downloadedThisWeek&primarySort=artistDownloadsWeek

Response Format

Following is a list of returned elements for the Artist Charts 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 charted 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="downloadedThisMonth" primaryAscending="false" primarySort="artistDownloadsMonth" type="artist"/>
    <view page="1" pages="4421" perPage="20" total="88412"/>
    <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="12640123" name="Broken Bells" url="http://www.emusic.com/artist/Broken-Bells-MP3-Download/12640123.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="11925947" name="MGMT" url="http://www.emusic.com/artist/MGMT-MP3-Download/11925947.html"/>
        <artist id="11612100" name="Michael Jackson" url="http://www.emusic.com/artist/Michael-Jackson-MP3-Download/11612100.html"/>
        <artist id="11790622" name="Jim Morrison" url="http://www.emusic.com/artist/Jim-Morrison-MP3-Download/11790622.html"/>
        <artist id="10555713" name="Ray Manzarek" url="http://www.emusic.com/artist/Ray-Manzarek-MP3-Download/10555713.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="11696147" name="Robby Krieger" url="http://www.emusic.com/artist/Robby-Krieger-MP3-Download/11696147.html"/>
        <artist id="12069404" name="The Tallest Man On Earth" url="http://www.emusic.com/artist/The-Tallest-Man-On-Earth-MP3-Download/12069404.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="11689178" name="Robert Plant" url="http://www.emusic.com/artist/Robert-Plant-MP3-Download/11689178.html"/>
        <artist id="10557575" name="Slash" url="http://www.emusic.com/artist/Slash-MP3-Download/10557575.html"/>
        <artist id="11607208" name="Jimmy Page" url="http://www.emusic.com/artist/Jimmy-Page-MP3-Download/11607208.html"/>
    </artists>
</response>

version 3 as of 2 years ago by eMusic Admin

0 Comments

Please sign in to post a comment.