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 :

The field "format" can take the following values : The field "support" designates the physical support of the release. With following values : 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 :

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

music story

Forgot your password ?