Skip to main content
GET
/
ws
/
1.1
/
track.lyrics.translation.get
track.lyrics.translation.get
curl --request GET \
  --url https://api.musixmatch.com/ws/1.1/track.lyrics.translation.get
{
  "message": {
    "body": {
      "lyrics": {
        "explicit": 123,
        "lyrics_body": "<string>",
        "lyrics_copyright": "<string>",
        "lyrics_id": 123,
        "lyrics_language": "<string>",
        "lyrics_translated": {
          "html_tracking_url": "<string>",
          "lyrics_body": "<string>",
          "pixel_tracking_url": "<string>",
          "restricted": 123,
          "script_tracking_url": "<string>",
          "selected_language": "<string>"
        },
        "pixel_tracking_url": "<string>",
        "region_restriction": {
          "allowed": [
            "<string>"
          ],
          "blocked": [
            "<any>"
          ]
        },
        "script_tracking_url": "<string>",
        "updated_time": "<string>"
      }
    },
    "header": {
      "execute_time": 123,
      "hint": "<string>",
      "status_code": 123
    }
  }
}
The API will return both the lyrics and its translation. The lyrics and its translation will always have the same number of lines, ensuring that each lyrics line can be easily associated with its translation.
If no translation exists for the indicated ID, the translated lyrics object is empty but other lyrics’ metadata are still returned. 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 translated lyrics or to 0.7 for at least 70% translation completion.

​
track_isrc
string

A valid ISRC identifier.

Response

200 - application/json

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

​
message
object
⌘I