GET
Tracks

Get Lyrics

Return the full lyrics text for a track when available.

/v1/tracks/:tune_id/lyrics
Method
GET
Path
/v1/tracks/:tune_id/lyrics
Group
Tracks

Lyrics availability varies by track. If lyrics are unavailable, the lyrics field will be null.

Overview

How to use this endpoint

Use this endpoint when you need structured API data in a predictable JSON shape. Reference the request example, required parameters, and response fields below to wire it into your product or internal tool.

Response format

JSON response

All successful responses return data in a stable JSON envelope and use Tune UUIDs for resource identifiers.

Code example

Example request

request
GET /v1/tracks/3f2504e0-4f89-11d3-9a0c-0305e82c3301/lyrics

Request parameters

Path parameters

ParameterTypeRequiredDescription
tune_iduuidYesStable Tune identifier for the requested resource.

Response schema

Response fields

FieldTypeDescription
tune_iduuidTrack Tune identifier.
lyricsstring | nullFull lyrics text.
source_urlstring | nullCanonical source URL.

Code example

Example response

application/json
{
  "data": {
    "tune_id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
    "lyrics": "Static lines across the sky
A ghost of signal left behind
I reach for what was there
But only afterimages remain...",
    "source_url": "https://genius.com/nova-circuit-afterimage-lyrics"
  }
}

Next steps

Keep exploring the reference