API reference

Search

Search track, artist, and album metadata. Results are not ranked by popularity.

GET / JSON

https://lyrics-api.binimum.org/?q=Paradise

ISRC lookup

Find lyric files by recording ISRC.

GET / JSON

https://lyrics-api.binimum.org/?isrc=GBAYE1101143

Track lookup

Track and artist are required. Album and duration are optional.

GET / JSON

https://lyrics-api.binimum.org/?track=Paradise&artist=Coldplay&duration=279&album=Mylo%20Xyloto

PARAMETER	REQUIRED	DESCRIPTION
`track`	Yes	Track title
`artist`	Yes	Artist name
`duration`	No	Duration in seconds
`album`	No	Album title

History

Dated lyric counts. The latest entry may precede today.

GET / JSON

https://lyrics-api.binimum.org/count?history=true

Response

Search and lookup endpoints share the same response shape. Each result points to a TTML file. Use timing_type to distinguish word-level from line-level timing.

EXAMPLE RESPONSE

{
  "total": 1,
  "source": "HIT-LOCAL-LIBSQL",
  "results": [
    {
      "id": "69b92ef9000ee8938c3c",
      "track_name": "Paradise",
      "artist_name": "Coldplay",
      "album_name": "Mylo Xyloto",
      "duration": 279,
      "isrc": "GBAYE1101143",
      "timing_type": "word",
      "lyricsUrl": "https://lyrics-storage.binimum.org/GBAYE1101143.ttml"
    }
  ]
}

A catalogue match may return multiple versions, or no lyrics. Handle an empty results array and temporary service errors in your application.