Lyrics, in sync · An API for developers
Lyrics. Timing.
One request.
Bring song lyrics to your player.
Four sources, one JSON format, and synchronization whenever it is available.
One fallback chain.
First lyrics found.
- 01 Octave
- 02 Musixmatch
- 03 Genius
- 04 lyrics.lol
Just name the song.
Send a track title and artist.
The adapter finds the metadata Octave needs.
curl "$API_BASE_URL/v1/lyrics" \
-H 'Content-Type: application/json' \
-d '{"title":"Operation Cyclone","artist":"Ghais Guevara"}'const response = await fetch('/v1/lyrics', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
title: 'Operation Cyclone',
artist: 'Ghais Guevara'
})
});
const result = await response.json();import os
import httpx
response = httpx.post(
os.environ["API_BASE_URL"].rstrip("/") + "/v1/lyrics",
json={"title": "Operation Cyclone", "artist": "Ghais Guevara"},
timeout=90,
)
result = response.json(){
"provider": "octave",
"plain_lyrics": "Every sound in its place",
"synced_lyrics": "[00:12.40]Every sound in its place",
"lines": [
{
"start": 12.4,
"end": null,
"text": "Every sound in its place"
}
]
}The panel shows a shortened response with fictional lyrics.
The button sends a real request to this service’s API.
In cURL and Python, API_BASE_URL is your deployment’s base address. JavaScript uses a relative path on the same origin.
From plain text
to every word.
Use the detail your source provides. Every source returns one consistent format, so your app needs only one integration.
Explore the response schema- 01plain_lyrics
Plain lyrics
Song lyrics without timestamps. The basic format for displaying and saving text.
- 02synced_lyrics / lines
Line synchronization
The original LRC plus an array of lines timed in seconds. Ready for highlighting during playback.
- 03words
Word timestamps
Start and end timestamps for individual words, when the source provides this level of detail.
Find every detail in the docs.
Parameters, errors, response examples, and the Python library.