GET
/
ws
/
1.1
/
chart.tracks.get
chart.tracks.get
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/chart.tracks.get
{
  "message": {
    "body": {
      "track_list": [
        {
          "track": {
            "album_coverart_100x100": "http://s.mxmcdn.net/images-storage/albums/nocover.png",
            "album_coverart_350x350": "",
            "album_coverart_500x500": "",
            "album_coverart_800x800": "",
            "album_id": 73686383,
            "album_name": "LA CURA PER ME",
            "artist_id": 27281,
            "artist_name": "Giorgia",
            "commontrack_id": 197057308,
            "commontrack_isrcs": [
              [
                "ITB002500020"
              ]
            ],
            "explicit": 1,
            "has_lyrics": 1,
            "has_richsync": 0,
            "has_subtitles": 1,
            "instrumental": 0,
            "num_favourite": 2,
            "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/Giorgia/LA-CURA-PER-ME/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_id": 320191377,
            "track_isrc": "ITB002500020",
            "track_length": 216,
            "track_lyrics_translation_status": [
              {
                "from": "it",
                "perc": 1,
                "to": "fr"
              },
              {
                "from": "it",
                "perc": 1,
                "to": "es"
              }
            ],
            "track_name": "LA CURA PER ME",
            "track_rating": 81,
            "track_share_url": "https://www.musixmatch.com/lyrics/Giorgia/LA-CURA-PER-ME?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950",
            "track_spotify_id": "5tOBPD3zL9kWpeELqkzwJC",
            "updated_time": "2025-02-12T00:55:45Z"
          }
        }
      ]
    },
    "header": {
      "execute_time": 0.01645302772522,
      "status_code": 200
    }
  }
}

Authorizations

​
apikey
string
query
required

Query Parameters

​
country
string

A valid two-letter country code. Use 'XW' for worldwide with all the supported chart names, except 'top'. The default value is US.

Example:

"it"

​
chart_name
string

Select from the available charts:

  • top: editorial chart;
  • hot: most viewed lyrics in the last 2 hours;
  • mxmweekly: most viewed lyrics in the last 7 days;
  • mxmweekly_new: most viewed lyrics in the last 7 days, limited to new releases only.
Example:

"top"

​
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.

Example:

"1"

​
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:

"5"

Response

200 - application/json

200 OK / 401 Unauthorized

The response is of type object.