Skip to main content
GET
/
ws
/
1.1
/
matcher.track.get
matcher.track.get
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/matcher.track.get
{
  "message": {
    "body": {
      "track": {
        "album_id": 123,
        "album_name": "<string>",
        "artist_id": 123,
        "artist_name": "<string>",
        "commontrack_id": 123,
        "commontrack_isrcs": [
          [
            "<string>"
          ]
        ],
        "explicit": 123,
        "has_lyrics": 123,
        "has_richsync": 123,
        "has_subtitles": 123,
        "instrumental": 123,
        "num_favourite": 123,
        "primary_genres": {
          "music_genre_list": [
            {
              "music_genre": {
                "music_genre_id": 123,
                "music_genre_name": "<string>",
                "music_genre_name_extended": "<string>",
                "music_genre_parent_id": 123,
                "music_genre_vanity": "<string>"
              }
            }
          ]
        },
        "restricted": 123,
        "track_edit_url": "<string>",
        "track_id": 123,
        "track_isrc": "<string>",
        "track_length": 123,
        "track_lyrics_translation_status": [
          {
            "from": "<string>",
            "perc": 123,
            "to": "<string>"
          }
        ],
        "track_name": "<string>",
        "track_rating": 123,
        "track_share_url": "<string>",
        "track_spotify_id": "<string>",
        "updated_time": "<string>"
      }
    },
    "header": {
      "cached": 123,
      "confidence": 123,
      "execute_time": 123,
      "mode": "<string>",
      "status_code": 123
    }
  }
}
In some cases you already have some information about the track title, artist name, album, etc.
A possible strategy to get the corresponding lyrics could be:
  • search our catalogue with a precise match;
  • try using fuzzy search;
  • try again using artist aliases, and so on.
The matcher.track.get method does all the job for you in a single call. This way you don’t need to worry about details, and you’ll get instant benefits for your application without changing a row in your code, while we take care of improving the implementation behind. Make sure to:

Authorizations

apikey
string
query
required

Query Parameters

q_track
string
required

The song title. Required if the track_isrc is not indicated.

q_artist
string
required

(Optional but recommended parameter) The song artist.

track_isrc
string

(Optional parameter) A valid ISRC identifier. If you have an ISRC ID in your catalogue you can query using this ID only.

Response

200 - application/json

200 OK / 401 Unauthorized

message
object
I