A recording
Description
A Recording is the unique recording of a Track, defined by his ISRC.
A Recording can be contained in one or more editions (Release) and can concern multiple Tracks.
Example :
Get the Kiss track "Beth" recording having id 126596.
http://api.music-story.com/en/recording/126596
Fields
Name | Description | Facultatively | Type | Restriction |
---|---|---|---|---|
id | Unique ID | no | bigint | Unlimited |
title | Title | no | string | Unlimited |
subtitle | Subtitle | no | string | Unlimited |
length | Recording duration | no | time | Unlimited |
isrc | ISRC de l'enregistrement | no | string | Unlimited |
hit | Is this recording a hit? | no | boolean | Unlimited |
focus | Is this recording recommended? | no | boolean | Unlimited |
parental_advisory | Does this recording contain shocking lyrics? | no | boolean | Unlimited |
recording_place | Recording place | no | string | Unlimited |
production_date | Recording date | no | date | Unlimited |
update_date | Last update | no | date | Unlimited |
creation_date | Creation date | no | date | Unlimited |
search
Action research
Example :
Gather recordings having their title beginning by "Beth", marked as to be discovered.
http://api.music-story.com/en/recording/search?title=Beth%&focus=1
genres
Gathers the genres associated with the recording
Example :
Gathers the genres linked to the recording of the track "Beth" (id 126596) by KISS.
http://api.music-story.com/en/recording/126596/genres
artists
Gathers the artists associated with the recording
Added fields | Description | Facultatively | Type | Restriction |
---|---|---|---|---|
role | Relation between artist and recording | no | 'main'/'performer'/'author'/'conductor'/'orchestra'/'composer' | Unlimited |
Example :
Gathers the artists linked to the recording of the track "Beth" (id 126596) by KISS.
http://api.music-story.com/en/recording/126596/artists
tracks
Gathers tracks associated with the current recording
Example :
Get associated tracks of the KISS's recording named "Beth" (id 126596)
http://api.music-story.com/en/recording/126596/tracks
albums
Gathers albums associated with the current recording
Example :
Get associated albums of the KISS's recording named "Beth" (id 126596)
http://api.music-story.com/en/recording/126596/albums
videos
Gets the videos associated with the current recording
Example :
Gets the videos associated with the recording 639
http://api.music-story.com/en/recording/639/videos
lyric
Gathers albums associated with the current recording
Example :
Get the "Bored" by Deftones band lyric
http://api.music-story.com/en/recording/25272/lyric
musicbrainz
Retrieves the Musicbrainz recordings associated with the current recording.
Musicbrainz, as Music Story does, makes the distinction between recordings and tracks (read object description).
This connector refers to Musibrainz recordings, not to Musicbrainz tracks.
Example :
Search for the Musicbrainz recordings associated with the recording with the ID 1917068
http://api.music-story.com/en/recording/1917068/musicbrainz
deezer
Retrieves the Deezer tracks associated with the current recording.
Example :
Search for the Deezer recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/deezer
spotify
Retrieves the Spotify tracks associated with the current recording.
Example :
Search for the Spotify recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/spotify
qobuz
Retrieves the Qobuz tracks associated with the current recording.
Example
Search for the Qobuz recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/qobuz
amazonmp3
Retrieves the Amazon MP3 tracks associated with the current recording.
Example :
Search for the Amazon MP3 recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/amazonmp3
itunes
Retrieves the iTunes tracks associated with the current recording.
Example
Search for the iTunes recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/itunes
sevendigital
Retrieves the 7digital tracks associated with the current recording.
Example :
Search for the 7digital recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/sevendigital
starzik (Deprecated)
Retrieves the Starzik tracks associated with the current recording.
Example :
Search for the Starzik recordings associated with the recording with the ID 17
http://api.music-story.com/en/recording/17/starzik
xboxmusic
Récupère les pistes Xboxmusic associés à la piste
Example :
[detail exemple]
http://api.music-story.com/en/recording/1508/xboxmusic