---
title: "matcher.lyrics.get"
method: GET
path: "/ws/1.1/matcher.lyrics.get"
tags: ["Matcher"]
---

# matcher.lyrics.get

`GET /ws/1.1/matcher.lyrics.get`

Get the lyrics for a track based on title and artist.

## Query parameters

- `q_track` string, required
- `q_artist` string, required
- `track_isrc` string

## Response `200`

200 OK / 401 Unauthorized / 404 Not Found

- object
  - `message` object
    - `body` union
      - object
        - `lyrics` object
          - `explicit` number
          - `lyrics_body` string
          - `lyrics_copyright` string
          - `lyrics_id` number
          - `lyrics_language` string
          - `pixel_tracking_url` string
          - `region_restriction` object
            - `allowed` string[]
            - `blocked` unknown[]
              - …
          - `script_tracking_url` string
          - `updated_time` string
      - unknown[]
        - unknown
      - unknown[]
        - unknown
    - `header` object
      - `execute_time` number
      - `status_code` number

---

[API](https://skmtc.net/musixmatch/apis/lyrics-api.md) · [All operations](https://skmtc.net/musixmatch/apis/lyrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musixmatch/lyrics-api/revisions/edbc169d5499/schema)