API

Free, with CORS open. Generate a key below and send it as the x-api-key header.

GET/api/get?artist_name=&track_name=&duration=

Best match in the library: the same song within 2 seconds of the duration, else a close synced match. 404 if we don't have it.

GET/api/get/{id}

One record by its lrc_ id.

GET/api/search?q=

Songs in the library. Also takes track_name and artist_name.

POST/api/needs

Report a song with no synced lyrics, so it shows on the Needs lyrics shelf. JSON with trackName, artistName and duration; albumName, videoId (YouTube) and artworkUrl (an iTunes or YouTube image) are optional. Repeat reports count up.

POST/api/publish

JSON with trackName, artistName, duration and syncedLyrics (LRC). albumName, videoId and contributor are optional; instrumental: true needs no lyrics. Up to 10 per hour per IP.

Response

{
  "id": "lrc_6720ab12cd34ef5678901234",
  "trackName": "Shake It Off",
  "artistName": "Taylor Swift",
  "albumName": "1989",
  "duration": 219,
  "instrumental": false,
  "plainLyrics": "I stay out too late…",
  "syncedLyrics": "[00:12.30]I stay out too late…"
}