Sections

API Methods

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.

Make sure the fullfil the country restriction you recieve within every copyrighted content>

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"
      }
    }
  }
}