Charts
chart.tracks.get
Introduction
Track
Charts
chart.tracks.get
Get the list of the top songs for a given country.
GET
/
ws
/
1.1
/
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
Query Parameters
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"
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"
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"
Define the page number for paginated results.
Example:
"1"
Define the page size for paginated results. The allowed range is 1 to 100.
Example:
"5"
Response
200 - application/json
200 OK / 401 Unauthorized
Example:
"http://s.mxmcdn.net/images-storage/albums/nocover.png"
Example:
""
Example:
""
Example:
""
Example:
73686383
Example:
"LA CURA PER ME"
Example:
27281
Example:
"Giorgia"
Example:
197057308
Example:
[["ITB002500020"]]
Example:
1
Example:
1
Example:
0
Example:
1
Example:
0
Example:
2
Example:
0
Example:
"https://www.musixmatch.com/lyrics/Giorgia/LA-CURA-PER-ME/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950"
Example:
320191377
Example:
"ITB002500020"
Example:
216
Example:
[
{ "from": "it", "perc": 1, "to": "fr" },
{ "from": "it", "perc": 1, "to": "es" }
]
Example:
"LA CURA PER ME"
Example:
81
Example:
"https://www.musixmatch.com/lyrics/Giorgia/LA-CURA-PER-ME?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950"
Example:
"5tOBPD3zL9kWpeELqkzwJC"
Example:
"2025-02-12T00:55:45Z"
Example:
[
{
"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"
}
}
]
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
}
}
}