Musixmatch Lyrics API

https://docs.musixmatch.com/
Admin
The Musixmatch Lyrics API provides access to Musixmatch metadata about songs and lyrics, enabling...
Tokens:114,995
Snippets:619
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### Track Get API Response Examples

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-get

These examples demonstrate the structure of the API response for successful requests and common error scenarios.

```yaml
example: 200
              examples:
                200 OK:
                  value:
                    message:
                      body:
                        track:
                          album_id: 20915188
                          album_name: The Fame Monster (UK Deluxe)
                          artist_id: 378462
                          artist_name: Lady Gaga
                          commontrack_id: 5920049
                          commontrack_isrcs:
                            - - USUM70905526
                              - USUM71012484
                              - USA561015880
                              - GBJUT0922769
                              - USUM71009889
                              - SEYOK1607797
                          explicit: 0
                          has_lyrics: 1
                          has_richsync: 1
                          has_subtitles: 1
                          has_lyrics_crowd: 0
                          has_track_structure: 0
                          has_lyrics_analysis: 0
                          instrumental: 0
                          num_favourite: 7227
                          primary_genres:
                            music_genre_list:
                              - music_genre:
                                  music_genre_id: 7
                                  music_genre_name: Electronic
                                  music_genre_name_extended: Electronic
                                  music_genre_parent_id: 34
                                  music_genre_vanity: Electronic
                              - music_genre:
                                  music_genre_id: 14
                                  music_genre_name: Pop
                                  music_genre_name_extended: Pop
                                  music_genre_parent_id: 34
                                  music_genre_vanity: Pop
                              - music_genre:
                                  music_genre_id: 17
                                  music_genre_name: Dance
                                  music_genre_name_extended: Dance
                                  music_genre_parent_id: 34
                                  music_genre_vanity: Dance
                              - music_genre:
                                  music_genre_id: 1205
                                  music_genre_name: Europe
                                  music_genre_name_extended: World / Europe
                                  music_genre_parent_id: 19
                                  music_genre_vanity: World-Europe
                          restricted: 0
                          track_edit_url: >-
                            https://www.musixmatch.com/lyrics/Lady-Gaga/Alejandro/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950
                          track_id: 84584600
                          track_isrc: USUM70905526
                          track_length: 274
                          track_lyrics_translation_status:
                            - from: en
                              perc: 1
                              to: de
                            - from: en
                              perc: 1
                              to: hi
                            - from: en
                              perc: 1
                              to: fi
                          track_name: Alejandro
                          track_rating: 70
                          track_share_url: >-
                            https://www.musixmatch.com/lyrics/Lady-Gaga/Alejandro?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950
                          track_spotify_id: 0iOu4s8w3pE9vbpb1SHXsL
                          updated_time: '2020-02-28T14:11:02Z'
                      header:
                        execute_time: 0.032217025756836
                        status_code: 200
                401 Unauthorized:
                  value:
                    message:
                      body: []
                      header:
                        execute_time: 0.050049781799316
                        status_code: 401
                404 Not Found:
                  value:
                    message:
                      body: []
                      header:
                        execute_time: 0.060256004333496
                        status_code: 404
```

```yaml
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: apikey
      in: query
```

--------------------------------

### Response Header Examples

Source: https://docs.musixmatch.com/enterprises/publishing/work-post

Example values for common HTTP response headers.

```yaml
Connection:
  schema:
    type: string
    example: keep-alive
Content-Encoding:
  schema:
    type: string
    example: gzip
Content-Length:
  schema:
    type: string
    example: '99'
Date:
  schema:
    type: string
    example: Fri, 14 Feb 2025 08:03:01 GMT
Vary:
  schema:
    type: string
    example: Accept-Encoding
x-mxm-cache:
  schema:
    type: string
    example: no-cache
x-mxm-header-execute-time:
  schema:
    type: string
    example: '0.15362906455994'
```

--------------------------------

### Get delivery status API request examples

Source: https://docs.musixmatch.com/enterprises/distribution/api/deliveries/get-delivery-status

Examples of how to perform a GET request to retrieve delivery status using various programming languages and tools.

