Build with community syncs, right in the response.

You get Spicy Lyrics’ whole sync catalogue, community-made syncs included, inline from one endpoint.

Run a request

Your first request needs no account.

What changes for you

  1. You: I keep patching my scraper
  2. You: Every time the markup moves
  3. Spicy Lyrics: Retire it, let it go
  4. Spicy Lyrics: One endpoint, the best sync we've gotCommunity syncs included
  5. You: My snapshot keeps missing tracks
  6. Spicy Lyrics: Your users get broader coverage
  7. You: What if the API changes on me?
  8. Spicy Lyrics: You'll read it in the docs before it ships
  9. You: And when something breaks?
  10. Spicy Lyrics: You've got a person to @

One endpoint gives you the best sync available.

The hierarchy picks the source for you. Branch on the source field and it tells you exactly who to credit.

  1. 1Community syncMade by people, usually the most precise.
  2. 2Apple MusicIf it has the sync type requested and the track.
  3. 3SpotifyOtherwise.

Apple Music and Spotify are decided together: a word-level sync from one beats a line-level sync from the other. How sources are chosen

GET /v1/lyrics/1QV6tiMFM6fSOKOGLMHYYg200
{
  "Body": {
    "Type": "Syllable",
    "SongWriters": ["Stefani Joanne Angelina Germanotta", "Nādir Ḵayyāṭ"],
    "StartTime": 7.357,
    "Content": [...],
    "EndTime": 234.731,
    "id": "1QV6tiMFM6fSOKOGLMHYYg",
    "UploadAttribution": {
      "Uploader": {
        "id": "790942393255329803",
        "username": "spikerko",
        "avatar": "https://cdn.discordapp.com/avatars/790942393255329803/bb0b32161c04dc75bd06a39f13718a44.webp?size=256",
        "hasProfileBanner": true,
        "url": "https://spicylyrics.org/uid/790942393255329803"
      },
      "Maker": {
        "id": "816650334255579137",
        "username": "gc",
        "avatar": "https://cdn.discordapp.com/avatars/816650334255579137/03ec15a143788b3ba3f2549982c2b0ab.webp?size=256",
        "hasProfileBanner": false,
        "url": "https://spicylyrics.org/uid/816650334255579137"
      }
    },
    "source": "spicy_lyrics"
  },
  "Status": 200,
  "Type": "object"
}

What you display under the lyrics

Lyrics from Spicy Lyrics · uploaded by spikerko, made by gc

A community sync exists for this track, so it wins outright.

Your key is a few seconds away.

Create an application and your secret key is ready straight away. You see it once, so keep it on a server you control.

Create an applicationRead the docs