Release

Album release, corresponding to a single EAN/UPC.

Description

A release is a product and corresponds to a unique EAN/UPC. This product can be digital or physical (like a CD).
All releases of an album can be obtained thanks to the connector Album.
Example : gathers all releases (EAN/UPC versions) of the album The Blueprint from Jay-Z.

The fields "type" and "format" define the nature of the album, the first designates the kind of recording, the latter defines its format.

The field "type" can take the following values :

Original : Original album, studio production
Live : Live album, recorded live
Compilation : Compilation of tracks
Karaoke : Karaoke album
Ring : Ringtones
Other : No classification

The field "format" can take the following values :

Album : Standard album format
EP : Extended Play format, between single and album
Single : Single, one or a few tracks
MCD : Maxi, long play single

The field "support" designates the physical support of the release. With following values :

CD : CD
LP : Vinyl, long Play
K7 : Cassette
NUM : Digital only

Boolean "main" indicates the most recent or the richest version of an album.

Example :
Search for the album version with the ID 2964 ("All Things Must Pass")
http://api.music-story.com/en/release/2964

Fields

Name	Description	Facultatively	Type	Restriction
id	Unique ID	no	int	Unlimited
title	Title	no	string	Unlimited
release_date	Original release date of the associated album	no	date	Unlimited
publication_date	Release date	no	date	Unlimited
label	Label	no	string	Unlimited
distributor	Editor	no	string	Unlimited
main	If main is TRUE this release is main release for the associated album	no	boolean	Unlimited
ean	EAN/UPC	no	string	Unlimited
support	Support	no	"CD"/"LP"/"NUM"/"K7"	Unlimited
num	Is this release available in digital format?	no	boolean	Unlimited
type	Type	no	"Original"/"Live"/"Compilation"/"Karaoke"/"Ring"/"Other"	Unlimited
format	Format	no	"Album"/"EP"/"Single"/"MCD"	Unlimited
update_date	Last update date	no	date	Unlimited
creation_date	Database entry date	no	date	Unlimited

Connectors

Name	Description	Returns
search	Act of searching	A list of Release
artists	Artists associated with the release	A list of Artist
genres	Gathers the genres associated with the current edition	The associated Genre
album	Album associated with a release	The associated Album
pictures	Picture (cover) of a release	A list of Picture
reviews	Review associated with a release	A list of Reviews
musicbrainz	Musicbrainz releases matching the current release	A list of Musicbrainz
deezer	Deezer album matching the current release	A list of Deezer
spotify	Spotify album matching the current release	A list of Spotify
qobuz	Qobuz album matching the current release	A list of Qobuz
amazonmp3	Amazonmp3 album matching the current release	A list of Amazonmp3
itunes	iTunes album matching the current release	A list of iTunes
sevendigital	7digital album matching the current release	A list of SevenDigital
starzik	Starzik album matching the current release	A list of Starzik
amazon	Amazon album matching the current release	A list of Amazon
fnac	Fnac album matching the current release	A list of Fnac
priceminister	PriceMinister album matching the current release	A list of PriceMinister
xboxmusic	Récupère les albums Xboxmusic associés à l'édition courante	A list of Xboxmusic

Act of searching

Example :
Search for the album versions including "Firework" in its title
http://api.music-story.com/en/release/search?title=Firework

genres

Gathers the genres associated with the current edition

Example :
Search for the genre associated with the album version with the ID 425 ("Led Zeppelin IV")
http://api.music-story.com/en/release/425/genres

artists

Gathers artists associated with a release.
Links between artists and a release can take following values :

Performer : Artist is the main performer the release belong to his discography
Author : Artist is credited as author on this release
Composer : Artist is credited as composer on this release
Conductor : Artist is credited as conductor on this release
Orchestra : Orchestra which plays on the release

Added fields	Description	Facultatively	Type	Restriction
link	The type of link between the edition and the artist	no	'main'/'performer'/'author'/'conductor'/'orchestra'/'composer'	Unlimited

Example :
Search for the artists associated with the album version with the ID 2964 ("All Things Must Pass")
http://api.music-story.com/en/release/2964/artists

album

Gathers the albums associated with a release. This criteria allows to gather all the releases of an album.
Example : all releases (EAN/UPC) of The Blueprint from Jay-Z are linked to the same album.

Example :
Search for the album associated with the album version with the ID 2964 ("All Things Must Pass")
http://api.music-story.com/en/release/2964/album

pictures

Gathers releases associated to a picture as a cover

Example :
Search for the cover of the album version with the ID 2964 ("All Things Must Pass")
http://api.music-story.com/en/release/2964/pictures

reviews

Gathers reviews associated to a release

Example :
Search for the review associated with the album version with the ID 2964 ("All Things Must Pass")
http://api.music-story.com/en/release/1178094/reviews

musicbrainz

Retrieves the Musicbrainz releases associated with the current release.
Musicbrainz, as Music Story does, makes the distinction between Album (release-group) and Release.
This connector refers to Musibrainz releases. To get Musicbrainz release-group, please refer to the Album - Musicbrainz connector.

Example :
Search for the Musicbrainz releases associated with the release "High Violet" with the ID 1452416
http://api.music-story.com/en/release/1452416/musicbrainz

deezer

Displays Deezer albums matching the current release.

Example :
Search for the Deezer product associated with the album version with the ID 198 ("Strange Days")
http://api.music-story.com/en/release/198/deezer

spotify

Displays Spotify albums matching the current release.

Example :
Search for the Spotify product associated with the album version with the ID 202 ("The Soft Parade")
http://api.music-story.com/en/release/202/spotify

qobuz

Displays Qobuz albums matching the current release.

Example :
Search for the Qobuz product associated with the album version with the ID 1083 ("12 x 5")
http://api.music-story.com/en/release/1083/qobuz

amazonmp3

Displays Amazonmp3 albums matching the current release.

Example :
Search for the Amazonmp3 product associated with the album version with the ID 506 ("BOF Anna")
http://api.music-story.com/en/release/506/amazonmp3

itunes

Displays iTunes albums matching the current release.

Example :
Search for the iTunes product associated with the album version with the ID 305 ("Reality")
http://api.music-story.com/en/release/305/itunes

sevendigital

Displays 7digital albums matching the current release.

Example :
Search for the 7digital product associated with the album version with the ID 207 ("Turn! Turn! Turn!")
http://api.music-story.com/en/release/207/sevendigital

starzik (Deprecated)

Displays Starzik albums matching the current release.

Example :
Search for the Sarzik product associated with the album version with the ID 489 ("Primal Scream")
http://api.music-story.com/en/release/489/starzik

amazon

Displays Amazon albums matching the current release.

Example :
Search for the Amazon product associated with the album version with the ID 47 ("Trout Mask Replica")
http://api.music-story.com/en/release/47/amazon

fnac

Displays Fnac albums matching the current release.

Example :
Search for the Fnac product associated with the album version with the ID 47 ("Trout Mask Replica")
http://api.music-story.com/en/release/47/fnac

priceminister

Displays PriceMinister albums matching the current release.

Example :
Search for the PriceMinister product associated with the album version with the ID 33 ("Tago Mago")
http://api.music-story.com/en/release/33/priceminister

xboxmusic

Récupère les Xboxmusic associés à la release

Example :
[detail exemple]
http://api.music-story.com/en/release/1071/xboxmusic