```bash
curl --request GET \
  --url https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id} \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

url = "https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java
HttpResponse<String> response = Unirest.get("https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Album Get Response Examples

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/album-get

JSON response structures for successful requests and common error codes.

```json
{
  "message": {
    "body": {
      "album": {
        "album_id": 56126508,
        "album_name": "Did you know that there's a tunnel under Ocean Blvd",
        "album_release_date": "2023-03-24",
        "artist_id": 13805436,
        "artist_name": "Lana Del Rey",
        "restricted": 0,
        "updated_time": "2024-08-26T09:08:33Z"
      }
    },
    "header": {
      "execute_time": 0.012861967086792,
      "status_code": 200
    }
  }
}
```

```json
{
  "message": {
    "body": [],
    "header": {
      "execute_time": 0.001737117767334,
      "status_code": 401
    }
  }
}
```

```json
{
  "message": {
    "body": [],
    "header": {
      "execute_time": 0.0082499980926514,
      "status_code": 404
    }
  }
}
```

--------------------------------

### GET /ws/1.1/matcher.subtitle.get

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/matcher-subtitle-get

Get the syncs for a song given its title, artist and duration.

```APIDOC
## GET /ws/1.1/matcher.subtitle.get

### Description
Get the syncs for a song given its title, artist and duration.

### Method
GET

### Endpoint
/ws/1.1/matcher.subtitle.get

### Parameters
#### Query Parameters
- **q_track** (string) - Required - The song title. Required if the track_isrc is not indicated.
- **q_artist** (string) - Required - The song artist. Required if the track_isrc is not indicated.
- **f_subtitle_length** (string) - Optional - Filter by subtitle 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) - Optional - Max deviation for a subtitle length in seconds.
- **track_isrc** (string) - Optional - If you have an available ISRC ID in your catalogue you can query using this ID only.

### Response
#### Success Response (200)
- **200 OK / 401 Unauthorized** - The response returns metadata regarding the syncs for the requested song.
```

--------------------------------

### Header Response Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-lyrics-get

Example values for the response header containing execution time and status code.

```yaml
header:
  type: object
  properties:
    execute_time:
      type: number
      example: 0.2803099155426
    status_code:
      type: number
      example: 200
```

--------------------------------

### 200 OK Response Example

Source: https://docs.musixmatch.com/enterprises/publishing/work-post

Example response body for a successful 200 OK request.

```yaml
examples:
  200 OK:
    value:
      message:
        body:
          alternate_titles:
            - title: Yellow Submarine
          collections:
            '2023-07-17':
              territories:
                - code: IT
                  countries:
                    - IT
                  mech_share: 10000
                  perf_share: 0
                  publisher: null
                  sync_share: 10000
              validity_begin: '2023-07-17'
              validity_end: null
          identifier: '00001100196005'
          is_disabled: 0
          isrc: []
          iswc: ''
          last_trasmission: '2023-07-17'
          owners:
            publisher:
              - controlled: 'Y'
                id: 211
                identifier: ''
                ipi: '00000000000'
                mech_ownership_share: 0
                mech_society: null
                name: Sony/Atv Tunes Llc
                perf_ownership_share: 0
                perf_society: null
                role: null
                sync_ownership_share: 0
                sync_society: null
                type: publisher
