Method: Book Reviews

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

Request URL

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

http://api.emusic.com/book/review?apiKey=myKey&bookId=10001009

Request Parameters

Following is a list of required and optional query string parameters for the Book 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.
bookId depends none The book ID. Either bookId or bookName must be included.
bookName depends none The URL-encoded book name. Either bookId or bookName must be included.
exact no none Used with bookName. When exact is set to "true", a method will only return book info if the book name exactly matches the bookName value.
include no none When include is set to "book", additional book information is returned for the specified book, along with the book user reviews. Additional book information includes narrator information, genres, 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 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 book reviews for book ID 10001009.
http://api.emusic.com/book/reviews?apiKey=myKey&bookId=10001009

// Returns book reviews for The Hitchhiker's Guide To The Galaxy and large images.
http://api.emusic.com/book/reviews?apiKey=myKey&bookName=The+Hitchhiker's+Guide+To+The+Galaxy&imageSize=large

// Returns book reviews and book info using an fref.
http://api.emusic.com/book/reviews?apiKey=myKey&bookId=10001009&include=book&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.
book book on ok Contains a <book> element with book info. Also contains additional info if requested using the "include" parameter. See the example response below for typical book 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"/>
    <book id="10001009" image="http://images.emusic-test.com/books/images/book/0/100/010/10001009/300x300.jpg" name="The Hitchhiker's Guide To The Galaxy" sample="http://www.emusic.com/samples/m3u/book/10001009/0.m3u" url="http://www.emusic.com/audiobooks/book/Douglas-Adams-The-Hitchhiker-s-Guide-To-The-Galaxy-MP3-Download/10001009.html"/>
    <view page="1" pages="1" perPage="20" total="19"/>
    <reviews list="true" size="2">
        <review id="508921" title="One of MY favorites!" type="book" updated="2010-05-12">
            <user url="http://www.emusic.com/profile/index.html?nickname=hidden" userName="hidden"/>
            <userRating average="4"/>
            <content><![CDATA[The Hitchhiker's Guide is one of the strangest, lacking meaning, out-of-sorts, oddly written with big words book
                I've ever read. It's choppy and strange to read. It's funny and surprizingly true in some ways.
                Brings out some of the hidden problems in everyday life without anyone really knowing they're there.
                Amazing? Yes. You MUST get to the end. Everything sort of clicks into place at the end. If you've only seen the movie,
                don't go by that. The book is a million times better and the movie is a million times worse (no
                offense, the movie was good but this is an amazing book I'm comparing it to). This book is a MUST HAVE!]]></content>
        </review>
        <review id="508882" title="Still a classic" type="book" updated="2010-04-26">
            <user url="http://www.emusic.com/profile/index.html?nickname=hidden" userName="hidden"/>
            <userRating average="5"/>
            <content><![CDATA[This is the first of a great series of books I first read in high school. Reading (er, listening to) it
                again, it still holds wonderful humor, the twisted yet so truthful kind that's hard to resist. If you only saw the movie,
                the book is so much better. The back-and-forth of plot/story and background/information chapters is a great technique, and
                Adams cleverly plants seeds that often arise only chapters later. You won't be disappointed!]]></content>
        </review>
    </reviews>
</response>

version 3 as of 2 years ago by eMusic Admin

0 Comments

Please sign in to post a comment.