Deezer

Get Deezer track lyrics

Get a track's lyrics with line and word timings, writers, copyright and licence, or none when Deezer shows no lyrics.

GET/v1/deezer/tracks/{trackId}/lyrics
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
trackIdstringrequiredpath

Deezer track id, for example `3135556`.

pattern: ^[1-9]\d{0,11}$

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

datatrackId
integer

The track id asked for.

The lyrics. Null when the track exists but Deezer shows no lyrics for it, and when it is not found.

datalyricstext
stringnullable

The full lyrics as plain text.

Lines synchronised to the audio; empty when Deezer has none.

datalyricslines[]text
string

The line.

datalyricslines[]translation
stringnullable

The line translated, when Deezer supplies a translation.

datalyricslines[]startMs
integernullable

When the line starts, in milliseconds from the start of the track.

datalyricslines[]durationMs
integernullable

How long the line lasts, in milliseconds.

datalyricslines[]timestamp
stringnullable

The line's start as an LRC timestamp such as `[00:12.34]`.

Lines with word-by-word timing; empty when Deezer has none.

datalyricswordTimedLines[]startMs
integernullable

When the line starts, in milliseconds.

datalyricswordTimedLines[]endMs
integernullable

When the line ends, in milliseconds.

The words of the line.

datalyricswordTimedLines[]words[]text
string

The word.

datalyricswordTimedLines[]words[]startMs
integernullable

When the word starts, in milliseconds.

datalyricswordTimedLines[]words[]endMs
integernullable

When the word ends, in milliseconds.

datalyricswriters
stringnullable

Songwriters credited with the lyrics.

datalyricscopyright
stringnullable

Copyright line for the lyrics.

datalyricslicence
stringnullable

The licence under which Deezer shows the lyrics.

datalyricshasSyncedLyrics
booleannullable

Whether Deezer lists synchronised lyrics for the track.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/deezer/tracks/3135556/lyrics" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Lyrics of a Deezer track.