```

--------------------------------

### 200 OK Response Body Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-lyrics-get

A full example of a successful API response containing the lyrics body.

```json
{
  "message": {
    "body": {
      "lyrics": {
        "explicit": 0,
        "lyrics_body": "I know that we are young\n\nAnd I know that you may love me\n\nBut I just can't be with you like this anymore\n\nAlejandro\n\n\nShe's got both hands in her pocket\n\nAnd she won't look at you, won't look at you\n\nShe hides true love en su bolsillo\n\nShe's got a halo around her finger, around you\n\n\nYou know that I love you, boy\n\nHot like Mexico, rejoice\n\nAt this point, I've gotta choose\n\nNothing to lose\n\n\nDon't call my name, don't call my name, Alejandro\n\nI'm not your babe, I'm not your babe, Fernando\n\nDon't wanna kiss, don't wanna touch\n\nJust smoke my cigarette and hush\n\nDon't call my name, don't call my name, Roberto\n\n\nAlejandro, Alejandro\n\nAle-Alejandro, Ale-Alejandro\n\nAlejandro, Alejandro\n\nAle-Alejandro, Ale-Alejandro\n\n\nStop, please, just let me go\n\nAlejandro, just let me go\n\n\nShe's not broken, she's just a baby\n\nBut her boyfriend's like her dad, just like a dad\n\nAnd all those flames that burned before him\n\nNow he's gotta firefight, got cool the bad\n\n\nYou know that I love you, boy\n\nHot like Mexico, rejoice\n\nAt this point, I've gotta choose\n\nNothing to lose\n\n\nDon't call my name, don't call my name, Alejandro\n\nI'm not your babe, I'm not your babe, Fernando\n\nDon't wanna kiss, don't wanna touch"
      }
    }
  }
}
```

--------------------------------

### RichSync Response Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-richsync-get

Example of a successful 200 OK response containing RichSync data, tracking URLs, and copyright information.

```json
{
  "message": {
    "body": {
      "richsync": {
        "html_tracking_url": "https://tracking.musixmatch.com/t1.0/m_html/e_0/sn_0/l_0/su_0/rs_7771947/tr_3vUCAKQcr0tjttW7q-8nSdML-3hZM2725atGyS2E3MFDJziZDZnO4FMQxveJCgF2SbgKXb-he2OJrCLvsMeKVUdCDKrn8nwIa5TvQUgd5_GlxuhFabDLO1mi3Rxyg2gNA8DGROnIOigo3BcfkaoTTS-4g7qWy0sOHK2lSxcLM3qE9gYeqjdaV0Ux0n1rD60PfnWomEtGRjhzyuacA8YHm8VrNG-7J41vzE8kQw-7Wc_jirgMSQodHkYqd_RsKMd9RjNiBHdw_ZyxWubQyLuWQrUkVmWkYQvVRCVmk0VclhPwrTj6fZ7LUsWAYfDOu4bREqtF8_Y7kTLXEOMTxo7vm_LD_p7s2OzH6SHJhOtrR01ZTMlmAKE3aKNeFPCiqWUyQOVN_ka8Aw6YmSR1k-aS2CV2B2G6D0l5jI2vO7ZMmhrz4VPj-bRMYNdhD9eh3Z3EPBSm_hTYb8MzAdH_GyLra6EfNw/",
        "lyrics_copyright": "Writer(s): Finneas Baird O'connell, Billie Eilish\nO'connell\n\nCopyright: Universal Music Works, Drup, Last\nFrontier\n\nLyrics powered by www.musixmatch.com",
        "pixel_tracking_url": ""
      }
    }
  },
  "header": {
    "available": 2,
    "execute_time": 0.37130689620972,
    "status_code": 200
  }
}
```

--------------------------------

### PlanIndicator Usage Example

Source: https://docs.musixmatch.com/enterprises/catalog-feed/tracks-dump-get

Example of how to implement the PlanIndicator component for an enterprise plan.

```jsx
<PlanIndicator plan={["enterprise"]} />
```

--------------------------------

### JSONL Lyrics Submission Examples

Source: https://docs.musixmatch.com/enterprises/lyrics-bulk-submission

Examples of JSONL formatted data for single and multiple lyric submissions.

```json
{"isrc":"ABCDE1234567","artist":"Artist Name","title":"Track Title","lyrics":"Lyrics line 1\nLyrics line 2\nLyrics line 3","duration":240000,"language":"en","partner_id":"PARTNER123"}
```

```json
{"isrc":"ABCDE1234567","artist":"Artist Name","title":"Track Title","lyrics":"Lyrics line 1\nLyrics line 2\nLyrics line 3","duration":240000,"language":"en","partner_id":"PARTNER123"}
{"isrc":"FGHIJ8901234","artist":"Another Artist","title":"Another Track","lyrics":"More lyrics line 1\nMore lyrics line 2","duration":180000,"language":"fr","partner_id":"PARTNER124"}
{"isrc":"KLMNO5678901","artist":"Third Artist","title":"Third Track","lyrics":"Third song lyrics\nWith multiple lines\nAnd verses too","duration":320000,"language":"es","partner_id":"PARTNER125"}
```

--------------------------------

### Work Post Example Payload

Source: https://docs.musixmatch.com/enterprises/publishing/work-post

Example JSON payload for the work.post endpoint.

```json
data:
  collection:
    territories:
      - code: IT
        mech_share: 10000
        sync_share: 10000
    validity_begin: '2023-07-17'
  identifier: '00001100196005'
  owners:
    publisher:
      - controlled: 'Y'
        name: Sony/Atv Tunes Llc
    writer:
      - controlled: 'Y'
        mech_ownership_share: 5000
        name: John Lennon
        role: CA
        sync_ownership_share: 5000
      - controlled: 'Y'
        mech_ownership_share: 5000
        name: Paul McCartney
        role: CA
        sync_ownership_share: 5000
  title: Yellow Submarine
