# Darklyrics — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for song and album lyrics from metal music bands, browse newly added albums and complete band discographies, and access full lyrics organized by artist and release. Filter bands alphabetically and find specific songs to read their complete lyrical content.

**Category:** Music | **Website:** [darklyrics.com/](https://darklyrics.com/) | **Docs:** [parse.bot/marketplace/41263262-9cb7-4e58-b2e3-1cfb8e86dbbb/darklyrics-com-api](https://parse.bot/marketplace/41263262-9cb7-4e58-b2e3-1cfb8e86dbbb/darklyrics-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_album_lyrics

Get the complete lyrics for all songs on an album. Returns album name, year, and an array of songs each with track number, title, and full lyrics text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `album_slug` | string | Yes | Album URL slug (e.g. 'killemall', 'masterofpuppets'). |
| `band_slug` | string | Yes | Band URL slug (e.g. 'metallica'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/get_album_lyrics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"album_slug":"<string>","band_slug":"<string>"}'
```

### get_band_page

Get a band's discography including albums, demos, and EPs with their tracklists. Each album entry contains its title, year, type, and list of songs with track numbers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `band_slug` | string | Yes | Band URL slug (e.g. 'metallica', 'ironmaiden'). |
| `letter` | string | Yes | First letter of the band name (a-z) or # for bands starting with numbers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/get_band_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"band_slug":"<string>","letter":"<string>"}'
```

### get_bands_by_letter

Get the list of all bands whose name starts with a given letter. Returns band names, URLs, and URL slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | Yes | Single letter to filter by (a-z) or # for bands starting with numbers. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/get_bands_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_homepage

Get newly added albums from the DarkLyrics homepage. Returns a list of recently added albums with band name, album title, and thumbnail image URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_song_lyrics

Get lyrics for a specific song on an album by its track number. Returns song title, lyrics text, album metadata, and identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `album_slug` | string | Yes | Album URL slug (e.g. 'killemall'). |
| `band_slug` | string | Yes | Band URL slug (e.g. 'metallica'). |
| `track_number` | string | Yes | Track number on the album (starting from 1). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/get_song_lyrics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"album_slug":"<string>","band_slug":"<string>","track_number":"<string>"}'
```

### search

Search for artists, albums, or songs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-darklyrics-com-api-41263262/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```