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

band : Groupe
person : Personne

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

male : Homme
female : Femme

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 :

Main : Le genre est le genre majeur de l'artiste
Principal : Le genre est le genre principal de l'artiste
Secondary : Le genre est un genre secondaire de l'artiste
Influence : Le genre est une influence de l'artiste
Must : L'artiste est un artiste incontournable de ce genre

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 :

Similar : Autre artiste voisin musicalement d'un artiste (groupe ou personne)
Influence : Autre artiste ayant influencé un artiste (groupe ou personne)
Successor : Autre artiste ayant été influencé par un artiste (groupe ou personne)
Collaborator : Personne ayant collaboré avec un artiste
Band : Groupe dont est ou a été membre une personne
Member : Personne membre d'un Groupe

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 :

Name : Le nom de scène de l'artiste
Realname : Prénom et nom réél de l'artiste
Alias : Alias de l'artiste
Nickname : Surnom de l'artiste
Translation : Traduction du nom de l'artiste

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:

Main : La biographie est celle de l'artiste
Mentioned : L'artiste est mentionné dans la 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 :

Connected : L'artiste est concerné par la news
Mentioned : L'artiste est mentionné dans la 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 :

Connected : L'artiste est concerné par la timeline
Mentioned : L'artiste est mentionné dans la 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 :

Main : L'artiste est l'interprète principal, cette version d'album appartient donc à sa discographie
Performer : L'artiste est crédité comme interprète sur cette version d'album
Author : L'artiste est crédité comme Auteur sur cette version d'album
Composer : L'artiste est crédité comme compositeur sur cette version d'album
Conductor : L'artiste est crédité comme chef d'orchestre sur cette version d'album
Orchestra : Orchestre de cette 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.

Main : L'artiste est l'interprète principal, cet album appartient à sa discographie
Performer : L'artiste est crédité comme interprète sur cet album
Author : L'artiste est crédité comme Auteur sur cet album
Composer : L'artiste est crédité comme compositeur sur cet album
Conductor : L'artiste est crédité comme chef d'orchestre sur cet album
Orchestra : Orchestre de cet album

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 :

Main : L'album chroniqué est de l'artiste
Mentioned : L'artiste est mentioné dans la chronique

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 :

Main : L'artiste est l'artiste principal de la piste
Performer : L'artiste est interprète sur la piste
Author : L'artiste est l'auteur de la piste
Conductor : L'artiste est le chef d'orchestre de la piste
Orchestra : L'artiste est l'orchestre interprétant la piste
Composer : L'artiste a composé la piste

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 :

Performer : L'artiste est interprète sur la piste
Author : L'artiste est l'auteur de la piste
Composer : L'artiste a composé la piste

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