v1

latestOpenAPI 3.0.32026-07-263517334.7 KB

Charts

chart.tracks.get

Get the list of the top songs for a given country.

get/ws/1.1/chart.tracks.get

Query parameters

countrystring

Example:it

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

chart_namestring

Example:top

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.

f_has_lyricsstring

Example:1

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.

pagestring

Example:1

Define the page number for paginated results.

page_sizestring

Example:5

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

Response

200 OK / 401 Unauthorized

Example response

{
  "message": {
    "body": {
      "track_list": [
        {
          "track": {
            "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,
            "has_lyrics_crowd": 0,
            "has_track_structure": 0,
            "has_lyrics_analysis": 0,
            "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
    }
  }
}