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": 51353981,
        "album_name": "This Love (Taylor’s Version)",
        "artist_id": 259675,
        "artist_name": "Taylor Swift",
        "commontrack_id": 133444910,
        "commontrack_isrcs": [
          [
            "USUG12103658"
          ]
        ],
        "explicit": 1,
        "has_lyrics": 1,
        "has_richsync": 1,
        "has_subtitles": 1,
        "instrumental": 0,
        "num_favourite": 167,
        "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/Wildest-Dreams-Taylor-s-Version/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
        "track_id": 235600686,
        "track_isrc": "USUG12103658",
        "track_length": 220,
        "track_lyrics_translation_status": [
          {
            "from": "en",
            "perc": 1,
            "to": "af"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ar"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "zh"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "nl"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "f1"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "fi"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "fr"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "de"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "is"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "id"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "it"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ja"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ko"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "lt"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ms"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "mn"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ne"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "fa"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "pl"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "pt"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "ru"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "es"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "th"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "tr"
          },
          {
            "from": "en",
            "perc": 1,
            "to": "vi"
          }
        ],
        "track_name": "Wildest Dreams (Taylor's Version)",
        "track_rating": 83,
        "track_share_url": "https://www.musixmatch.com/lyrics/Taylor-Swift/Wildest-Dreams-Taylor-s-Version?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
        "track_spotify_id": "1IxeJLsubGTboNN9K5XNfL",
        "updated_time": "2023-11-09T13:22:11Z"
      }
    },
    "header": {
      "cached": 1,
      "confidence": 1000,
      "execute_time": 0.008080005645752,
      "mode": "search",
      "status_code": 200
    }
  }
}
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.

Example:

"Wildest Dreams (Taylor's Version)"

​
q_artist
string
required

(Optional but recommended parameter) The song artist.

Example:

"Taylor Swift"

​
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.

Example:

"USUG12103658"

Response

200 - application/json

200 OK / 401 Unauthorized

The response is of type object.