Sections

API Methods

Input Parameters

Use UTF-8 to encode arguments. These are the supported input parameters:

Authentication

apikey
Your personal api key, you must use it in every api call. You can pass this parameter as GET parameter in your api call, like track.get?apikey=xxxx

Objects

track_id
Musixmatch track id
artist_id
Musixmatch artist id
album_id
Musixmatch album id
commontrack_id
Musixmatch commontrack id
track_mbid
musicbrainz recording or track id
artist_mbid
musicbrainz artist id
album_mbid
musicbrainz release id

Querying

q_track
search for a text string among song titles
q_artist
search for a text string among artist names
q_lyrics
search for a text string among lyrics
q
search for a text string among song titles,artist names and lyrics

Filtering

f_has_lyrics
Filter by objects with available lyrics
f_is_instrumental
Filter instrumental songs
f_has_subtitle
Filter by objects with available subtitles
f_music_genre_id
Filter by objects with a specific music category
f_subtitle_length
Filter subtitles by a given duration in seconds
f_subtitle_length_max_deviation
Apply a deviation to a given subtitle duration (in seconds)
f_lyrics_language
Filter the tracks by lyrics language
f_artist_id
Filter by objects with a given Musixmatch artist_id
f_artist_mbid
Filter by objects with a given musicbrainz artist id

Grouping

g_commontrack
Group a track result set by commontrack_id

Sorting

s_track_rating
Sort the results by our popularity index for tracks, possible values are ASC | DESC
s_track_release_date
Sort the results by track release date, possible values are ASC | DESC
s_artist_rating
Sort the results by our popularity index for artists, possible values are ASC | DESC

Result Set Pagination

page
Request specific result page (default=1)
page_size
Specify number of items per result page (default=10, range is 1 to 100)

Output Format

subtitle_format
Desired output format for the subtitle body. Possible values LRC|DFXP|STLEDU. Default to LRC.

Localization

country
The country code of the desired country.