Artist

Un artiste, groupe ou personne

Description

Un artiste peut avoir réalisé des albums en son nom propre ou avoir collaboré avec d'autres artistes.
Ce peut être un groupe ou une personne, déterminé par le champ "type" :

Que ce soit un groupe ou une personne , la nationalité est indiquée par le champ "country" (et "country_fr" en français).
Si c'est une personne, son sexe est déterminé par le champ "sex" : Pour une personne vous trouverez aussi : nom ("lastname"), prénom ("firstname"), surnom ("nickname") et rôle ("role", "role_fr" en français, comme guitariste, chanteur...).
Les décennies de début et de fin d'activité son exprimées en années de la décennie. Exemple : de 1970 à 2000.

Exemple :
Récupérer les données de l'artiste C2C
http://api.music-story.com/fr/artist/114832

Champs

Nom Description Facultatif Type Restriction
id ID unique non int Illimité
name Nom complet non string Illimité
ipi IPI non string Illimité
type Est-ce un groupe ou une personne? non "band"/"person" Illimité
sex Sexe si c'est une personne oui "male"/"female" Editorial
main_role Rôle oui string Editorial
url Url sur le site Music Story non string Illimité
firstname Prénom non string Illimité
lastname Nom propre non string Illimité
nickname Surnom non string Illimité
realname Nom réel de l'artiste oui string Editorial
coeff_actu Coefficient d'actualité non int Illimité
country Pays oui string Editorial
start_decade Décennie de début de carrière oui int Editorial
end_decade Décennie de fin de carrière oui int Editorial
update_date Date de dernière mise à jour non date Illimité
create_date Date d'entrée en base de données non date Illimité

Connecteurs

Nom Description Renvoie
search Recherche d'un artiste une liste de Artists
genres Genres musicaux d'un artiste une liste de Genres
artists Artistes associés à un artiste une liste de Artists
alias Récupère les alias associés à l'artiste une liste de Alias
biographies Biographies d'un artiste une liste de Biographies
news News, dernières news d'un artiste une liste de News
timeline Récupère les timeline associées à l'artiste une liste de Timeline
pictures Photos d'un artiste une liste de Pictures
shows Concerts prévus d'un artiste une liste de Shows
releases Albums (versions EAN/UPCs) d'un artiste une liste de Releases
albums Récupère les albums de l'artiste une liste de Albums
websites Retrouve les sites web de l'artiste une liste de Websites
bandpage Compte Bandpage de l'artiste une liste de Bandpage
facebook Compte Facebook d'un artiste une liste de Facebook
twitter Compte Twitter d'un artiste une liste de Twitter
youtubechannel Chaîne YouTube d'un artiste une liste de YoutubeChannel
youtube Vidéos Youtube d'un artiste une liste de Youtube
reviews Chroniques d'albums d'un artiste une liste de Reviews
tracks Titres et meilleurs titres d'un artiste une liste de Tracks
tracks Titres et meilleurs titres d'un artiste une liste de Recording
musicbrainz Artistes correspondants chez Musicbrainz une liste de Musicbrainz
deezer Artistes correspondants chez Deezer une liste de Deezer
spotify Artistes correspondants chez Spotify une liste de Spotify
qobuz Artistes correspondants chez Qobuz une liste de Qobuz
amazonmp3 Artistes correspondants chez Amazonmp3 une liste de Amazonmp3
itunes Artistes correspondants chez iTunes une liste de iTunes
sevendigital Artistes correspondants chez 7digital une liste de SevenDigital
amazon Artistes correspondants chez Amazon une liste de Amazon
fnac Artistes correspondants chez Fnac une liste de Fnac
priceminister Artistes correspondants chez PriceMinister une liste de PriceMinister
xboxmusic Connecteur Xboxmusic une liste de Xboxmusic

Recherche d'un artiste par tous ses champs.

Exemple :
Rechercher les artistes du type "band"
http://api.music-story.com/fr/artist/search?type=band

genres

Récupère les genres musicaux d'un artiste.
Ces genres peuvent être :

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre le genre et l'artiste non 'Main'/'Principal'/'Secondary'/'Influence'/'Must' Illimité

Exemple :
Récupérer les genres musicaux de l'artiste C2C
http://api.music-story.com/fr/artist/114832/genres

artists

Récupère les artistes associés à un artiste.
Les relations entre artistes peuvent être :

.

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre les artistes non 'Similar'/'Influence'/'Successor'/'Collaborator'/'Band'/'Member' Illimité

Exemple :
Recherche des artiste associés à Eric Clapton
http://api.music-story.com/fr/artist/61/artists

alias

Les noms et variations de noms associés à l’artiste.

Champs

