Method: Book Info

Returns book information for a given book ID.

Request URL

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

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

Request Parameters

Following is a list of required and optional query string parameters for the Book 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.
bookId depends none The book ID.
bookName depends none The URL-encoded book name. Either bookId or bookName 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: bookEditorial, relatedAuthors, bookRating
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 book info for artist ID 10001009.
http://api.emusic.com/book/info?apiKey=myKey&bookId=10001009

// Returns book info for The Hitchhiker's Guide To The Galaxy, using large images and an FREF.
http://api.emusic.com/book/info?apiKey=myKey&bookName=The+Hitchhiker's+Guide+To+The+Galaxy
&imageSize=large&fref=400060

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

Response Format

Following is a list of returned elements for the Book 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.
book book on ok An <artist> element containing book info. Also contains additional info if requested using the "include" parameter. See the example response below for typical book 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"/>
    <book active="true" editorsPick="true" exclusive="false" fiction="true" free="false" id="10001009" image="http://images.emusic.com/books/images/book/0/100/010/10001009/300x300.jpg" isPublished="true" name="The Hitchhiker's Guide To The Galaxy" published="2007-09-17" released="2005-04-19" 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">
        <publisher id="41" name="Random House Audio"/>
        <edition bookId="10001009" name="Unabridged">
            <publisher id="41" name="Random House Audio"/>
        </edition>
        <authors list="true" size="1">
            <author id="11826661" name="Douglas Adams" url="http://www.emusic.com/audiobooks/author/Douglas-Adams-MP3-Download/11826661.html"/>
        </authors>
        <narrators list="true" size="1">
            <narrator id="11826835" name="Stephen Fry" url="http://www.emusic.com/audiobooks/narrator/Stephen-Fry-MP3-Download/11826835.html"/>
        </narrators>
        <otherEditions list="true" size="0"/>
        <styles list="true" size="4">
            <style id="1071" name="Science Fiction" url="http://www.emusic.com/browse/b/b/-dbm/a/0-0/1200001071/0.html">
                <genre id="1011" name="Science Fiction &amp;amp; Fantasy" url="http://www.emusic.com/genre/1011.html"/>
            </style>
            <style id="1036" name="Humor" url="http://www.emusic.com/browse/b/b/-dbm/a/0-0/1200001036/0.html">
                <genre id="0" url="http://www.emusic.com/genre/0.html"/>
            </style>
            <style id="1073" name="Space Travel" url="http://www.emusic.com/browse/b/b/-dbm/a/0-0/1200001073/0.html">
                <genre id="1011" name="Science Fiction &amp;amp; Fantasy" url="http://www.emusic.com/genre/1011.html"/>
            </style>
            <style id="1005" name="Fiction &amp; Literature" url="http://www.emusic.com/browse/b/b/-dbm/a/0-0/1200001005/0.html">
                <genre id="0" url="http://www.emusic.com/genre/0.html"/>
            </style>
        </styles>
        <designations list="true" size="1">
            <designation>New York Times Best Seller</designation>
        </designations>
        <countries list="true" size="177">
            <country code="VI" id="1232"/>
            <country code="TH" id="1209"/>
            <country code="SA" id="1185"/>
            <country code="ID" id="1100"/>
            <country code="UY" id="1225"/>
            ...
        <isbn isbn10="0739322206" isbn13="9780739322208"/>
    </book>
</response>

version 2 as of 2 years ago by eMusic Admin

0 Comments

Please sign in to post a comment.