Method: Album Reviews

Returns eMusic community album reviews for a given album ID or album name. If you are looking for editorial reviews, use the Album Editorial method.

Request URL

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

http://api.emusic.com/album/review?apiKey=myKey&albumId=11059793

Request Parameters

Following is a list of required and optional query string parameters for the Album Reviews 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 reviews if the album name exactly matches the albumName value.
include no none When include is set to "album", additional album information is returned for the specified album, along with the album reviews. Additional album information includes full track info along with release countries, etc.
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 album 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 reviews for album ID 11059793.
http://api.emusic.com/album/reviews?apiKey=myKey&albumId=11059793

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

// Returns album reviews and album info using an fref.
http://api.emusic.com/album/reviews?apiKey=myKey&albumId=11059793&include=album&fref=400060

Response Format

Following is a list of returned elements for the Album Reviews 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.
reviews userReviews on ok A <reviews> element containing zero to many user reviews. See the example response below for typical review elements.

Example Response

(User names are hidden in documentation...)

<?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 id="10865055" image="http://images.emusic-test.com/music/images/album/291/108/650/10865055/300x300.jpg" name="Lado Este" url="http://www.emusic.com/album/Sara-Valenzuela-Lado-Este-MP3-Download/10865055.html">
        <genre id="291" name="Jazz" url="http://www.emusic.com/genre/291.html"/>
        <label id="100934" name="Nacional Records" url="http://www.emusic.com/label/Nacional-Records-MP3-Download/100934.html"/>
        <artist id="11594843" name="Sara Valenzuela" url="http://www.emusic.com/artist/Sara-Valenzuela-MP3-Download/11594843.html"/>
    </album>
    <search albumId="10865055"/>
    <view page="1" pages="1" perPage="20" total="2"/>
    <reviews list="true" size="2">
        <review id="24883" location="Langkawi, Malayisa" title="Great Album" type="album" updated="2006-08-15">
            <user url="http://www.emusic.com/profile/index.html?nickname=hidden" userName="hidden"/>
            <userRating average="5"/>
            <content><![CDATA[One of the best album I've heard! When is the next album?]]></content>
        </review>
        <review id="8613" location="Atlanta, GA" title="I'm unable to resist." type="album" updated="2004-09-15">
            <user url="http://www.emusic.com/profile/index.html?nickname=hidden" userName="hidden"/>
            <userRating average="5"/>
            <content><![CDATA[Her voice is flawless. Songs both fast & slow are strong. Pure enjoyment for me, except that I cannot easily categorize this album - it is both jazz & pop.]]></content>
        </review>
    </reviews>
</response>

version 4 as of 3 months ago by Ben Kotch

1 Comment

  1. chovy – 3 months ago

    doesn't work.

Please sign in to post a comment.