Skip to main content
GET
/
lyrics
{
  "lyrics": [
    "He says he doesn't believe anything much he hears these days\nHe says, \"Why fall in love, just so you can watch it go away?\"\nHe spends most of his nights wishing it was how it used to be\nHe spends most of his flights getting pulled down by gravity",
    "All this time I didn't know\nYou were breaking down\nI'd fall to pieces on the floor\nIf you weren't around\nToo young to know it gets better\nI'll be summer sun for you forever\nForever winter if you go"
  ],
  "numParagraphs": 2
}
Returns a specified number of lyric paragraphs sourced from across all songs. The API cycles through songs to fulfill the requested count — if a single song does not have enough paragraphs, it picks another song to continue filling the response. Use shouldRandomizeLyrics=true to receive paragraphs drawn randomly from different songs, or false (the default) to receive paragraphs in order.

​
Query parameters

​
numberOfParagraphs
integer
required
The number of lyric paragraphs to return. Must be an integer greater than or equal to 1.
​
shouldRandomizeLyrics
string
default:"false"
Whether to randomize which songs and paragraphs are selected. Accepts "true" or "false". Defaults to "false" when omitted, returning paragraphs in a consistent order.

​
Response

​
lyrics
string[]
required
Array of lyric paragraph strings. Each element is one paragraph from a song.
​
numParagraphs
integer
required
The number of paragraphs returned. Matches the value of numberOfParagraphs from the request.
With randomization
curl --request GET \
  --url "https://taylor-swift-api.sarbo.workers.dev/lyrics?numberOfParagraphs=2&shouldRandomizeLyrics=true"
Without randomization
curl --request GET \
  --url "https://taylor-swift-api.sarbo.workers.dev/lyrics?numberOfParagraphs=2&shouldRandomizeLyrics=false"

{
  "lyrics": [
    "He says he doesn't believe anything much he hears these days\nHe says, \"Why fall in love, just so you can watch it go away?\"\nHe spends most of his nights wishing it was how it used to be\nHe spends most of his flights getting pulled down by gravity",
    "All this time I didn't know\nYou were breaking down\nI'd fall to pieces on the floor\nIf you weren't around\nToo young to know it gets better\nI'll be summer sun for you forever\nForever winter if you go"
  ],
  "numParagraphs": 2
}

Build docs developers (and LLMs) love

Get started for freeTalk to us