Album

Album, group of releases (EAN/UPC)

Description

An album is a group of several releases (EAN/UPC). It corresponds to the common understanding of what is an album. Example : The Bluprint from Jay-Z

The fields "type" and "format" are about the nature of the album, the first designates the kind of recording, the second defines its format.

The field "type" can take the following values :

The field "format" can take the following values :

Example :
Get the record type and format of the album Nevermind (id: 464)
http://api.music-story.com/en/album/464

Fields

Name Description Facultatively Type Restriction
id Unique ID no int Unlimited
title Title no string Unlimited
url Music Story url no string Unlimited
label Label no string Unlimited
distributor Editor no string Unlimited
type Type no "Original"/"Live"/"Compilation"/"Karaoke"/"Ring"/"Other" Unlimited
format Format no "Album"/"EP"/"Single"/"MCD" Unlimited
release_date Original release date no date Unlimited
update_date Last update date no date Unlimited
creation_date Database entry date no date Unlimited

Connectors

Name Description Returns
genres Gathers the genres linked to the current album A list of Genre
artists Gathers the artists linked to the current album A list of Artists
releases Gathers releases associated with the current album A list of Release
reviews Gathers the album's reviews A list of Review
charts Récupère les positions de l'album dans les classements A list of Charts
musicbrainz Musicbrainz albums matching the current album A list of Musicbrainz
deezer Deezer albums matching the current album A list of Deezer
spotify Spotify albums matching the current album A list of Spotify
qobuz Qobuz albums matching the current album A list of Qobuz
amazonmp3 Amazonmp3 albums matching the current album A list of Amazonmp3
itunes iTunes albums matching the current album A list of iTunes
sevendigital SevenDigital albums matching the current album A list of SevenDigital
starzik Starzik albums matching the current album A list of Starzik
amazon Amazon albums matching the current album A list of Amazon
fnac Fnac albums matching the current album A list of Fnac
priceminister PriceMinister albums matching the current album A list of PriceMinister

genres

Gathers the genres linked to the current album

Example :
Gathers the genres associated with the album Ram with the ID 18
http://api.music-story.com/en/album/18/genres

artists

Gathers all artists associated with this album. Links between artist and albums can take following values :

Example :
Gathers all artists associated with the album Nevermind
http://api.music-story.com/en/album/464/artists

releases

Gathers releases associated with the current album.

Example :
Gathers the album versions associated with the album "Nevermind" with the ID 464
http://api.music-story.com/en/album/464/releases

reviews

Gathers the albums reviews

Example :
Gathers the reviews associated with the album "Mylo Xyloto" with the ID 331003
http://api.music-story.com/en/album/331003/reviews

charts

Retrieves all positions of the album into the charts.
This connector will return charts which contains the album, and the associated positions.
A chart is identified by its source, a period ("start_date" to "end_date"), and its name.

Added fields Description Facultatively Type Restriction
rank The rank of the Album in this Chart non int Illimité
previous_rank The rank of the Album in the previous Chart non int Illimité

Example :
Position is desired for Album 656743 (Bon Anniversaire les Enfoirés) in all available charts.
http://api.music-story.com/en/album/656743/charts

musicbrainz

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

Example :
Search for the Musicbrainz albums associated with the album "Djantology" with the ID 82455
http://api.music-story.com/en/album/82455/musicbrainz

deezer

Displays Deezer albums matching the current album.

Example :
Search for the Deezer product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/deezer

spotify

Displays Spotify albums matching the current album.

Example :
Search for the Spotify product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/spotify

qobuz

Displays Qobuz albums matching the current album.

Example :
Search for the Qobuz product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/qobuz

amazonmp3

Displays Amazonmp3 albums matching the current album.

Example :
Search for the Amazonmp3 product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/amazonmp3

itunes

Displays iTunes albums matching the current album.

Example :
Search for the iTunes product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/itunes

sevendigital

Displays 7digital albums matching the current album.

Example :
Search for the 7digital product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/sevendigital

starzik (Deprecated)

Displays Starzik albums matching the current album.

Example :
Search for the Starzik product associated with the album with the ID 10653
http://api.music-story.com/en/album/10653/starzik

amazon

Displays Amazon albums matching the current album.

Example :
Search for the Amazon product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/amazon

fnac

Displays Fnac albums matching the current album.

Example :
Search for the Fnac product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/fnac

priceminister

Displays PriceMinister albums matching the current album.

Example :
Search for the PriceMinister product associated with the album with the ID 482881
http://api.music-story.com/en/album/482881/priceminister

music story

Forgot your password ?