Skip to main content
POST
/
ws
/
1.1
/
track.lyrics.fingerprint.post
track.lyrics.fingerprint.post
curl --request POST \
  --url 'https://api.musixmatch.com/ws/1.1/track.lyrics.fingerprint.post?apikey=' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "data": {
    "text": "Was dressed to the nines And we were dancing, dancing Like we're made of starlight, starlight nLike we're made of starlight, starlight"
  }
}
EOF
{
  "message": {
    "body": {
      "track_list": [
        {
          "similarity": 99.236641221374,
          "track": {
            "album_coverart_100x100": "http://s.mxmcdn.net/images-storage/albums/nocover.png",
            "album_coverart_350x350": "",
            "album_coverart_500x500": "",
            "album_coverart_800x800": "",
            "album_id": 18825722,
            "album_name": "Starlight",
            "artist_id": 24675514,
            "artist_name": "Music Maverick",
            "commontrack_id": 35857643,
            "commontrack_isrcs": [
              [
                "GBW371201379"
              ]
            ],
            "explicit": 0,
            "has_lyrics": 1,
            "has_richsync": 0,
            "has_subtitles": 1,
            "instrumental": 0,
            "num_favourite": 0,
            "primary_genres": {
              "music_genre_list": [
                {
                  "music_genre": {
                    "music_genre_id": 14,
                    "music_genre_name": "Pop",
                    "music_genre_name_extended": "Pop",
                    "music_genre_parent_id": 34,
                    "music_genre_vanity": "Pop"
                  }
                }
              ]
            },
            "restricted": 0,
            "track_edit_url": "https://www.musixmatch.com/lyrics/Music-Maverick/Starlight/edit?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_id": 35857643,
            "track_isrc": "GBW371201379",
            "track_length": 0,
            "track_name": "starlight",
            "track_rating": 1,
            "track_share_url": "https://www.musixmatch.com/lyrics/Music-Maverick/Starlight?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_spotify_id": "",
            "updated_time": "2015-07-08T21:06:21Z"
          }
        },
        {
          "similarity": 99.236641221374,
          "track": {
            "album_coverart_100x100": "http://s.mxmcdn.net/images-storage/albums/nocover.png",
            "album_coverart_350x350": "",
            "album_coverart_500x500": "",
            "album_coverart_800x800": "",
            "album_id": 47387431,
            "album_name": "Red (Taylor's Version)",
            "artist_id": 259675,
            "artist_name": "Taylor Swift",
            "commontrack_id": 135756858,
            "commontrack_isrcs": [
              [
                "USUG12103675"
              ]
            ],
            "explicit": 0,
            "has_lyrics": 1,
            "has_richsync": 1,
            "has_subtitles": 1,
            "instrumental": 0,
            "num_favourite": 16,
            "primary_genres": {
              "music_genre_list": [
                {
                  "music_genre": {
                    "music_genre_id": 14,
                    "music_genre_name": "Pop",
                    "music_genre_name_extended": "Pop",
                    "music_genre_parent_id": 34,
                    "music_genre_vanity": "Pop"
                  }
                }
              ]
            },
            "restricted": 0,
            "track_edit_url": "https://www.musixmatch.com/lyrics/Taylor-Swift/Starlight-Taylor-s-Version/edit?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_id": 135756858,
            "track_isrc": "USUG12103675",
            "track_length": 0,
            "track_name": "starlight (taylor's version)",
            "track_rating": 60,
            "track_share_url": "https://www.musixmatch.com/lyrics/Taylor-Swift/Starlight-Taylor-s-Version?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_spotify_id": "7A2cNLRT0YJc1yjxHlKihs",
            "updated_time": "2021-11-16T05:26:09Z"
          }
        },
        {
          "similarity": 99.236641221374,
          "track": {
            "album_coverart_100x100": "http://s.mxmcdn.net/images-storage/albums/nocover.png",
            "album_coverart_350x350": "",
            "album_coverart_500x500": "",
            "album_coverart_800x800": "",
            "album_id": 23569539,
            "album_name": "The Cabin Light Inside The Spaceship",
            "artist_id": 24587516,
            "artist_name": "Dave Johnson",
            "commontrack_id": 61388415,
            "commontrack_isrcs": [
              [
                "USCGH0834928",
                "USX9P2302319"
              ]
            ],
            "explicit": 0,
            "has_lyrics": 1,
            "has_richsync": 0,
            "has_subtitles": 1,
            "instrumental": 0,
            "num_favourite": 0,
            "primary_genres": {
              "music_genre_list": [
                {
                  "music_genre": {
                    "music_genre_id": 7,
                    "music_genre_name": "Electronic",
                    "music_genre_name_extended": "Electronic",
                    "music_genre_parent_id": 34,
                    "music_genre_vanity": "Electronic"
                  }
                }
              ]
            },
            "restricted": 0,
            "track_edit_url": "https://www.musixmatch.com/lyrics/Dave-Johnson-2/Scrambled-Meggs/edit?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_id": 61388415,
            "track_isrc": "USCGH0834928",
            "track_length": 0,
            "track_name": "scrambled meggs",
            "track_rating": 1,
            "track_share_url": "https://www.musixmatch.com/lyrics/Dave-Johnson-2/Scrambled-Meggs?utm_source=application&utm_campaign=api&utm_medium=individual%3A1409626377500",
            "track_spotify_id": "3KEUSpjt8wW3lpXb8LQqeG",
            "updated_time": "2019-04-15T00:48:17Z"
          }
        }
      ]
    },
    "header": {
      "execute_time": 0.10180687904358,
      "status_code": 200
    }
  }
}
Use this API to screen any text for potential lyrical content. This service is designed for digital platforms, especially those implementing generative AI, to automatically identify potential copyright concerns in user-generated content. The API supports the submission of any text string, returning a ranked list of track matches with corresponding similarity scores.

Authorizations

​
apikey
string
query
required

Query Parameters

​
size
string

Set the scope of the search to a specific number of lyric candidates (max 20)

Example:

"10"

​
limit
string

Number of track items in the response (max related to size param)

Example:

"3"

Body

application/json
​
data
object

Response

200 - application/json

200 OK / 400 Bad Request / 403 Forbidden

​
message
object