Skip to main content
GET
/
ws
/
1.1
/
track.subtitle.translation.get
track.subtitle.translation.get
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/track.subtitle.translation.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,
        "subtitle_translated": {
          "html_tracking_url": "<string>",
          "pixel_tracking_url": "<string>",
          "restricted": 123,
          "script_tracking_url": "<string>",
          "selected_language": "<string>",
          "subtitle_body": "<string>"
        },
        "updated_time": "<string>"
      }
    },
    "header": {
      "execute_time": 123,
      "hint": "<string>",
      "instrumental": 123,
      "status_code": 123
    }
  }
}
The API will return both the sync and its translation. The sync and its translation will always have the same number of lines, ensuring that each synched line can be easily associated with its translation.
At least one of the query parameters must be indicated: commontrack_id, track_id, or track_isrc. Make sure to:

Authorizations

​
apikey
string
query
required

Query Parameters

​
commontrack_id
string

The Musixmatch commontrack ID.

​
track_id
string

The Musixmatch track ID.

​
selected_language
string
required

The language of the translated lyrics (ISO 639-1).

​
min_completed
string

The allowed range is from 0 to 1. If present, only tracks with a translation ratio above this value for a given language will be returned. E.g., set it to 1 for fully completed translation, or to 0.7 for at least 70% translation completion.

​
f_subtitle_length
string

The desired length of the subtitle (seconds).

​
f_subtitle_length_max_deviation
string

The maximum deviation allowed from the f_subtitle_length (seconds).

​
track_isrc
string

A valid ISRC identifier.

Response

200 - application/json

200 OK / 400 Bad Request / 401 Unauthorized / 404 Not Found

​
message
object