matcher.track.get

curl --request GET \
  --url 'https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey='

import requests

url = "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey="

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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,
        "has_lyrics_crowd": 0,
        "has_track_structure": 0,
        "has_lyrics_analysis": 0,
        "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
    }
  }
}

GET

1.1

matcher.track.get

curl --request GET \
  --url 'https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey='

import requests

url = "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey="

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.musixmatch.com/ws/1.1/matcher.track.get?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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,
        "has_lyrics_crowd": 0,
        "has_track_structure": 0,
        "has_lyrics_analysis": 0,
        "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:

fulfill the country restrictions you receive for every copyrighted content;
apply the tracking method of your choice.

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

Show child attributes

matcher.subtitle.get music.genres.get

⌘I