```

--------------------------------

### PlanIndicator Usage Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/album-get

Example implementation of the PlanIndicator component for a basic plan.

```jsx
<PlanIndicator plan={["basic"]} />
```

--------------------------------

### CSV Delimiter and Quote Examples

Source: https://docs.musixmatch.com/llms-full.txt

Examples demonstrating how to handle delimiters and internal quotes within CSV values.

```text
"Laser , Game", nice, 829
```

```text
"We Will Rock You (From ""We Will Rock You"")"
```

--------------------------------

### GET /ws/1.1/artist.get

Source: https://docs.musixmatch.com/llms-full.txt

Get the artist data from our database.

```APIDOC
## GET /ws/1.1/artist.get

### Description
Get the artist data from our database.

### Method
GET

### Endpoint
/ws/1.1/artist.get
```

--------------------------------

### PlanIndicator Usage Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/matcher-subtitle-get

Example implementation of the PlanIndicator component with a specific plan prop.

```jsx
<PlanIndicator plan={["scale"]} />
```

--------------------------------

### Lyrics Object Schema Examples

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-lyrics-get

Example values for lyrics metadata fields including IDs, language codes, and tracking URLs.

```yaml
lyrics_id:
  type: number
  example: 16258913
lyrics_language:
  type: string
  example: en
pixel_tracking_url:
  type: string
  example: >-
    https://tracking.musixmatch.com/t1.0/m_img/e_0/sn_0/l_16258913/su_0/rs_0/tr_3vUCAD89QMi-09ZtyZedCON8p5IWdHcrgHnWQv8uoS26xTu_dhNv7pg93xeOzpM-RQ25hEChkhH09tzt_WTuPmqwOEqBUmK2Om9SrVmeY-IDq2yMZ9nh5noNZh2xfIgKAf8b9VLJ257Ud-7K5JBs28flcQiHIX2veuuzeKRkjMmCiFXMF8qNBlaxBVIVxBa2tORYlUirUylLir4INaq-uOqQs3qYqbppfzVjurlenGT2MqPjjA29tdHRmb8nZQzlnnbxG-a41NBVc1KUB6OchXp5MgD_vGmywbQ_uSwJ0dSyc7_qR3OW76Iywcak7bsbYEAt2SIhIFhueB-LzEla7BRuQ94K0TzQ9zGFHlJfDKBEQ0qfCHqmOpPIXD4Ciig-HRZSiK7IlYDJkq34cmpRXn6yCW_nMHI9_CXMji-IYO__e0aTmMIYWrSGv3Tt-iDj/
script_tracking_url:
  type: string
  example: >-
    https://tracking.musixmatch.com/t1.0/m_js/e_0/sn_0/l_16258913/su_0/rs_0/tr_3vUCAPyhiC1b1puoRZNGFoIMTet-yNNgyfqs9vJKAvHadXByJ02tkI7H-6JNMEewkKxZBeszqLulBVSoyeqmXpgNQKbj0tAuuhDicPv9ZGnlUxVAXqBvorS3ste-Q7mE9-jkq1pzxIhDWq99fVXpliVtojpxvD-49yehOMtP_Wdg-smfOq1Y3QcP1DBu4ZLDgjdTpX71zwuBN1nvP4icle3ySj664Q70Z8Q-LpnDONhTfVdJEJKaRhTFdCZ-eUSxHq2QqkXfvS9LyLZasI4Q6EPP8G_un6aFXdgWHbHSOApC7c_40f-Tfo0dxeguGlKlSlUoJ1Cpm2_0GD1N8shQQwgr18PYFNMraVM_w0rtMEmKH3GsMglWlb90V5XcMyoofkxrA-9qjt4VzqM6TxWEbYYSzF1ZmdLk10hNGluhieMC0vZqAEVZCVcIdFUkHvrv/
updated_time:
  type: string
  example: '2022-06-13T18:44:33Z'
