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 :
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