Recherche et score d'un titre d'une playlist radio
Description
Ce connecteur a été spécialement conçut pour rechercher des titres (niveau recording) à partir d'un champs "artiste+titre".
(tel qu'on le trouve dans une playlist de radio, par exemple). Il est optimisé pour traiter les variantes de typographies de l'artiste et du titre (alias, inversions nom et prénom etc...).
Le connecteur renvoie une liste de Recordings ayant des scores de matching avec le champs artiste+titre donné supérieur à 60%.
Pour optimiser les requêtes, ce connecteur renvoie en masse pour chaque titre :
Champs recording
Nom | Description | Facultatif | Type |
---|---|---|---|
id | ID unique | non | bigint |
title | Titre | non | string |
subtitle | Sous-titre | non | string |
length | Durée de l'enregistrement | non | time |
isrc | ISRC de l'enregistrement | non | string |
hit | L'enregistrement est-il un hit | non | boolean |
focus | L'enregistrement est-il à découvrir | non | boolean |
parental_advisory | L'enregistrement contient-il des paroles choquantes? | non | boolean |
recording_place | Lieu d'enregistrement | non | string |
production_date | Date d'enregistrement | non | date |
update_date | Dernière date de mise à jours | non | date |
creation_date | Date d'entrée dans la base de données | non | date |
score | Score de résultat de recherche en % | non | float |
Champs artists
Nom | Description | Facultatif | Type |
---|---|---|---|
id | ID unique | non | int |
name | Nom complet | non | string |
ipi | IPI | non | string |
type | Est-ce un groupe ou une personne? | non | "band"/"person" |
sex | Sexe si c'est une personne | oui | "male"/"female" |
role | Rôle | oui | string |
role_fr | Rôle en français | oui | string |
url | Url sur le site Music Story | non | string |
firstname | Prénom | non | string |
lastname | Nom propre | non | string |
nickname | Surnom | non | string |
realname | Nom réel de l'artiste | oui | string |
coefficient | Coefficient d'actualité | non | int |
country | Pays en anglais | oui | string |
country_fr | Pays en français | oui | string |
start_decade | Décennie de début de carrière | oui | int |
end_decade | Décennie de fin de carrière | oui | int |
update_date | Date de dernière mise à jour | non | date |
create_date | Date d'entrée en base de données | non | date |
Champs albums
Nom | Description | Facultatif | Type |
---|---|---|---|
id | ID unique | non | int |
title | Le titre | non | string |
url | Url Music Story | non | string |
label | Label | non | string |
distributor | Label | non | string |
type | Type | non | "Original"/"Live"/"Compilation"/"Karaoke"/"Ring"/"Other" |
format | Format | non | "Album"/"EP"/"Single"/"MCD" |
release_date | Date de sortie d'origine | non | date |
update_date | Date de dernière mise à jour | non | date |
creation_date | Date d'entrée dans la base de données | non | date |
Champs picture
Nom | Description | Facultatif | Type |
---|---|---|---|
id | ID unique | non | int |
id | Url de l'image | non | string |
Champs genres
Nom | Description | Facultatif | Type |
---|---|---|---|
id | ID unique | non | int |
link | Lien du genre sur l'artiste | non | string |
name | Nom en anglais | non | string |
Exemples d'utilisation
Ci-après vous trouverez 2 exemples afin d'expliquer l'utilisation du connecteur Artist_Title.
Exemple 1 : Recherche d'un titre correct
Cet exemple illustre une recherche de titre dans l'API lorsque le nom de l'artiste et le titre du titre est correct. Ici, le titre Tous les mêmes de l'artiste Stromae :
http://api.music-story.com/fr/artist_title/search?name=Stromae&title=Tous les memes
Exemple 2 : Recherche d'un titre approximatif
Cet exemple illustre une recherche de titre dans l'API lorsque le nom de l'artiste est correct, mais que le titre de la piste contient une faute. On va chercher le titre Toutes les memes de l'artiste Stromae
http://api.music-story.com/fr/artist_title/search?name=Stromae&title=Toutes les memes
Example 3 : Recherche d'un titre avec filtre(s) sur l'album
Cet exemple illustre une recherche de titre dans l'API en filtrant sur le type et le format d'album :
http://api.music-story.com/fr//artist_title/search?albumFormat=Album&albumType=Live&name=Linkin Park&title=Runaway