```

--------------------------------

### Delivery status response example

Source: https://docs.musixmatch.com/enterprises/distribution/api/deliveries/get-delivery-status

Example JSON response structure for a successful delivery status request.

```json
{
  "message": "delivery status retrieved",
  "data": {
    "delivery": {
      "delivery_id": 123456,
      "status": "success",
      "tracks": [
        {
          "isrc": "USIR20300001",
          "track_title": "Track One",
          "album_title": "My Album",
          "album_upc": "123456789012",
          "release_date": "2025-10-15",
          "status": "success",
          "commontrack_id": 123456
        },
        {
          "isrc": "USIR20300002",
          "track_title": "Track Two",
          "album_title": "My Album",
          "album_upc": "123456789012",
          "release_date": "2025-10-15",
          "status": "success",
          "commontrack_id": 100002
        }
      ]
    }
  }
}
```

--------------------------------

### OpenAPI Response Examples

Source: https://docs.musixmatch.com/enterprises/publishing/work-validity-post

Examples of 200 OK, 400 Bad Request, and 401 Unauthorized response structures for the work validity post endpoint.

```yaml
examples:
                200 OK:
                  value:
                    message:
                      body: work updated
                      header:
                        execute_time: 0.41507601737976
                        status_code: 200
                400 Bad Request:
                  value:
                    message:
                      body: []
                      header:
                        execute_time: 0.40488600730896
                        hint: >-
                          error in date recognition (admitted format:
                          YYYY-MM-DD)
                        status_code: 400
                401 Unauthorized:
                  value:
                    message:
                      body: []
                      header:
                        execute_time: 0.087625980377197
                        status_code: 401
```

--------------------------------

### Music Genre Example Data

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/music-genres-get

Provides a list of example music genre objects as they appear in the API response.

```yaml
example:
  - music_genre:
      music_genre_id: 34
      music_genre_name: Music
      music_genre_name_extended: Music
      music_genre_parent_id: 0
      music_genre_vanity: Music
  - music_genre:
      music_genre_id: 1007
      music_genre_name: Chicago Blues
      music_genre_name_extended: Blues / Chicago Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Chicago-Blues
  - music_genre:
      music_genre_id: 1009
      music_genre_name: Classic Blues
      music_genre_name_extended: Blues / Classic Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Classic-Blues
  - music_genre:
      music_genre_id: 1010
      music_genre_name: Contemporary Blues
      music_genre_name_extended: Blues / Contemporary Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Contemporary-Blues
  - music_genre:
      music_genre_id: 1011
      music_genre_name: Country Blues
      music_genre_name_extended: Blues / Country Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Country-Blues
  - music_genre:
      music_genre_id: 1012
      music_genre_name: Delta Blues
      music_genre_name_extended: Blues / Delta Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Delta-Blues
  - music_genre:
      music_genre_id: 1013
      music_genre_name: Electric Blues
      music_genre_name_extended: Blues / Electric Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Electric-Blues
  - music_genre:
      music_genre_id: 1210
      music_genre_name: Acoustic Blues
      music_genre_name_extended: Blues / Acoustic Blues
      music_genre_parent_id: 2
      music_genre_vanity: Blues-Acoustic-Blues
  - music_genre:
      music_genre_id: 1167
      music_genre_name: Novelty
      music_genre_name_extended: Comedy / Novelty
      music_genre_parent_id: 3
      music_genre_vanity: Comedy-Novelty
  - music_genre:
```

--------------------------------

### Track Search API Response Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/track-search

Example of a successful 200 OK response containing a list of tracks with metadata such as album, artist, and genre information.

```yaml
200 OK:
  value:
    message:
      body:
        track_list:
          - track:
              album_id: 57933320
              album_name: Greatest Hits (Deluxe)
              artist_id: 53952596
              artist_name: Aerosmith
              commontrack_id: 160488573
              commontrack_isrcs:
                - - USSM19801545
              explicit: 0
              has_lyrics: 1
              has_richsync: 1
              has_subtitles: 1
              has_lyrics_crowd: 0
              has_track_structure: 0
              has_lyrics_analysis: 0
              instrumental: 0
              num_favourite: 41
              primary_genres:
                music_genre_list:
                  - music_genre:
                      music_genre_id: 14
                      music_genre_name: Pop
                      music_genre_name_extended: Pop
                      music_genre_parent_id: 34
                      music_genre_vanity: Pop
              restricted: 0
              track_edit_url: >-
                https://www.musixmatch.com/lyrics/Aerosmith-1/I-Don-t-Want-To-Miss-A-Thing-From-Armageddon-Soundtrack/edit?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409624942950
              track_id: 260269361
              track_isrc: USSM19801545
              track_length: 297
              track_lyrics_translation_status:
                - from: en
                  perc: 1
                  to: de
