- Previous: Method: Album Charts
- Up: Introduction
- Next: Method: Album Info
Method: Album Editorial
Returns album editorial material (reviews, summaries, etc.) for a given album ID or album name.
Request URL
The object is album and the action is editorial. The base request URL is:
http://api.emusic.com/album/editorial?apiKey=myKey&albumId=11059793
Request Parameters
Following is a list of required and optional query string parameters for the Album 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. |
| 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 | When include is set to "album", additional album information is returned for the specified album, along with the album editorial material. 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 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 editorial for album ID 11059793.
http://api.emusic.com/album/editorial?apiKey=myKey&albumId=11059793
// Returns album editorial for Ga Ga Ga Ga Ga (exact match) and large images.
http://api.emusic.com/album/editorial?apiKey=myKey&albumName=Ga+Ga+Ga+Ga+Ga&exact=true&imageSize=large
// Returns album editorial and album info using an fref.
http://api.emusic.com/album/editorial?apiKey=myKey&albumId=11059793&include=album&fref=400060
Response Format
Following is a list of returned elements for the Album 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. |
| 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. |
| editorial | albumEditorial | on ok | An <editorial> element containing zero to many custom editorial elements (reviews, summaries, 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"/>
<album id="11059793" image="http://images.emusic.com/music/images/album/277/110/597/11059793/300x300.jpg" name="Ga Ga Ga Ga Ga" url="http://www.emusic.com/album/Spoon-Ga-Ga-Ga-Ga-Ga-MP3-Download/11059793.html">
<genre id="277" name="Rock/Pop" url="http://www.emusic.com/genre/277.html"/>
<label id="109173" name="Merge Records" url="http://www.emusic.com/label/Merge-Records-MP3-Download/109173.html"/>
<artist id="10559401" name="Spoon" url="http://www.emusic.com/artist/Spoon-MP3-Download/10559401.html"/>
<editorial>
<review author="Andy Battaglia" id="26504" source="eMusic" type="eMusicReview"><![CDATA[
To call <i>Ga Ga Ga Ga Ga</i> one of the year's two or three best rock albums is to overstate how much it sounds like a rock album. There's no mistaking its imperturbable swagger and seething refrains for anything else — Spoon still knows how to write a song that could fit into each of rock's past five decades without tipping toward any one in particular. But even songs on <i>Ga Ga</i> that traffic in guitars don't sound like they were written with guitars in mind. Spoon sounds more interested now in drums and empty space, both of which sparkle and boom in ways that make singer Britt Daniel sound positively electrified to be in their presence.
<BR><BR>
The sparse and experimental lean of <i>Ga Ga Ga Ga Ga</i> places it closer to the group's 2002 breakthrough <i>Kill the Moonlight</i> than its bash-minded follow-up <i>Gimme Fiction</i>. "Don't Make Me a Target" opens on a note of resignation and rage, with portentous guitar and piano that build toward a sort of atonal rockabilly jam about two minutes in. From there, though, the album takes on an air of mystery with "The Ghost of You Lingers," a gorgeous and terrifying ballad in which Daniel's distended voice duels with blasts of static and more reverb than could ever sound earthly. The jarring tonal shift into "You Got Yr. Cherry Bomb" proves perverse but, as goes for most of Spoon's moves at this point, not overly pleased with itself: After bells and slappy drums enter like Phil Spector as summoned by David Lynch, the buoyant tune takes over and lodges into that part of your brain where pleasurable pop hooks go and stay mum.
<BR><BR>
What sticks most on <i>Ga Ga Ga Ga Ga</i> is the grain and range of Daniel's voice, which must have been miked a dozen different ways to capture his timbral moods in tracks as disparate as "Don't You Evah" (Spoon's most funky song yet, by a good measure) and "The Underdog" (Spoon's most Billy Joel-like song yet, to the same degree). Nothing Daniel does has ever sounded labored, but <i>Ga Ga Ga Ga Ga</i> finds him and his band with a newly refined balance between craft and restraint. ]]></review>
<dek id="26504"><![CDATA[David Lynch, Phil Spector, Billy Joel walk into a bar... ]]></dek>
</editorial>
</album>
</response>
- Previous: Method: Album Charts
- Up: Introduction
- Next: Method: Album Info
Docs Navigation
- Introduction
- Request Format
- Response Elements
- Result Codes
- Response Format
- Code Samples
- Branding Guidelines
- Method Index
- Request Parameters
- Method: Album Charts
- Method: Album Editorial
- Method: Album Info
- Method: Album Picks
- Method: Album Ratings
- Method: Album Reviews
- Method: Album Search
- Method: Artist Charts
- Method: Artist Editorial
- Method: Artist Info
- Method: Artist Picks
- Method: Artist Ratings
- Method: Artist Related
- Method: Artist Search
- Method: Book Charts
- Method: Book Editorial
- Method: Book Info
- Method: Book Ratings
- Method: Book Reviews
- Method: Book Search
- Method: Label Info
- Method: Label Search
- Method: Track Charts
- Method: Track Search
1 Comment
chovy – 3 months ago
doesn't work.
Please sign in to post a comment.