Nom Description Facultatif Type Restriction
alias Alias non string Illimité
type Type non 'Name'/'Realname'/'Alias'/'Nickname'/'Translation' Illimité
lang Lang oui ISO 639-1 Illimité

Ces alias peuvent être de type :

L'API permet de récupérer les alias du type voulue. Si vous voulez des alias de type "Nickname", ajoutez un filtre "type" suivi de la valeur "nickname".
Pour récupérer uniquement les alias de type translation dans une langue donnée, il est possible de filtrer les résultats en utilisant le filtre "lang" (ISO 639-1).

Exemple :
Obtenir les alias associés à Puff Daddy
http://api.music-story.com/fr/artist/5140/alias

biographies

Les biographies associées à l'artiste, produites par Music Story qui en possède les droits de diffusion. Disponible en format long et en format court.
Il y a 2 types de liens entre un artiste et une biographie:

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre la chronique et l'artiste non 'Main'/'Mentioned' Illimité

Exemple :
Obtenir les biographies associées à C2C
http://api.music-story.com/fr/artist/114832/biographies

news

Récupère les news d'un artiste produites par Music Story (6 news par jour) qui en possède les droits de diffusion. Il y a 2 type de liens entre un artiste et une news :

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre l'évènement et l'artiste non 'Connected'/'Mentioned' Illimité

Exemple :
Récupération des News liées à Justin Bieber
http://api.music-story.com/fr/artist/116011/news

timeline

Récupère les timeline d'un artiste produites par Music Story qui en possède les droits de diffusion. Il y a 2 type de liens entre un artiste et une timeline :

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre la timeline et l'artiste non 'Connected'/'Mentioned' Illimité

Exemple :
Récupération des Timeline liées à Michael Jackson
http://api.music-story.com/fr/artist/454/timeline

pictures

Récupère la ou les photos d'un artiste.
Si le lien est de type main, alors l'image est l'image principale de l'artiste chez Music Story.

L'API permet de récupérer les photos en fonction de la qualité voulue. Si vous voulez des photos entre 400px de largeur et 1500px de largeur, ajoutez un filtre "width" suivi de la valeur "from:400:to:1500".

Champs Ajouté Description Facultatif Type Restriction
main Si VRAI, l'image est considérée comme l'image principale de l'artiste non boolean Illimité

Exemple :
Recherche des images de l'artiste George Harrison
http://api.music-story.com/fr/artist/1/pictures

shows

Récupère tous les concerts d'un artiste.
Pour récupérer uniquement les concerts à venir d'un artiste, il est possible de filtrer les résultats en utilisant le champ "start_date" du concert.

Exemple :
Recherche les concerts passés et à venir de Bob Dylan.
http://api.music-story.com/fr/artist/2/shows

releases

Récupère toutes les versions (EAN/UPCs) des albums associées à un artiste.
Pour récuperer la discographie d'un artiste, le connecteur album est plus aproprié. Le connecteur release vous donnera toutes les versions de chaque album d'une discographie.
Il y a plusieurs type de liens entre un artiste et une version d'album :

Champs Ajouté Description Facultatif Type Restriction
link Rôle de l'artiste dans la version d'album non "Main"/"Performer"/"Author"/"Conductor"/"Orchestra"/"Composer" Illimité

Exemple :
Récupérer les éditions d'album de l'artiste George Harrison
http://api.music-story.com/fr/artist/1/releases

albums

Récupère tous les albums associés à un artiste.

Champs Ajouté Description Facultatif Type Restriction
link Role de l'artiste dans l'album non "Main"/"Performer"/"Author"/"Conductor"/"Orchestra"/"Composer" Illimité

Exemple :
Récupère tous les albums de l'artiste George Harrison
http://api.music-story.com/fr/artist/1/albums

websites

Retourne les sites web d'un artiste. Un site web peut être officiel ou non officiel. Pour plus de détails voir la documentation.

Exemple :
Retourne les sites web de Stromae (ID 115916)
http://api.music-story.com/fr/artist/115916/websites

bandpage

Récupère l'ID Bandpage (appelé Band ID ou BID) et le lien vers la page Bandpage d'un artiste.

Exemple :
Récupérer l'ID Banpage et la page Bandpage officielle de l'artiste Calvin Harris (id: 6098)
http://api.music-story.com/fr/artist/6098/bandpage

facebook

Récupère le compte Facebook officiel d'un artiste. Retourne le compte le plus pertinent s'il n'existe pas de compte officiel.

Exemple :
Récupère la page Facebook officielle de l'artiste C2C
http://api.music-story.com/fr/artist/114832/facebook

twitter

Récupère le compte Twitter officiel d'un artiste. Retourne le compte le plus pertinent s'il n'existe pas de compte officiel.

