Skip to main content
GET
Matches a song against Rocksky’s music database and external metadata providers to resolve the best canonical track, artist, and album

Query Parameters

title
string
required

The title of the song to retrieve

artist
string
required

The artist of the song to retrieve

album
string

Optional album title — candidates whose album matches it (case-insensitive) are preferred, so remaster/live/single editions don't shadow the intended release

mbId
string

Optional MusicBrainz recording ID to anchor the match

isrc
string

Optional International Standard Recording Code (ISRC) to anchor the match

Response

Success

id
string

The unique identifier of the song.

title
string

The title of the song.

artist
string

The artist of the song.

albumArtist
string

The artist of the album the song belongs to.

albumArt
string<uri> | null

The URL of the album art image.

uri
string | null

The URI of the song.

album
string

The album of the song.

duration
integer

The duration of the song in milliseconds.

trackNumber
integer | null

The track number of the song in the album.

discNumber
integer | null

The disc number of the song in the album.

playCount
integer

The number of times the song has been played.

Required range: x >= 0
likesCount
integer

The number of users who have loved this song.

Required range: x >= 0
liked
boolean

Whether the authenticated user has loved this song. False when unauthenticated.

uniqueListeners
integer

The number of unique listeners who have played the song.

Required range: x >= 0
albumUri
string | null

The URI of the album the song belongs to.

artistUri
string | null

The URI of the artist of the song.

sha256
string

The SHA256 hash of the song.

mbid
string

The MusicBrainz ID of the song.

isrc
string | null

The International Standard Recording Code (ISRC) of the song.

tags
string[]
createdAt
string<date-time>

The timestamp when the song was created.

artists
object[]
firstScrobble
object

The first scrobble of this song on Rocksky.

matches
object[]

Ranked list of candidate matches from external metadata providers (e.g. Deezer). Additive field returned by matchSong; may be empty.

mbId
string | null

The MusicBrainz recording ID of the track, when available.

updatedAt
string
releaseDate
string | null
year
integer | null
artistPicture
string | null
genres
string[] | null
mbArtists
object[] | null
lyrics
string | null
composer
string | null
genre
string | null
label
string | null
key
string | null
acoustidFingerprint
string | null
xataVersion
integer | null
bpm
number | null

Production returns a nullable floating-point number. Lexicon has no float primitive; retained as an open extension without changing response data.