API Documentation
Integrate Kaemit into your application. All endpoints require an API Key.
Authentication
Pass your API Key via the Authorization header using the
Bearer scheme.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://kaemit.cc/api/lyrics?q=Song+Title"
Rate Limiting
Each API key has a per-minute request limit. If you exceed your limit, the API returns
429 Too Many Requests.
Common Parameters
All search endpoints accept these optional filter parameters to narrow results:
| Parameter | Type | Description |
|---|---|---|
| q | required | Song title or alias |
| artist | optional | Filter by artist name |
| album | optional | Filter by album name |
| duration | optional | Filter by duration in seconds (±5s tolerance) |
Endpoints
GET
/api/lyrics
text/plain
Returns the raw lyrics text (LRC content). Not JSON.
Extra Parameters:
-
lang(optional) — Language code for translation (e.g.tr,es)
Example:
curl -H "Authorization: Bearer YOUR_KEY" \
"https://kaemit.nya.fan/api/lyrics?q=Song+Title&lang=tr"
# Response (text/plain):
[00:12.00]First line of lyrics
[00:18.50]Second line of lyrics
...
GET
/api/metadata
application/json
Returns track metadata as JSON, including artist, album, release year, duration, and artwork URL.
Example Response:
{
"song_id": 1,
"title": "Song Name",
"artist": "Artist",
"album": "Album Name",
"release_year": 2026,
"duration": 210,
"artwork_url": "https://example.com/cover.jpg"
}
GET
/api/artwork
302 → image
Redirects (HTTP 302) to the raw album artwork image URL. Use directly in <img> tags.
Example:
<img src="https://kaemit.nya.fan/api/artwork?q=Song+Title"
alt="Album Cover" />Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameters |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — insufficient permissions |
| 404 | Not Found — song not found or has no data for this endpoint |
| 429 | Too Many Requests — rate limit exceeded |