Sections

API Methods

matcher.subtitle.get

Get the subtitles for a song given his title,artist and duration.

You can use the f_subtitle_length_max_deviation to fetch subtitles within a given duration range.

IMPORTANT NOTICE

You have to include in your page/application one of the two available tracking system:

1. Javascript script for web sites

Include the url returned into the field script_tracking_url as a script:

<script type="text/javascript" src="http://tracking.musixmatch.com/t1.0/AMa6hJCIEzn1v8RuOP">

2. Image pixel

Include the url returned into the field pixel_tracking_url as an image src when it’s not possible to use the script:

<img src="http://tracking.musixmatch.com/t1.0/AMa6hJCIEzn1v8RuXW">

Furthermore, every time a subtitle is present in a page the lyrics_copyright field must also be clearly visible.

Parameters

q_track
The song title
q_artist
The song artist
f_subtitle_length
Filter by subtitle length in seconds
f_subtitle_length_max_deviation
Max deviation for a subtitle length in seconds
track_isrc
If you have an available isrc id in your catalogue you can query using this id only (optional)

Authentication

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

Examples

Get the subtitles for Sexy and I know it from LMFAO
Request
Get the subtitles for a song/video with title Sexy and I know it and artist LMFAO of length 200 seconds with approximation of 3 seconds
matcher.subtitle.get?q_track=sexy%20and%20i%20know%20it&q_artist=lmfao&
f_subtitle_length=200&f_subtitle_length_max_deviation=3
XML Response
<?xml version="1.0" encoding="utf-8"?>
<message>
  <header>
    <status_code>200</status_code>
    <execute_time>0.064241886138916</execute_time>
  </header>
  <body>
    <subtitle>
      <subtitle_id>28141</subtitle_id>
      <restricted>0</restricted>
      <subtitle_body>[0:16.12] When I walk on by, girls be looking like damn he fly
[0:19.69] I pay to the beat, walking on the street with in my new lafreak, yeah
[0:23.48] This is how I roll, animal print, pants out control,
... </subtitle_body>
      <subtitle_length>199</subtitle_length>
      <subtitle_language>en</subtitle_language>
      <script_tracking_url>http://tracking.musixmatch.com/t1.0/5RIyfxxrQ==/</script_tracking_url>
      <pixel_tracking_url>http://tracking.musixmatch.com/t1.0/5RIyxx=/</pixel_tracking_url>

      <lyrics_copyright/>
      <updated_time>2012-04-01T21:53:11Z</updated_time>
    </subtitle>
  </body>
</message>