GET
TracksGet Lyrical Analysis
Return LLM-generated lyrical analysis and annotations for a track.
/v1/tracks/:tune_id/lyrics/analysisMethod
GET
Path
/v1/tracks/:tune_id/lyrics/analysis
Group
Tracks
If analysis has not been generated yet, the API may return 202 Accepted while analysis is queued.
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
Copy-ready
GET /v1/tracks/3f2504e0-4f89-11d3-9a0c-0305e82c3301/lyrics/analysisRequest parameters
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tune_id | uuid | Yes | Stable Tune identifier for the requested resource. |
Response schema
Response fields
| Field | Type | Description |
|---|---|---|
tune_id | uuid | Track Tune identifier. |
artist_name | string | Artist name. |
track_name | string | Track title. |
analysis | string | Long-form lyrical analysis. |
annotations | object[] | Annotated lyric fragments and interpretations. |
model | string | Model used to generate the analysis. |
Code example
Example response
application/json
Copy-ready
{
"data": {
"tune_id": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
"artist_name": "Nova Circuit",
"track_name": "Afterimage",
"analysis": "Afterimage uses digital decay and transmission imagery to explore memory, absence, and emotional persistence.",
"annotations": [
{
"fragment": "Static lines across the sky",
"annotation": "A metaphor for corrupted memory and residual signal."
}
],
"model": "gpt-4o"
}
}Next steps