```

--------------------------------

### Artist Search Response Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/artist-search

Example JSON response structure for an artist search query, including artist details and metadata.

```json
example:
  - artist:
      artist_alias_list:
        - artist_alias: テイラー・スウィフト
        - artist_alias: 泰勒·史薇芙特
        - artist_alias: Taylor Alison Swift
        - artist_alias: fu ci
        - artist_alias: da Z
        - artist_alias: Taylor Swift
        - artist_alias: Lew
      artist_comment: ''
      artist_country: US
      artist_credits:
        artist_list: []
      artist_id: 259675
      artist_name: Taylor Swift
      artist_name_translation_list:
        - artist_name_translation:
            language: JA
            translation: テイラー・スウィフト
      artist_twitter_url: https://twitter.com/taylorswift13
      begin_date: '1989-00-00'
      begin_date_year: '1989'
      end_date: '0000-00-00'
      end_date_year: ''
      restricted: 0
      updated_time: '2024-03-07T04:07:57Z'
  - artist:
      artist_alias_list: []
      artist_comment: ''
      artist_country: ''
      artist_credits:
        artist_list: []
      artist_id: 37263159
      artist_name: Taylor Swift & ZAYN
      artist_name_translation_list: []
      artist_twitter_url: ''
      begin_date: '0000-00-00'
      begin_date_year: ''
      end_date: '0000-00-00'
      end_date_year: ''
      restricted: 0
      updated_time: '2018-12-03T17:58:48Z'
  - artist:
      artist_alias_list: []
      artist_comment: ''
      artist_country: ''
      artist_credits:
        artist_list: []
      artist_id: 33333395
      artist_name: Taylor Swift & Hardwell
      artist_name_translation_list: []
      artist_twitter_url: ''
      begin_date: '0000-00-00'
      begin_date_year: ''
      end_date: '0000-00-00'
      end_date_year: ''
      restricted: 0
      updated_time: '2017-03-22T23:26:27Z'
```

```json
message:
  body:
    artist_list:
      - artist:
          artist_alias_list:
            - artist_alias: テイラー・スウィフト
```

--------------------------------

### Album Tracks API Response Example

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/album-tracks-get

Example of a successful 200 OK response containing a list of tracks with metadata such as album ID, artist name, and genre information.

```yaml
message:
  body:
    track_list:
      - track:
          album_id: 32540723
          album_name: Revolver (Remastered)
          artist_id: 160
          artist_name: The Beatles
          commontrack_id: 70591
          commontrack_isrcs:
            - - GBAYE0601493
          explicit: 0
          has_lyrics: 1
          has_richsync: 1
          has_subtitles: 1
          has_lyrics_crowd: 0
          has_track_structure: 0
          has_lyrics_analysis: 0
          instrumental: 0
          num_favourite: 297
          primary_genres:
            music_genre_list:
              - music_genre:
                  music_genre_id: 1133
                  music_genre_name: Pop/Rock
                  music_genre_name_extended: Pop / Pop/Rock
                  music_genre_parent_id: 14
                  music_genre_vanity: Pop-Pop-Rock
              - music_genre:
                  music_genre_id: 21
                  music_genre_name: Rock
                  music_genre_name_extended: Rock
                  music_genre_parent_id: 34
                  music_genre_vanity: Rock
          restricted: 0
          track_edit_url: >-
```

--------------------------------

### GET /ws/1.1/artist.search

Source: https://docs.musixmatch.com/llms-full.txt

Search for artists in our database.

```APIDOC
## GET /ws/1.1/artist.search

### Description
Search for artists in our database.

### Method
GET

### Endpoint
/ws/1.1/artist.search
```

--------------------------------

### Define region restriction configurations

Source: https://docs.musixmatch.com/llms-full.txt

Examples of how region_restriction objects are structured for different access scenarios.

```json
region_restriction: { allowed: [XW], blocked: [] }
```

```json
region_restriction: { allowed: [XW], blocked: [US,CA] }
```

```json
region_restriction: { allowed: [], blocked: [XW] }
```

```json
region_restriction: { allowed: [IT], blocked: [XW] }
```

--------------------------------

### Token Introspection Responses

Source: https://docs.musixmatch.com/llms-full.txt

Example JSON responses for valid and invalid token introspection requests.

```json
{
  "active": true,
  "sub": "<musixmatch-user-id>"
}
```

```json
{
  "active": false
}
```

--------------------------------

### GET /ws/1.1/track.lyricslens.get

Source: https://docs.musixmatch.com/llms-full.txt

Retrieve music lyrics analysis data for a specific track. Note that this endpoint is deprecated.

```APIDOC
## GET /ws/1.1/track.lyricslens.get

