Skip to main content
GET
/
ws
/
1.1
/
track.search
track.search
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/track.search
{
  "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": {
      "available": 123,
      "execute_time": 123,
      "status_code": 123
    }
  }
}

Authorizations

apikey
string
query
required

Query Parameters

q_track
string

The song title.

q_artist
string

The song artist.

q_lyrics
string

Any word in the lyrics.

q_track_artist
string

Any word in the song title or artist name.

q_writer
string

Search among writers.

q
string

Any word in the song title or artist name or lyrics.

f_artist_id
string

When set, filters by this artist ID.

f_music_genre_id
string

When set, filters by this music category ID.

f_lyrics_language
string

Filter by the lyrics language (en,it,..).

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.

f_track_release_group_first_release_date_min
string

When set, filters the tracks with the release date newer than the indicated value, the format is YYYYMMDD.

f_track_release_group_first_release_date_max
string

When set, filters the tracks with the release date older than the indicated value, the format is YYYYMMDD.

s_artist_rating
string

Sort by our popularity index for artists (asc|desc).

s_track_rating
string

Sort by our popularity index for tracks (asc|desc).

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