S'inscrire à la newsletter
Oeuvre et paroles d'une oeuvre
Description
L'objet lyric désigne les paroles d'une chanson. Il définit également l'oeuvre associée à la chanson, avec son un code ISWC unique (International Standard Music Work Code)
et sa structure de données des droits (auteurs, compositeurs etc...). Il peut correspondre à plusieurs enregistrements (ou recording) définis par leurs ISRC et
donc à de multiples pistes (ou track).
L'objet Lyric donne accès via son connecteur LyricFind à l'identifiant correspondant de la base de paroles LyricFind.
Cet identifiant permet un accès direct aux paroles de l'oeuvre.
Exemple :
Récupération des paroles de "Bored", du groupe Deftones, avec l'id 6547615.
http://api.music-story.com/fr/lyric/6547615
Champs
| Nom | Description | Facultatif | Type | Restriction |
|---|---|---|---|---|
| id | ID unique | non | int | Illimité |
| title | Titre | non | string | Illimité |
| iswc | Code ISWC | non | string | Illimité |
| update_date | Date de dernière mise à jour | non | date | Illimité |
| creation_date | Date d'entrée dans la base de données | non | date | Illimité |
Connecteurs
| Nom | Description | Renvoie |
|---|---|---|
| search | Recherche de paroles | une liste de Lyric |
| artists | Récupère les artistes associées associé à l'oeuvre courante. | une liste de Artist |
| recordings | Retourne les enregistrements associées à l'oeuvre courante. | une liste de Recording |
| tracks | Retourne les pistes associées à l'oeuvre courante | une liste de Tracks |
| lyricfind | Récupère les paroles LyricFind associé à la parole Music-Story | une liste de LyricFind |
search
Recherche de paroles de chansons par le titre.
Exemple :
Recherche des paroles du titre titre "Bored"
http://api.music-story.com/fr/lyric/search?title=Bored
artists
Donne les artistes associés aux paroles d'une chanson.
En plus des informations artistes, le champs role du connecteur lyric-artists donne le rôle que tient l'artiste sur cette oeuvre. Les liens lyric-artists peuvent prendre les valeurs suivantes :
| Champs Ajouté | Description | Facultatif | Type | Restriction |
|---|---|---|---|---|
| role | Les roles tenus par l'artiste la chanson courante | non | array | Illimité |
Exemple :
Récupération des artistes associés à la parole "Bored" (id 6547615) du groupe Deftones.
http://api.music-story.com/fr/lyric/6547615/artists
recordings
Retourne les enregistrements (objets recording) associés aux paroles d'une chanson.
Exemple :
Récupération des enregistrements associés à la parole "Bored" (id 6547615) du groupe Deftones.
http://api.music-story.com/fr/lyric/6547615/recordings
tracks
Retourne les pistes (objets track) associées aux paroles d'une chanson.
Exemple :
Récupération des pistes associées à la parole "Bored" (id 6547615) du groupe Deftones.
http://api.music-story.com/fr/lyric/6547615/tracks
lyricfind
Récupère l'ID LyricFind associé aux paroles d'une chanson (un objet lyric) permettant de faire une requête via l'API LyricFind
et de récupérer principalement le texte des paroles, le copyright et les tags LRC.
ATTENTION : L'utilisation de l'API LyricFind est libre pour le développement de prototypes (LyricFind Evaluation License). Pour une utilisation commerciale vous devez vous souscrire aux conditions de services de LyricFind (contact :sales@lyricfind.com).
Documentation de l'API LyricFind : http://www.lyricfind.com/webservice_v2_1_1.pdf
Exemple :
Récupération des paroles LyricFind associées au titre "Bored" (id 6547615) du groupe Deftones.
http://api.music-story.com/fr/lyric/6547615/lyricfind
On obtient l'ID LyricFind 001-884377 et on peut effectuer la requête LyricFind suivante :
http://api.lyricfind.com/lyric.do?apikey=<VOTRE CLE API LYRICFIND>&trackid=lfid:001-884377&reqtype=default
Voir le résultat