### Description
Retrieve music lyrics analysis data for a specific track. This endpoint is deprecated and will be removed on September 1, 2026.

### Method
GET

### Endpoint
/ws/1.1/track.lyricslens.get

### Parameters
#### Query Parameters
- **commontrack_id** (string) - Optional - The common track identifier.
- **track_id** (string) - Optional - The track identifier.
- **track_isrc** (string) - Optional - The ISRC code of the track.

*Note: At least one of the above parameters must be provided.*
```

--------------------------------

### Create delivery file response example

Source: https://docs.musixmatch.com/enterprises/distribution/api/deliveries/upload-a-release-file

Successful response containing the file ID and the pre-signed URL for the subsequent HTTP PUT upload.

```json
{
  "message": "release file upload accepted",
  "data": {
    "file": {
      "file_id": 123456,
      "upload_url": "https://storage.example.com/uploads/123456?signature=..."
    }
  }
}
```

--------------------------------

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

Source: https://docs.musixmatch.com/api-reference/lyrics-catalog/matcher-lyrics-get

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

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

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

### Method
GET

### Endpoint
/ws/1.1/matcher.lyrics.get

### Parameters
#### Query Parameters
- **q_track** (string) - Required - The song title. Required if the track_isrc is not indicated.
- **q_artist** (string) - Required - The song artist. Required if the track_isrc is not indicated.
- **track_isrc** (string) - Optional - A valid ISRC identifier. If you have an ISRC ID in your catalogue you can query using this ID only.

### Response
#### Success Response (200)
- **200 OK / 401 Unauthorized / 404 Not Found** - The response status indicates the result of the request.
```

--------------------------------

### 200 OK Response Example

Source: https://docs.musixmatch.com/enterprises/catalog-feed/track-dump-get

Full JSON response structure for a successful track dump request.

```json
{
  "message": {
    "body": [
      {
        "artist": "Billie Eilish",
        "commontrack_id": 178050559,
        "instrumental": false,
        "isrcs": [
          "USUM72401994"
        ],
        "language_iso_code_1": "en",
        "last_updated": "2025-02-16T17:19:42Z",
        "lyrics": "('Til I'm in the grave)\n\n\nI want you to stay\n\n'Til I'm in the grave\n\n'Til I rot away, dead and buried\n\n'Til I'm in the casket you carry\n\n\nIf you go, I'm going too, uh\n\n'Cause it was always you, alright\n\nAnd if I'm turnin' blue, please don't save me\n\nNothing left to lose without my baby\n\n\nBirds of a feather, we should stick together, I know\n\nI said I'd never think I wasn't better alone\n\nCan't change the weather, might not be forever\n\nBut if it's forever, it's even better\n\n\nAnd I don't know what I'm cryin' for\n\nI don't think I could love you more\n\nIt might not be long, but baby, I\n\nI'll love you 'til the day that I die\n\n'Til the day that I die\n\n'Til the light leaves my eyes\n\n'Til the day that I die\n\n\nI want you to see, hm\n\nHow you look to me, hm\n\nYou wouldn't believe if I told ya\n\nYou would keep the compliments I throw ya\n\n\nBut you're so full of shit, uh\n\nTell me it's a bit, no\n\nSay you don't see it, your mind's polluted\n\nSay you wanna quit, don't be stupid\n\n\nAnd I don't know what I'm cryin' for\n\nI don't think I could love you more\n\nMight not be long, but baby, I\n\nDon't wanna say goodbye\n\n\nBirds of a feather, we should stick together, I know\n('til the day that I die)\n\nI said I'd never think I wasn't better alone ('til\nthe light leaves my eyes)\n\nCan't change the weather, might not be forever ('til\nthe day I die)\n\nBut if it's forever, it's even better\n\n\nI knew you in another life\n\nYou had that same look in your eyes"
      }
    ]
  }
}
```

--------------------------------

### Example response from the API

Source: https://docs.musixmatch.com/musixmatch-metadata

This JSON object represents a successful API response containing lyrics metadata and tracking URLs.

