track.subtitle.get - Musixmatch Pro API documentation

track.subtitle.get

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

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/track.subtitle.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/track.subtitle.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/track.subtitle.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))

}

require 'uri'
require 'net/http'

url = URI("https://api.musixmatch.com/ws/1.1/track.subtitle.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": {
      "subtitle": {
        "lyrics_copyright": "Writer(s): David Hodges, Christina Judith Perri\nCopyright: Hipgnosis Sfh I Limited, Hifi Music Ip Issuer L.p.\nLyrics powered by www.musixmatch.com",
        "pixel_tracking_url": "https://tracking.musixmatch.com/t1.0/m_img/e_0/sn_0/l_0/su_37431314/rs_0/tr_3vUCAAoV_52DftIDaNbciR9xrAHn0HeI-jSrVzlMxET5BJKVZ0njx0DLFm0Rutsrj5K2WqHwl6GzWB-Mn6VHVTiO-xDvwguiKOVek6ALFB3-9MuJEtxyYpHcR6g_8S35NjKBazuImmKKx3sLZ7UZonZyvI6RCFLVhdLsqg3tZfDOdiFJ-az6FrIThBNt6dnxUVs788ecKM4gmDd6UkbNlna2I8pRks-6jP8AtBJerAPX-Nb9PGDdMRD31xqPtwRMXmTebZAEHXbUzLEHnkt5YcUorDAkvzoT1ZZAhbF-Aegm3OTBL2JyQDi8W1_AV6pCwlDQB2QrMTVQolo4AyooAvzbWb6eDLL-hw_-UmfTcVCGxKcJGid_tx6zkOx27u-ykqtIJc2BHlxb2jZLb82Th6tkaM8cF62ZOgWtC9j_vNBLbYeLXeH5OvxJN6MgyBK-OwVJucsMK6Tl/",
        "script_tracking_url": "https://tracking.musixmatch.com/t1.0/m_js/e_0/sn_0/l_0/su_37431314/rs_0/tr_3vUCADfOKNf0zISthL5vj60wv7yZZuP8il7dWIF8k8ORWpJ8Ad9VWWpwLvnJQy_DKefT4bnAiX25VIo_aa8NMpg9zOkBXYF-hjpXXZa1LtFwFLuz_P-4jcUf7BaHw-TXY3D0UAiuxpPBhfDawIk0wrgT9EYik3EfsffOx3ooKL8KfR0PqnjLUIhYrMhsimSdj7vErdTWNLpcEJhPfrRG3ebDmz07yHfFX0y-2nLcVYwZ60c8mpDbm1Xoi1TR76O0zVxtJZhuSW30sPmXJdEI-cUBwxlfNxN0TQj83wBUh6h5cKYggmTTW_-NvU9F2w96ONNJVDILt1_zIYJkl-YfY2ntc4J5mlUMwDw2wmq5k_rYt-Ijmsx_0GkOyyHlDVgc5iVuOQE6Nv6C44JiEAbsjPsukvttSBoCBv4kksba4ZH8UYZ0X4e2Mp7bSYf6rXrcjf-QJtK1lfmz/",
        "subtitle_body": "[00:32.58] Heart beats fast\n[00:40.19] Colors and promises\n[00:44.50] How to be brave?\n[00:47.12] How can I love when I'm afraid to fall?\n[00:53.33] But watching you stand alone\n[01:00.22] All of my doubt suddenly goes away somehow\n[01:08.81] One step closer\n[01:16.20] I have died every day waiting for you\n[01:22.67] Darling, don't be afraid\n[01:25.66] I have loved you for a thousand years\n[01:31.35] I'll love you for a thousand more\n[01:43.42] Time stands still\n[01:47.37] Beauty in all she is\n[01:52.42] I will be brave\n[01:54.73] I will not let anything take away\n[02:03.24] What's standing in front of me\n[02:08.05] Every breath, every hour has come to this\n[02:17.01] One step closer\n[02:24.26] I have died every day waiting for you\n[02:29.39] Darling, don't be afraid\n[02:32.53] I have loved you for a thousand years\n[02:38.77] I'll love you for a thousand more\n[02:45.75] And all along I believed I would find you\n[02:51.29] Time has brought your heart to me\n[02:53.93] I have loved you for a thousand years\n[03:00.16] I'll love you for a thousand more\n[03:01.87] One step closer\n[03:02.55] One step closer\n[03:02.96] I have died every day waiting for you\n[03:03.41] Darling, don't be afraid\n[03:04.07] I have loved you for a thousand years\n[03:04.53] I'll love you for a thousand more\n[03:05.00] And all along I believed I would find you\n[03:06.07] Time has brought your heart to me\n[03:06.55] I have loved you for a thousand years\n[03:06.82] I'll love you for a thousand more\n[03:07.11] ",
        "subtitle_id": 37431314,
        "subtitle_language": "en",
        "subtitle_language_description": "English",
        "subtitle_length": 187,
        "updated_time": "2023-02-28T06:59:24Z"
      }
    },
    "header": {
      "execute_time": 0.26314902305603,
      "instrumental": 0,
      "status_code": 200
    }
  }
}

GET

1.1

track.subtitle.get

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

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/track.subtitle.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/track.subtitle.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/track.subtitle.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))

}

require 'uri'
require 'net/http'

