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?apikey='
{ "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

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

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

​
message
object