track.search - Musixmatch Pro API documentation

track.search

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

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/track.search?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.search?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.search?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.search?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_list": [
        {
          "track": {
            "album_id": 57933320,
            "album_name": "Greatest Hits (Deluxe)",
            "artist_id": 53952596,
            "artist_name": "Aerosmith",
            "commontrack_id": 160488573,
            "commontrack_isrcs": [
              [
                "USSM19801545"
              ]
            ],
            "explicit": 0,
            "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": 41,
            "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/Aerosmith-1/I-Don-t-Want-To-Miss-A-Thing-From-Armageddon-Soundtrack/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_id": 260269361,
            "track_isrc": "USSM19801545",
            "track_length": 297,
            "track_lyrics_translation_status": [
              {
                "from": "en",
                "perc": 1,
                "to": "de"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "id"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "it"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "pt"
              },
              {
                "from": "en",
                "perc": 0.94,
                "to": "ru"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "es"
              }
            ],
            "track_name": "I Don't Want To Miss A Thing (From \"Armageddon\" Soundtrack)",
            "track_rating": 80,
            "track_share_url": "https://www.musixmatch.com/lyrics/Aerosmith-1/I-Don-t-Want-To-Miss-A-Thing-From-Armageddon-Soundtrack?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_spotify_id": "2gYo5RNzC9ygAh4yeizypt",
            "updated_time": "2025-02-12T10:51:30Z"
          }
        }
      ]
    },
    "header": {
      "available": 497,
      "execute_time": 0.02690601348877,
      "status_code": 200
    }
  }
}

GET

1.1

track.search

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

const options = {method: 'GET'};

fetch('https://api.musixmatch.com/ws/1.1/track.search?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.search?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.search?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.search?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_list": [
        {
          "track": {
            "album_id": 57933320,
            "album_name": "Greatest Hits (Deluxe)",
            "artist_id": 53952596,
            "artist_name": "Aerosmith",
            "commontrack_id": 160488573,
            "commontrack_isrcs": [
              [
                "USSM19801545"
              ]
            ],
            "explicit": 0,
            "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": 41,
            "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/Aerosmith-1/I-Don-t-Want-To-Miss-A-Thing-From-Armageddon-Soundtrack/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_id": 260269361,
            "track_isrc": "USSM19801545",
            "track_length": 297,
            "track_lyrics_translation_status": [
              {
                "from": "en",
                "perc": 1,
                "to": "de"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "id"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "it"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "pt"
              },
              {
                "from": "en",
                "perc": 0.94,
                "to": "ru"
              },
              {
                "from": "en",
                "perc": 1,
                "to": "es"
              }
            ],
            "track_name": "I Don't Want To Miss A Thing (From \"Armageddon\" Soundtrack)",
            "track_rating": 80,
            "track_share_url": "https://www.musixmatch.com/lyrics/Aerosmith-1/I-Don-t-Want-To-Miss-A-Thing-From-Armageddon-Soundtrack?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_spotify_id": "2gYo5RNzC9ygAh4yeizypt",
            "updated_time": "2025-02-12T10:51:30Z"
          }
        }
      ]
    },
    "header": {
      "available": 497,
      "execute_time": 0.02690601348877,
      "status_code": 200
    }
  }
}

Authorizations

apikey

string

query

required

Query Parameters

q_track

string

The song title.

Example:

"Sonne"

q_artist

string

The song artist.

Example:

"Rammstein"

q_lyrics

string

Any word in the lyrics.

q_track_artist

string

Any word in the song title or artist name.

q_writer

string

Search among writers.

string

Any word in the song title or artist name or lyrics.

f_artist_id

string

When set, filters by this artist ID.

f_music_genre_id

string

When set, filters by this music category ID.

f_lyrics_language

string

Filter by the lyrics language (en,it,..).

f_has_lyrics

string

When set (that is, value = 1), only content containing lyrics is returned. Indicating '0' as the value results in returning both tracks with and without lyrics.

f_has_subtitle

string

When set (that is, value = 1), only content containing synced lyrics (subtitles) is returned.

f_has_richsync

string

When set (that is, value = 1), only content containing word-level synced lyrics (richsync) is returned.

f_has_lyrics_analysis

enum<string>

Filter by lyrics analysis availability. Accepts 0, 1, true, or false. When true/1, returns only tracks with lyrics analysis available. When false/0, returns only tracks without lyrics analysis.

Available options:

0,

1,

true,

false

f_track_release_group_first_release_date_min

string

When set, filters the tracks with the release date newer than the indicated value, the format is YYYYMMDD.

f_track_release_group_first_release_date_max

string

When set, filters the tracks with the release date older than the indicated value, the format is YYYYMMDD.

s_artist_rating

string

Sort by our popularity index for artists (asc|desc).

Example:

"desc"

s_track_rating

string

Sort by our popularity index for tracks (asc|desc).

Example:

"desc"

page

string

Define the page number for paginated results.

Example:

"1"

page_size

string

Define the page size for paginated results. The allowed range is 1 to 100.

Example:

"3"

Response

200 - application/json

200 OK / 401 Unauthorized

message

object

Show child attributes