Free, open, LRCLIB-compatible

Best lyrics for an exact track match. Params: artist_name, track_name (required), album_name, duration (seconds, matched ±2s). Karalyr serves word-synced karaoke lyrics only; on a miss it returns 404 — clients handle their own fallbacks (e.g. LRCLIB) and can request a sync via the wanted queue.

curl "https://karalyr.com/api/get?artist_name=Neon%20Practice&track_name=Refactor%20My%20Heart&duration=212"

Response: LRCLIB fields (plainLyrics, syncedLyrics — Enhanced LRC when word timing exists) plus karalyr: { payload, tier, source, revision_id, has_word_timing }.

Same response by internal track id.

curl "https://karalyr.com/api/get/2"

Fuzzy full-text search over artist / title / album. Params: q, or artist_name / track_name / album_name.

curl "https://karalyr.com/api/search?q=refactor"

Proof-of-work challenge for publishing. Find a nonce such that sha256(prefix + nonce) (hex) is ≤ target. Challenges expire after 10 minutes and are single-use.

curl -X POST "https://karalyr.com/api/request-challenge"
# → { "prefix": "…", "target": "00001fff…" }

Submit lyrics as a new revision (nothing is overwritten). Body: track metadata + either a structured payload or raw text with format (lrc, enhanced_lrc, ultrastar), plus the solved challenge. Word timing is required: line-level LRC is rejected with WordTimingRequired — request a sync in the wanted queue instead. If the track's current best revision is verified, the submission enters pending_review.

curl -X POST "https://karalyr.com/api/publish" -H "Content-Type: application/json" -d '{
  "challenge": { "prefix": "<prefix>", "nonce": "<nonce>" },
  "artist_name": "Artist",
  "track_name": "Song",
  "duration": 201,
  "raw": "[00:12.00]<00:12.00>First <00:12.60>line\n[00:15.30]<00:15.30>Second <00:15.90>line",
  "format": "enhanced_lrc"
}'

Quality feedback for a revision. Types: explicit_up, explicit_down, clean_playthrough, offset_correction (with value = offset in ms, positive = lyrics should appear later). Three agreeing offset reports auto-create a corrected revision; three positive signals promote a revision one tier.

curl -X POST "https://karalyr.com/api/signal" -H "Content-Type: application/json" \
  -d '{ "revision_id": 2, "type": "explicit_up" }'

Full revision history for a track (public transparency).

curl "https://karalyr.com/api/track/2/revisions"