Live search (landing-page dropdown)

GET

/api/search

Capped typeahead results (6 albums / 10 tracks). Every whitespace- separated word of q must appear, in any order (apostrophe variants interchangeable). mode=title matches album titles or tag names and track titles; mode=lyrics matches lyric lines (tracks only) and returns the first matching line as snippet. Under 2 query chars returns empty results. Empty when the product's lyrics_enabled setting is off (lyrics mode). Never cached (no-store on every response).

Request

Query Params

Responses

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request

🔴500Server Error

Response Example

{
    "query": "string",
    "mode": "title",
    "albums": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "slug": "string",
            "title": "string",
            "year": 0,
            "coverUrl": "string"
        }
    ],
    "tracks": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "slug": "string",
            "albumSlug": "string",
            "title": "string",
            "artist": "string",
            "albumTitle": "string",
            "year": 0,
            "durationSeconds": 0,
            "coverUrl": "string",
            "snippet": "string"
        }
    ]
}

Modified at 2026-09-08 18:05:01

/api/tracks

/api/tracks/{id}/cover