Skip to main content
GET
/
ws
/
1.1
/
matcher.subtitle.get
matcher.subtitle.get
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/matcher.subtitle.get
{
  "message": {
    "body": {
      "subtitle": {
        "lyrics_copyright": "<string>",
        "pixel_tracking_url": "<string>",
        "region_restriction": {
          "allowed": [
            "<string>"
          ],
          "blocked": [
            "<any>"
          ]
        },
        "script_tracking_url": "<string>",
        "subtitle_body": "<string>",
        "subtitle_id": 123,
        "subtitle_language": "<string>",
        "subtitle_language_description": "<string>",
        "subtitle_length": 123,
        "updated_time": "<string>"
      }
    },
    "header": {
      "execute_time": 123,
      "status_code": 123
    }
  }
}
You can use the ‘f_subtitle_length_max_deviation’ to fetch syncs within the given duration range. Make sure to:

Authorizations

apikey
string
query
required

Query Parameters

q_track
string
required

The song title. Required if the track_isrc is not indicated.

q_artist
string
required

(Optional but recommended parameter) The song artist.

f_subtitle_length
string

Filter by sync length in seconds. For it to function, must be used together with the 'f_subtitle_length_max_deviation' parameter.

f_subtitle_length_max_deviation
string

Max deviation for a sync length in seconds.

track_isrc
string

(Optional parameter) If you have an available ISRC ID in your catalogue you can query using this ID only.

Response

200 - application/json

200 OK / 401 Unauthorized

message
object
I