Method: Album Info

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

Request URL

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

http://api.emusic.com/album/info?apiKey=myKey&albumId=11002212

Request Parameters

Following is a list of required and optional query string parameters for the Album 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.
albumId depends none The album ID. Either albumId or albumName must be included.
albumName depends none The URL-encoded album name. Either albumId or albumName must be included.
exact no none Used with albumName. When exact is set to "true", a method will only return album info if the album name exactly matches the albumName value.
include no none Provides additional information, as requested. This parameters takes a comma-separated list of the following include options: artistEditorial, albumRating, artistRating, label, relatedArtists, artist, albumEditorial.
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.)
imageSize no medium The size of the images referred to by image URLs (thumbnail, small, medium, large, huge).
fref no none The eMusic partner tag. If provided, the FREF value is automatically added to all appropriate eMusic links.

Example Requests

// Returns album info for album ID 11002212.
http://api.emusic.com/album/info?apiKey=myKey&albumId=11002212

// Returns album info for Reggae Vol.2 (exact match) and large images.
http://api.emusic.com/album/info?apiKey=myKey&albumName=Reggae+Vol.2&exact=true&imageSize=large

// Returns album info and three components of additional info.
http://api.emusic.com/album/ratings?apiKey=myKey&albumId=11002212&include=albumRating,label,artistRating

Response Format

Following is a list of returned elements for the Album 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.
album album on ok An <album> element containing album info. Also contains additional info if requested using the "include" parameter. See the example response below for typical album 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"/>
    <album active="true" added="2007-02-08" advance="false" albumOnly="false" amgId="R 1190691" available="true" downloadable="true" editorsPick="false" exclusive="false" explicit="false" free="false" id="11002212" image="http://images.emusic.com/music/images/album/288/110/022/11002212/300x300.jpg" length="3351" live="false" name="Best Of" new="false" published="true" released="2007-01-01" single="false" tracksPublished="20" tracksTotal="20" tracksUnavailable="false" trialDownloable="true" url="http://www.emusic.com/album/Bob-Marley-Best-Of-MP3-Download/11002212.html">
        <genre id="288" id3Value="16" name="International" url="http://www.emusic.com/genre/288.html"/>
        <label id="120718" name="Cleopatra / The Orchard" url="http://www.emusic.com/label/Cleopatra-The-Orchard-MP3-Download/120718.html"/>
        <artist id="10559083" name="Bob Marley" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
        <countries list="true" size="239">
            <country>AD</country>
            <country>AE</country>
            <country>AF</country>
             ...
            <country>ZM</country>
            <country>ZW</country>
        </countries>
        <instruments list="true" size="0"/>
        <styles list="true" size="1">
            <style id="338" name="Roots Reggae" url="http://www.emusic.com/browse/b/b/-dbm/a/0-0/1200000338/0.html">
                <genre id="288" url="http://www.emusic.com/genre/288.html"/>
            </style>
        </styles>
        <credits list="true" size="0"/>
        <discs list="true" size="1">
            <disc id="11007739" length="3351" name="Disc 1" number="1">
                <tracks list="true" size="20">
                    <track active="true" advance="false" albumOnly="false" bitrate="VBR" downloadable="true" exclusive="false" explicit="false" filesize="3489026" format="audio/mpeg" free="false" id="14982287" length="211" long="false" md5="732b8ed47e13550e6b19c8a6df378651" name="Mr. Brown" number="1" premium="false" published="true" trialDownloadable="true">
                        <artist id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
                    </track>
                    <track active="true" advance="false" albumOnly="false" bitrate="VBR" downloadable="true" exclusive="false" explicit="false" filesize="3225762" format="audio/mpeg" free="false" id="14982288" length="198" long="false" md5="7ab7687c031aeaf70af5ae51334eb17c" name="Soul Rebel" number="2" premium="false" published="true" trialDownloadable="true">
                        <artist id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
                    </track>
                    <track active="true" advance="false" albumOnly="false" bitrate="VBR" downloadable="true" exclusive="false" explicit="false" filesize="3753080" format="audio/mpeg" free="false" id="14982289" length="223" long="false" md5="918499e21f01d1d86448efe1f66843e3" name="Duppy Conqueror" number="3" premium="false" published="true" trialDownloadable="true">
                        <artist id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
                    </track>
                     ...
                    <track active="true" advance="false" albumOnly="false" bitrate="VBR" downloadable="true" exclusive="false" explicit="false" filesize="2994275" format="audio/mpeg" free="false" id="14982305" length="158" long="false" md5="b5a5c9576e9d7fdfc54d1aa4db426494" name="Brain Washing" number="19" premium="false" published="true" trialDownloadable="true">
                        <artist id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
                    </track>
                    <track active="true" advance="false" albumOnly="false" bitrate="VBR" downloadable="true" exclusive="false" explicit="false" filesize="3165697" format="audio/mpeg" free="false" id="14982306" length="165" long="false" md5="3f424d870b2b00e125d00a79b6cfb748" name="Dreamland" number="20" premium="false" published="true" trialDownloadable="true">
                        <artist id="10559083" name="Bob Marley" published="true" url="http://www.emusic.com/artist/Bob-Marley-MP3-Download/10559083.html"/>
                    </track>
                </tracks>
            </disc>
        </discs>
    </album>
</response>

version 7 as of 2 days ago by Ben Kotch

0 Comments

Please sign in to post a comment.