> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xvz.wtf/llms.txt
> Use this file to discover all available pages before exploring further.

# Lyrics

> Get song lyrics

## Endpoint

```
GET /lyrics/{song}
```

## Parameters

| Parameter | Type   | Required | Description                                   |
| --------- | ------ | -------- | --------------------------------------------- |
| `song`    | string | Yes      | Song name                                     |
| `api_key` | string | Yes\*    | Your API key (or pass via `X-API-Key` header) |

## Request

<CodeGroup>
  ```http Query Parameter theme={null}
  GET /lyrics/blinding lights?api_key=xvz-api-
  ```

  ```http Header theme={null}
  GET /lyrics/blinding lights
  X-API-Key: xvz-api-
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "title": "Blinding Lights",
  "artist": "The Weeknd",
  "lyrics": [
    "I've been trying to call",
    "I've been on my own for long enough",
    "..."
  ],
  "url": "https://open.spotify.com/track/...",
  "thumbnail": "https://i.scdn.co/image/..."
}
```

<Note>The `lyrics` field is returned as an array of non-empty lines</Note>