Playground
Auth
Send your API key as a Bearer token.
Authorization: Bearer lyr_your_key Endpoint
GET
/lyrics
Readable query names:
curl \
-H "Authorization: Bearer lyr_your_key" \
"https://api.lyrithm.com/lyrics?artist=Twenty%20One%20Pilots&title=Tally&durationMs=213000" Short query aliases:
curl \
-H "Authorization: Bearer lyr_your_key" \
"https://api.lyrithm.com/lyrics?a=Twenty%20One%20Pilots&t=Tally&d=213000&g=plain" | Parameter | Alias | Required |
|---|---|---|
| artist | a | Recommended |
| title | t | Yes |
| album | al | No |
| durationMs | d | Recommended |
| granularity=plain | g=plain | No |
Response
Omitting granularity returns timed lyric tokens with the highest available
timing precision. Use granularity=plain or g=plain for plain
text.
{
"data": {
"title": "Tally",
"artist": "Twenty One Pilots",
"album": "Breach: Digital Remains",
"durationMs": 213000,
"granularity": "word",
"lyrics": [
{
"text": "...",
"startMs": 13737,
"endMs": 13900,
"index": "0.0"
}
]
},
"meta": {
"cache": "miss"
}
} Errors
Errors use a stable JSON shape.
{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or revoked API key.",
"requestId": "..."
}
} | Code | Meaning |
|---|---|
| BAD_REQUEST | Invalid query, path, or body input. |
| UNAUTHORIZED | Missing, invalid, or revoked API key. |
| RATE_LIMITED | The API key has exceeded its daily quota. |
| NOT_FOUND | No matching song or lyrics were found. |
| PROVIDER_ERROR | A lyrics provider failed unexpectedly. |