v1
latestOpenAPI 3.0.32026-07-263517334.7 KBMatcher
matcher.track.get
Match your song against our database.
get/ws/1.1/matcher.track.get
Query parameters
q_trackstring required
Example:Wildest Dreams (Taylor's Version)
The song title. Required if the track_isrc is not indicated.
q_artiststring required
Example:Taylor Swift
The song artist. Required if the track_isrc is not indicated.
track_isrcstring
Example:USUG12103658
(Optional parameter) A valid ISRC identifier. If you have an ISRC ID in your catalogue you can query using this ID only.
Response
200 OK / 401 Unauthorized
Example response
{
"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,
"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"
}
}
]
},
"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
}
}
}