Artist_Title

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 :


Comme tous les connecteur spéciaux, ce connecteur est réservé aux titulaires d'un compte Pro ou Enterprise et ne peut être utilisé avec des conditions d'utilisation non commerciale.
Les droits sont affectés spécifiquement à un compte par l'équipe support.

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

Le titre "tous les mêmes" est retourné avec le champs score à "1" (100%)

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

Le titre "tous les mêmes" est retourné avec le champs score à "0.78" (78%)

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

Les titres "Runaway" sont retournés, mais uniquement ceux dont l'album est de format Album et de type Live.
Si aucun paramètre de filtre n'est passé tout sera retourné.
Il est possible de passer plusieurs valeurs pour chaque paramètre, séparées par des virgules :
Format : Album, Single, Ep, MCD
Type : Original, Live, Compil, Karaoke, Ring, Other

music story

Forgot your password ?