url = URI("https://api.musixmatch.com/ws/1.1/track.subtitle.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": {
      "subtitle": {
        "lyrics_copyright": "Writer(s): David Hodges, Christina Judith Perri\nCopyright: Hipgnosis Sfh I Limited, Hifi Music Ip Issuer L.p.\nLyrics powered by www.musixmatch.com",
        "pixel_tracking_url": "https://tracking.musixmatch.com/t1.0/m_img/e_0/sn_0/l_0/su_37431314/rs_0/tr_3vUCAAoV_52DftIDaNbciR9xrAHn0HeI-jSrVzlMxET5BJKVZ0njx0DLFm0Rutsrj5K2WqHwl6GzWB-Mn6VHVTiO-xDvwguiKOVek6ALFB3-9MuJEtxyYpHcR6g_8S35NjKBazuImmKKx3sLZ7UZonZyvI6RCFLVhdLsqg3tZfDOdiFJ-az6FrIThBNt6dnxUVs788ecKM4gmDd6UkbNlna2I8pRks-6jP8AtBJerAPX-Nb9PGDdMRD31xqPtwRMXmTebZAEHXbUzLEHnkt5YcUorDAkvzoT1ZZAhbF-Aegm3OTBL2JyQDi8W1_AV6pCwlDQB2QrMTVQolo4AyooAvzbWb6eDLL-hw_-UmfTcVCGxKcJGid_tx6zkOx27u-ykqtIJc2BHlxb2jZLb82Th6tkaM8cF62ZOgWtC9j_vNBLbYeLXeH5OvxJN6MgyBK-OwVJucsMK6Tl/",
        "script_tracking_url": "https://tracking.musixmatch.com/t1.0/m_js/e_0/sn_0/l_0/su_37431314/rs_0/tr_3vUCADfOKNf0zISthL5vj60wv7yZZuP8il7dWIF8k8ORWpJ8Ad9VWWpwLvnJQy_DKefT4bnAiX25VIo_aa8NMpg9zOkBXYF-hjpXXZa1LtFwFLuz_P-4jcUf7BaHw-TXY3D0UAiuxpPBhfDawIk0wrgT9EYik3EfsffOx3ooKL8KfR0PqnjLUIhYrMhsimSdj7vErdTWNLpcEJhPfrRG3ebDmz07yHfFX0y-2nLcVYwZ60c8mpDbm1Xoi1TR76O0zVxtJZhuSW30sPmXJdEI-cUBwxlfNxN0TQj83wBUh6h5cKYggmTTW_-NvU9F2w96ONNJVDILt1_zIYJkl-YfY2ntc4J5mlUMwDw2wmq5k_rYt-Ijmsx_0GkOyyHlDVgc5iVuOQE6Nv6C44JiEAbsjPsukvttSBoCBv4kksba4ZH8UYZ0X4e2Mp7bSYf6rXrcjf-QJtK1lfmz/",
        "subtitle_body": "[00:32.58] Heart beats fast\n[00:40.19] Colors and promises\n[00:44.50] How to be brave?\n[00:47.12] How can I love when I'm afraid to fall?\n[00:53.33] But watching you stand alone\n[01:00.22] All of my doubt suddenly goes away somehow\n[01:08.81] One step closer\n[01:16.20] I have died every day waiting for you\n[01:22.67] Darling, don't be afraid\n[01:25.66] I have loved you for a thousand years\n[01:31.35] I'll love you for a thousand more\n[01:43.42] Time stands still\n[01:47.37] Beauty in all she is\n[01:52.42] I will be brave\n[01:54.73] I will not let anything take away\n[02:03.24] What's standing in front of me\n[02:08.05] Every breath, every hour has come to this\n[02:17.01] One step closer\n[02:24.26] I have died every day waiting for you\n[02:29.39] Darling, don't be afraid\n[02:32.53] I have loved you for a thousand years\n[02:38.77] I'll love you for a thousand more\n[02:45.75] And all along I believed I would find you\n[02:51.29] Time has brought your heart to me\n[02:53.93] I have loved you for a thousand years\n[03:00.16] I'll love you for a thousand more\n[03:01.87] One step closer\n[03:02.55] One step closer\n[03:02.96] I have died every day waiting for you\n[03:03.41] Darling, don't be afraid\n[03:04.07] I have loved you for a thousand years\n[03:04.53] I'll love you for a thousand more\n[03:05.00] And all along I believed I would find you\n[03:06.07] Time has brought your heart to me\n[03:06.55] I have loved you for a thousand years\n[03:06.82] I'll love you for a thousand more\n[03:07.11] ",
        "subtitle_id": 37431314,
        "subtitle_language": "en",
        "subtitle_language_description": "English",
        "subtitle_length": 187,
        "updated_time": "2023-02-28T06:59:24Z"
      }
    },
    "header": {
      "execute_time": 0.26314902305603,
      "instrumental": 0,
      "status_code": 200
    }
  }
}

At least one of the query parameters must be indicated: commontrack_id, track_id, or track_isrc. 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

commontrack_id

string

The Musixmatch commontrack ID.

Example:

"10074988"

track_id

string

The Musixmatch track ID.

Example:

"274345545"

track_isrc

string

A valid ISRC identifier.

Example:

"USAT21102141"

track_spotify_id

string

A Spotify ID.

Example:

"5TfzrLmEHCDULQwnNbkSTZ"

track_itunes_id

string

An Apple Music ID.

Example:

"1721054885"

subtitle_format

string

The format of the subtitle (lrc, dfxp, mxm). Default to 'lrc', use 'mxm' for getting the subtitle as a json string.

Example:

"lrc"

f_subtitle_length

string

The desired length of the subtitle (seconds).

Example:

"188"

f_subtitle_length_max_deviation

string

The maximum deviation allowed from the f_subtitle_length (seconds).

Example:

"2"

Response

200 - application/json

200 OK / 401 Unauthorized / 404 Not Found

message

object

Show child attributes