Exemple :
Récupère la page Twitter officielle de l'artiste C2C
http://api.music-story.com/fr/artist/114832/twitter

youtubechannel

Récupère la chaîne YouTube d'un artiste.

Exemple :
Récupère la chaîne Youtube officielle de l'artiste C2C
http://api.music-story.com/fr/artist/114832/youtubechannel

youtube

Récupère les vidéos Youtube associées aux meilleurs titres d'un artiste.

Exemple :
Récupère les vidéos Youtube des meilleurs titres de l'artiste George Harrison
http://api.music-story.com/fr/artist/1/youtube

reviews

Les chroniques associées à l'artiste. Produites par Music Story qui en possède les droits de diffusion.
Ces chroniques peuvent être :

Champs Ajouté Description Facultatif Type Restriction
link Le type de liaison entre la chronique et l'artiste non 'Main'/'Mentioned' Illimité

Exemple :
Recherche des chroniques d'albums associées à Rihanna
http://api.music-story.com/fr/artist/5800/reviews

tracks

Récupère tous les titres liés à un artiste.
Avec les champs "Hit" et "Focus" qui permettent de sélectionner les titres qui ont été présents dans les charts ou recommandés par Music Story.

Les liens artiste-pistes peuvent être :

Champs Ajouté Description Facultatif Type Restriction
role Le rôle de l'artiste pour la piste. non string Illimité

Exemple :
Récupère les titres liés à l'artiste Ben Webster
http://api.music-story.com/fr/artist/878/tracks

recordings

Récupère les enregistrements liés à l'artiste courant.

Champs Ajouté Description Facultatif Type Restriction
role Le rôle de l'artiste pour la piste. non string Illimité

Exemple :
Récupère les enregistrements liés à l'artiste Ben Webster
http://api.music-story.com/fr/artist/878/recordings

lyrics

Récupère toutes les paroles liés à un artiste. Les liens artiste-paroles peuvent être :

Champs Ajouté Description Facultatif Type Restriction
role Le rôle de l'artiste pour la parole. non string Illimité

Exemple :
Récupère les paroles liés à l'artiste Ben Webster
http://api.music-story.com/fr/artist/878/lyrics

musicbrainz

Retourne l'artiste Musicbrainz correspondant à l'artiste courant.

Exemple :
Recherche des artistes Musicbrainz qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/musicbrainz

deezer

Retourne les artistes Deezer correspondants à l'artiste courant.

Exemple :
Recherche des artistes Deezer qui correspondent à l'artiste David Bowie
http://api.music-story.com/fr/artist/21/deezer

spotify

Retourne l'artiste Spotify correspondant à l'artiste courant.

Exemple :
Recherche des artistes Spotify qui correspondent à l'artiste Ian Curtis
http://api.music-story.com/fr/artist/132/spotify

qobuz

Retourne l'artiste Qobuz correspondant à l'artiste courant.

Exemple :
Recherche des artistes Qobuz qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/qobuz

amazonmp3

Retourne l'artiste Amazonmp3 correspondant à l'artiste courant.

Exemple :
Recherche des artistes Amazonmp3 qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/amazonmp3

itunes

Retourne l'artiste iTunes correspondant à l'artiste courant.

Exemple :
Recherche des artistes iTunes qui correspondent à l'artiste George Harrison
http://api.music-story.com/fr/artist/1/itunes

sevendigital

Retourne l'artiste 7digital correspondant à l'artiste courant.

Exemple :
Recherche des artistes 7digital qui correspondent à l'artiste Chris Hillman
http://api.music-story.com/fr/artist/7/sevendigital

amazon

Retourne l'artiste Amazon correspondant à l'artiste courant.

Exemple :
Recherche des artistes Amazon qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/amazon

fnac

Retourne l'artiste Fnac correspondant à l'artiste courant.

Exemple :
Recherche des artistes Fnac qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/fnac

priceminister

Retourne l'artiste PriceMinister correspondant à l'artiste courant.

Exemple :
Recherche des artistes PriceMinister qui correspondent à l'artiste Bob Dylan
http://api.music-story.com/fr/artist/2/priceminister

soundcloud

Connecteur SoundCloud

Exemple :
Récupère la chaîne Soundcloud officielle de l'artiste Miley Cyrus
http://api.music-story.com/fr/artist/103361/soundcloud

instagram

Connecteur Instagram

Exemple :
Récupère la page Instagram officielle de l'artiste Miley Cyrus
http://api.music-story.com/fr/artist/103361/instagram

Xboxmusic

Retourne les artistes Xboxmusic correspondant à l'artiste courant.

Exemple :
Recherche des artistes Xboxmusic qui correspondent à l'artiste John Lennon
http://api.music-story.com/fr/artist/13/xboxmusic

music story

Forgot your password ?