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