```json
{
    "message": {
        "header": {
            "status_code": 200,
            "execute_time": 0.0074818134307861
        },
        "body": {
            "lyrics": {
                "lyrics_id": 28690433,
                "verified": 0,
                "restricted": 0,
                "instrumental": 0,
                "explicit": 0,
                "lyrics_body": "I know that we are young\nAnd I know that you may love me\nBut I just can't be with you like this anymore\nAlejandro\n\nShe's got both hands in her pocket\nAnd she won't look at you, won't look at you\nShe hides true love en su bolsillo\nShe's got a halo around her finger, around you\n\nYou know that I love you, boy\nHot like Mexico, rejoice\nAt this point, I've gotta choose\nNothing to lose\n\nDon't call my name, don't call my name, Alejandro\nI'm not your babe, I'm not your babe, Fernando\nDon't wanna kiss, don't wanna touch\nJust smoke my cigarette and hush\nDon't call my name, don't call my name, Roberto\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\n\nStop, please, just let me go\nAlejandro, just let me go\n\nShe's not broken, she's just a baby\nBut her boyfriend's like her dad, just like a dad\nAnd all those flames that burned before him\nNow he's gotta firefight, got cool the bad\n\nYou know that I love you, boy\nHot like Mexico, rejoice\nAt this point, I've gotta choose\nNothing to lose\n\nDon't call my name, don't call my name, Alejandro\nI'm not your babe, I'm not your babe, Fernando\nDon't wanna kiss, don't wanna touch\nJust smoke my cigarette and hush\nDon't call my name, don't call my name, Roberto\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\n\nDon't bother me, don't bother me, Alejandro\nDon't call my name, don't call my name, bye, Fernando\nI'm not your babe, I'm not your babe, Alejandro\nDon't wanna kiss, don't wanna touch, Fernando\n\nDon't call my name, don't call my name, Alejandro\nI'm not your babe, I'm not your babe, Fernando\nDon't wanna kiss, don't wanna touch\nJust smoke my cigarette and hush\nDon't call my name, don't call my name, Roberto\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\nAlejandro, Alejandro\nAle-Alejandro, Ale-Alejandro\n\nDon't call my name (Alejandro, Alejandro), don't call my name, Alejandro\nI'm not your babe (Ale-Alejandro, Ale-Alejandro), I'm not your babe, Fernando\nDon't wanna kiss (Alejandro, Alejandro), don't wanna touch\nJust smoke my cigarette and hush\nDon't call my name (Ale-Alejandro, Ale-Alejandro), don't call my name, Roberto\nAlejandro",
                "lyrics_language": "en",
                "lyrics_language_description": "English",
                "script_tracking_url": "https://tracking.musixmatch.com/t1.0/m_js/e_0/sn_0/l_28690433/su_0/rs_0/tr_3vUCAK...2SK90/",
                "pixel_tracking_url": "https://tracking.musixmatch.com/t1.0/m_img/e_0/sn_0/l_28690433/su_0/rs_0/tr_3vUCAC...H5AMk/",
                "html_tracking_url": "https://tracking.musixmatch.com/t1.0/m_html/e_0/sn_0/l_28690433/su_0/rs_0/tr_3vUCAN...xOhBA/",
                "lyrics_copyright": "Lyrics powered by www.musixmatch.com",
                "writer_list": [],
                "publisher_list": [],
                "backlink_url": "https://www.musixmatch.com/lyrics/Lady-Gaga/Alejandro?utm_source=application&utm_campaign=api&utm_medium=musiXmatch+-+internal+use%3A1409607281181",
                "updated_time": "2024-06-12T14:43:08Z"
            }
        }
    }
}
```

--------------------------------

### Create delivery file request example

Source: https://docs.musixmatch.com/enterprises/distribution/api/deliveries/upload-a-release-file

JSON payload required to initiate the creation of a release file upload slot.

```json
{
  "musixmatch_user_id": "mxm:123456789012345678901"
}
```

--------------------------------

### Fetch delivery status in Go

Source: https://docs.musixmatch.com/enterprises/distribution/api/deliveries/get-delivery-status

Use the net/http package to perform the GET request.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://varco-partner.musixmatch.com/distribution/v1/deliveries/{delivery_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Track Dump Example Response

Source: https://docs.musixmatch.com/enterprises/catalog-feed/track-dump-get

Example of a track dump response body containing subtitle timing data.

```yaml
example:
  - body: >-
      [00:00.42] ('Til I'm in the grave)

      [00:03.94] I want you to stay

      [00:08.56] 'Til I'm in the grave

      [00:13.07] 'Til I rot away, dead and buried

      [00:17.59] 'Til I'm in the casket you carry

      [00:21.98] If you go, I'm going too, uh
```
Tokens:
Raw