Pages

API Methods

Partnerships

Musixmatch SDKs

Community SDKs

TRACK.SUBTITLE.GET

Retreive the subtitle of a track.

Return the subtitle of a track in LRC or DFXP format.
Refer to Wikipedia LRC format page or DFXP format on W3c for format specifications.

Parameters

commontrack_id
The Musixmatch commontrack id
subtitle_format
The format of the subtitle (lrc,dfxp,stledu). Default to lrc
f_subtitle_length
The desired length of the subtitle (seconds)
f_subtitle_length_max_deviation
The maximum deviation allowed from the f_subtitle_length (seconds)

Authentication

This method requires authentication with api key and a commercial plan.

How can I get a list of tracks having subtitles?

When you call track.search or any method that supports filtering, you can add f_has_subtitle=1 to your request. See Input Parameters for details.

Examples

Get a subtitle in LRC format.
Request
Get a subtitle in LRC format for A Thousand Years Christina Perri
track.subtitle.get?commontrack_id=10074988
Json Response
{
  "message": {
    "header": {
      "status_code": 200,
      "execute_time": 0.0058
    },
    "body": {
      "subtitle": {
        "subtitle_id": 18116,
        "restricted": 0,
        "subtitle_body": "[00:20.51] Heart beats fast
[00:24.09] Colors and promises
[00:25.95] How to be brave?
[00:32.03] How can I love when I'm afraid to fall?
        "subtitle_language": "en",
        "script_tracking_url": "http:\/\/tracking.musixmatch.com\/t1.0\/gs2ObSlxR9vsuyJ9XYRITJw==\/",
        "pixel_tracking_url": "http:\/\/tracking.musixmatch.com\/t1.0\/gs2ObSlxR9vsuGDsbZwOULTQ==\/",
        "html_tracking_url": "http:\/\/tracking.musixmatch.com\/t1.0\/gs2ObSlxR9yR97gQ==\/",
        "lyrics_copyright": "Lyrics powered by www.musiXmatch.com"
      }
    }
  }
}