Working with lyrics

The lyrics endpoints serve two distinct purposes: fetching the complete lyrics for a specific song, and generating a configurable number of lyric paragraphs for use as realistic placeholder text in designs and tests.

Get full lyrics
Get N paragraphs

Fetch full lyrics for a song

Send a GET request to /lyrics/{songID} to retrieve the complete lyrics for a specific track. You need the song’s song_id, which you can obtain from the /songs or /albums/{albumID} endpoints.The example below fetches lyrics for song 10, Wonderland.

curl https://taylor-swift-api.sarbo.workers.dev/lyrics/10

Example response

{
  "song_id": 10,
  "song_title": "Wonderland",
  "lyrics": "Flashing lights and we\nTook a wrong turn and we\nFell down a rabbit hole...\n"
}

Response fields

Field	Type	Description
`song_id`	integer	ID of the song.
`song_title`	string	Title of the song.
`lyrics`	string	Full lyrics, with lines separated by `\n`.

To display lyrics cleanly in a web interface, split the lyrics string on \n\n to get individual paragraphs (verses/choruses), then split each paragraph on \n for individual lines.

Fetch N lyric paragraphs

Send a GET request to /lyrics with query parameters to retrieve a set number of lyric paragraphs. This is useful for generating realistic placeholder text in mockups, design systems, or UI tests — similar to Lorem Ipsum but with actual song lyrics.If the requested paragraph count exceeds what a single song provides, the API cycles through other songs automatically to fulfill the full count.

Query parameters

Parameter	Type	Required	Default	Description
`numberOfParagraphs`	integer	Yes	—	Number of lyric paragraphs to return. Must be `>= 1`.
`shouldRandomizeLyrics`	boolean	No	`false`	When `true`, paragraphs are drawn from random songs.

# Fetch 2 paragraphs in order
curl "https://taylor-swift-api.sarbo.workers.dev/lyrics?numberOfParagraphs=2"

# Fetch 3 paragraphs from random songs
curl "https://taylor-swift-api.sarbo.workers.dev/lyrics?numberOfParagraphs=3&shouldRandomizeLyrics=true"

Example response (numberOfParagraphs=2)

{
  "lyrics": [
    "He said the way my blue eyes shined\nPut those Georgia stars to shame that night\nI said: that's a lie",
    "Just a boy in a Chevy truck\nThat had a tendency of gettin' stuck\nOn back roads at night"
  ],
  "numParagraphs": 2
}

Response fields

Field	Type	Description
`lyrics`	string[]	Array of lyric paragraph strings.
`numParagraphs`	integer	Number of paragraphs returned (matches your request).

Use cases

Placeholder text in designs

Populate Figma frames or HTML mockups with authentic-sounding lyrics instead of generic Lorem Ipsum.

UI testing with realistic content

Seed test fixtures with varied paragraph counts to verify that long-form text renders correctly across screen sizes and components.

When shouldRandomizeLyrics is false (the default), the API returns paragraphs starting from the beginning of the first song and continues sequentially. Set it to true when you want variety across multiple renders of the same component.

Get Started

Guides

Fetch full lyrics for a song

Response fields

Fetch N lyric paragraphs

Query parameters

Response fields

Use cases

Placeholder text in designs

UI testing with realistic content

Build docs developers (and LLMs) love

Get Started

Guides

​Fetch full lyrics for a song

​Response fields

​Fetch N lyric paragraphs

​Query parameters

​Response fields

​Use cases

Placeholder text in designs

UI testing with realistic content

Build docs developers (and LLMs) love

Fetch full lyrics for a song

Response fields

Fetch N lyric paragraphs

Query parameters

Response fields

Use cases