Skip to main content
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_id": 123,
            "album_name": "<string>",
            "artist_id": 123,
            "artist_name": "<string>",
            "commontrack_id": 123,
            "commontrack_isrcs": [
              [
                "<string>"
              ]
            ],
            "explicit": 123,
            "has_lyrics": 123,
            "has_richsync": 123,
            "has_subtitles": 123,
            "instrumental": 123,
            "num_favourite": 123,
            "primary_genres": {
              "music_genre_list": [
                {
                  "music_genre": {
                    "music_genre_id": 123,
                    "music_genre_name": "<string>",
                    "music_genre_name_extended": "<string>",
                    "music_genre_parent_id": 123,
                    "music_genre_vanity": "<string>"
                  }
                }
              ]
            },
            "restricted": 123,
            "track_edit_url": "<string>",
            "track_id": 123,
            "track_isrc": "<string>",
            "track_length": 123,
            "track_lyrics_translation_status": [
              {
                "from": "<string>",
                "perc": 123,
                "to": "<string>"
              }
            ],
            "track_name": "<string>",
            "track_rating": 123,
            "track_share_url": "<string>",
            "track_spotify_id": "<string>",
            "updated_time": "<string>"
          }
        }
      ]
    },
    "header": {
      "execute_time": 123,
      "status_code": 123
    }
  }
}

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.

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

page
string

Define the page number for paginated results.

page_size
string

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

Response

200 - application/json

200 OK / 401 Unauthorized

message
object
I