Method: Book Editorial

Returns book editorial material (reviews, quotes, publisher notes, etc.) for a given book ID or book name.

Request URL

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

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

Request Parameters

Following is a list of required and optional query string parameters for the Book Editorial 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 editorial material. 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 book 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 editorial for book ID 10001009.
http://api.emusic.com/book/editorial?apiKey=myKey&bookId=10001009

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

// Returns book editorial and book info using an fref.
http://api.emusic.com/book/editorial?apiKey=myKey&bookId=11059793&include=book&fref=400060

Response Format

Following is a list of returned elements for the Book Editorial 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.
editorial bookEditorial on ok An <editorial> element containing zero to many custom editorial elements (blurbs, reviews, quotes, publisher notes, etc.) See the example response below for typical editorial elements.
Example Response

<?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.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">
        <editorial>
            <blurbs list="true" size="2">
                <blurb author="Random House" source="Publisher" type="description"><![CDATA["IRRESISTIBLE!"<br>--<i>The Boston Globe</i><br><br> Seconds before the Earth is demolished to make way for a galactic freeway, Arthur Dent is plucked off the planet by his friend Ford Prefect, a researcher for the revised edition of <i>The Hitchhiker's Guide to the Galaxy</i> who, for the last fifteen years, has been posing as an out-of-work actor.<br><br> Together this dynamic pair begin a journey through space aided by quotes from <i>The Hitchhiker's Guide</i> ("A towel is about the most massively useful thing an interstellar hitchhiker can have") and a galaxy-full of fellow travelers: Zaphod Beeblebrox--the two-headed, three-armed ex-hippie and totally out-to-lunch president of the galaxy; Trillian, Zaphod's girlfriend (formally Tricia McMillan), whom Arthur tried to pick up at a cocktail party once upon a time zone; Marvin, a paranoid, brilliant, and chronically depressed robot; Veet Voojagig, a former graduate student who is obsessed with the disappearance of all the ballpoint pens he bought over the years.<br><br> Where are these pens? Why are we born? Why do we die? Why do we spend so much time between wearing digital watches? For all the answers stick your thumb to the stars. And don't forget to bring a towel!<br><br> "[A] WHIMSICAL ODYSSEY...Characters frolic through the galaxy with infectious joy."<br> --<i>Publishers Weekly</i>]]></blurb>
                <blurb author="Jo Miller" source="eMusic" type="review"><![CDATA[<B><I>A galaxy weirder, more wonderful and infinitely funnier.</I></B> <BR/> Nearly thirty years ago, Douglas Adams' fellow radio-comedy writers couldn't resist spoofing the continuous repackaging of his <I>Hitchhiker's Guide to the Galaxy</I>: "And there'll be another edition of the television version of the book of the play of the radio series of the <I>Hitchhiker's Guide to the Galaxy of the License to Print Money</I> at the same script next week," went one particularly thorny barb. That list has only grown &#8212; there followed a computer game, a comic book adaptation, three more radio series, an execrable film and now a new audiobook. <BR/><BR/> There's good reason for this continuous renewal: <I>The Hitchhiker's Guide</I> is a dazzling comic masterpiece, as fresh, original and giddily captivating today as it was in the 1970s. Though some purists might argue that the original radio scripts comprise the true Hitchhiker's canon, the novels are what give full range to Adams' prodigious gifts as a writer. Like the radio plays, the books are best when read aloud. A description like "The ships hung in the sky in much the same way that bricks don't" &#8212; which knocked my legs out from under me twenty-five years ago and has lost none of its power to make me grin like an idiot &#8212; deserves to be listened to and savored. <BR/><BR/> Adams's friend, the writer, actor, comedian and sometime poet Stephen Fry, was the natural choice to record this version of <I>The Guide</I>. A superb and indefatigable narrator of audiobooks, Fry can make a listener's toes curl with pleasure with his resonant, versatile voice whether he's delivering a learned treatise on iambic hendecasyllabic meter, a classic Oscar Wilde tale or an excerpt from the London telephone book (this last is as yet unrecorded but presumably soon to be available). So it's surprising and a bit disappointing that Fry reads <I>The Hitchhiker's Guide</I> with the same stately cadence and hyperprecise diction that made his Harry Potter audiobooks suitable for small children and students of English as a second language. Whether it's reverence for the material that holds him back, or someone's direction to slow it down for the stupid Americans, this <i>lentissimo</i> delivery somewhat undercuts the mad energy and exuberant humor of <I>The Guide</I> and leaves one wishing Fry would loosen up and have a bit more fun. <BR/><BR/> Despite the drawbacks, Fry's recording is a worthy point of entry into a galaxy almost but not quite entirely unlike our own &#8212; weirder, more wonderful and infinitely funnier.]]></blurb>
            </blurbs>
            <quotes list="true" size="0"/>
            <metaBlurbs list="true" size="0"/>
            <awards list="true" size="0"/>
            <publisherNotes list="true" size="0"/>
            <annotations list="true" size="1">
                <blurb type="unknown"><![CDATA[THE HITCHHIKER'S GUIDE TO THE GALAXY is not just a book--it's a phenomenon. It's based on a BBC radio series that also spawned four other books, a TV series, a 2005 film, a text-based computer adventure game, and a website. As the story begins, Arthur Dent is having a bad day. First, the town council knocked his house down to build a local bypass. Then a fleet of alien spaceships blew up his planet to make way for an intragalactic bypass. Can things get any worse? Possibly. Having been rescued from the Earth's destruction by his friend Ford Prefect, Arthur embarks upon a hectic, hysterically funny adventure that includes torturously bad poetry, a depressed robot, the two-headed President of the Galaxy (currently on the lam), and the legendary planet-building planet of Magrathea. Arthur's only consolation is the wise advice printed on the cover of that classic tome, THE HITCHHIKER'S GUIDE TO THE GALAXY: "Don't Panic." HITCHHIKER'S has developed a cult classic status that extends beyond SF fans, and people enjoy swapping quotes from it in much the same way that they exchange quotes from MONTY PYTHON. Although there is an extensive crop of British writers who write humorous fantasy in much the same vein, such as Terry Pratchett and Tom Holt, no one has quite been able to make the splash in satirical SF that Adams has.]]></blurb>
            </annotations>
            <synopses list="true" size="0"/>
        </editorial>
    </book>
</response>