Method: Artist Info

Returns artist information for a given artist ID or artist name.

Request URL

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

http://api.emusic.com/artist/info?apiKey=myKey&artistId=10559083

Request Parameters

Following is a list of required and optional query string parameters for the Artist Info 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.
artistId depends none The artist ID. Either artistId or artistName must be included.
artistName depends none The URL-encoded artist name. Either artistId or artistName must be included.
exact no none Used with artistName. When exact is set to "true", a method will only return artist info if the artist name exactly matches the artistName value.
include no none Provides additional information, as requested. This parameters takes a comma-separated list of the following include options: artistEditorial, artistRating, relatedArtists.
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 info for artist ID 11002212.
http://api.emusic.com/artist/info?apiKey=myKey&artistId=11002212

// Returns artist info for Bob Marley (exact match).
http://api.emusic.com/artist/info?apiKey=myKey&artistName=Bob+Marley.2&exact=true

// Returns artist info and two components of additional info.
http://api.emusic.com/artist/ratings?apiKey=myKey&artistId=11002212&include=artistEditorial, artistRating

Response Format

Following is a list of returned elements for the Artist Info 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.
artist artist on ok An <artist> element containing artist info. Also contains additional info if requested using the "include" parameter. See the example response below for typical artist elements.
Example Response

(Only five elements are displayed in each list...)

<?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"/>
    <artist group="false" id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html">
        <origin location="St. Ann, Jamaica"/>
        <death location="Miami, FL"/>
        <activeDecades list="true" size="3">
            <decade>1960</decade>
            <decade>1970</decade>
            <decade>1980</decade>
        </activeDecades>
    </artist>
</response>

version 5 as of 2 years ago by eMusic Admin

0 Comments

Please sign in to post a comment.