Work and lyrics of this work
Description
The lyric object corresponds to lyrics of a song. It defines also the work associated to the song with its unique ISWC code(International Standard Music Work Code)
and a data structure of rights (authors, composers...).
It may be linked to several recordings defined by their ISRCs and to all corresponding tracks.
The lyric object gives access through its LyricFind connector to LyricFind database IDs.
Those IDs allow direct requests to lyrics of a song.
Example :
Get the Deftones work named "Bored" at id 6547615.
http://api.music-story.com/en/lyric/6547615
Fields
Name | Description | Facultatively | Type | Restriction |
---|---|---|---|---|
id | Unique ID | no | int | Unlimited |
title | Title | no | string | Unlimited |
iswc | ISWC code | no | string | Unlimited |
update_date | Last update | no | date | Unlimited |
creation_date | Creation date | no | date | Unlimited |
Connectors
Name | Description | Returns |
---|---|---|
search | Search action | A list of Lyric |
artists | Gather associated artists. | A list of Artist |
recordings | Gather associated recordings. | A list of Recording |
tracks | Returns tracks associated with the current work | A list of Tracks |
lyricfind | Récupère les paroles LyricFind associé à la parole Music-Story | A list of LyricFind |
search
Search for a song by title.
Example :
Search for lyrics having the title "Bored".
http://api.music-story.com/en/lyric/search?title=Bored
artists
Returns artists associated with a song.
In addition to artist's data, field role of liric-artists connector describes the role of an artist regarding a song.
Links lyric-artists can take the following values :
Added fields | Description | Facultatively | Type | Restriction |
---|---|---|---|---|
role | Roles of the artist for the current work. | no | array | Unlimited |
Example :
Get artists associated with the "Bored" lyric (id 6547615) by the band Deftones.
http://api.music-story.com/en/lyric/6547615/artists
recordings
Returns recordings associated with a song.
Example :
Get recordings associated with the "Bored" lyric (id 6547615) by the band Deftones.
http://api.music-story.com/en/lyric/6547615/recordings
tracks
Returns tracks associated with a song.
Example :
Get tracks associated with the "Bored" lyric (id 6547615) by the band Deftones.
http://api.music-story.com/en/lyric/6547615/tracks
lyricfind
Returns the LyricFind ID associated with a song, in order to request LyricFind API and retrieve lyrics, copyright and LRC tags.
ATTENTION : The use of LyricFind API is free for development purposes (LyricFind Evaluation License).
For a commercial use you must refer to LyricFind terms of services (contact : sales@lyricfind.com).
LyricFind API documentation : http://www.lyricfind.com/webservice_v2_1_1.pdf
Example :
Get LyricFind associated with the "Bored" lyric (id 6547615) by the band Deftones.
http://api.music-story.com/en/lyric/6547615/lyricfind
Get the LyricFind id 001-884377 and request LyricFind API as following:
http://api.lyricfind.com/lyric.do?apikey=<YOUR LYRICFIND API KEY>&trackid=lfid:001-884377&reqtype=default
See result