Search Lirik API

API untuk mencari lirik lagu berdasarkan keyword menggunakan Genius, termasuk judul, artis, cover, dan full lyrics

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /tools/search-lyrics
  • Method: GET
  • Credit Usage: 3

Authentication

Gunakan header berikut pada setiap request:

x-maelyn-auth: YOUR_API_KEY

Query Parameters

Endpoint ini digunakan untuk mencari lirik lagu berdasarkan judul lagu, artis, atau kombinasi keduanya.

Example Request

GET /tools/search-lyrics?search=stay%20justin%20bieber

Parameters

NameTypeRequiredDescription
searchstringYesKeyword pencarian (judul lagu / artis)

Example Usage

GET /tools/search-lyrics?search=see%20you%20again%20wiz%20khalifa

Success Response

{
  "success": true,
  "result": {
    "title": "The Kid LAROI & Justin Bieber – STAY",
    "artist": "The Kid LAROI",
    "image": "https://images.genius.com/cd085ac3e3266b1d7af750c367855fda.1000x1000x1.png",
    "lyrics": "[Chorus]\nI do the same thing I told you that I never would\n...",
    "url": "https://genius.com/The-kid-laroi-and-justin-bieber-stay-lyrics"
  }
}

Response Fields

title

Judul lagu lengkap

artist

Nama artis utama

image

URL cover/artwork lagu (Genius)

lyrics

Lirik lengkap lagu (plain text, sudah dibersihkan)

url

Link halaman Genius asli


Error Response

Missing Parameter

{
  "success": false,
  "message": "Parameter 'search' wajib diisi"
}

Song Not Found

{
  "success": false,
  "message": "Lagu tidak ditemukan"
}

Lyrics Extraction Failed

{
  "success": false,
  "message": "Lirik tidak berhasil diambil"
}

Internal Server Error

{
  "success": false,
  "message": "Terjadi kesalahan"
}

Playground