https://api.musixmatch.com/ws/1.1/ with apikey and user_id query parameters.
Tracks are always identified by ISRC, not by commontrack_id.
Call order
1
Get your credentials
Contact apisupport@musixmatch.com for the API key.Send Musixmatch your
redirect_uri. Musixmatch issues a client_id, then a client_secret.2
Authenticate the artist and activate the subscription
The artist signs in with their own Musixmatch account through the Authorization Code flow. Exchange the authorization code for tokens. Those calls use
https://connect.musixmatch.com, as described on that page.Call POST /oauth/token-metadata and use the returned sub as user_id on every Distribution API call. Always store the latest refresh_token.Call distribution.subscription.post with plan_id, partner_user_id, and artists. Uploads are refused without an active subscription.3
Deliver the release
Deliver the release even when the ISRC already exists on Musixmatch. The delivery provides the audio.Call
distribution.files.post. It returns upload_url and file_id. HTTP PUT the release ZIP (ERN and audio) to upload_url with the header Content-Type: application/zip. That header is required.Call distribution.delivery.post with file_id. Poll distribution.delivery.get until status is success.4
Prepare the lyrics
Pick one option.No lyrics. Call
distribution.transcription.post with isrc. Sending language is recommended. Poll distribution.transcription.get until status is success. On success the response includes lyrics and subtitle.Lyrics and sync. Call distribution.sync.post with isrc, lyrics, and language. Poll distribution.sync.get until status is success. On success the response includes subtitle.Lyrics, no sync. Continue to the next step.5
Publish the lyrics
This call is mandatory. A transcription or sync request does not publish anything by itself. After it completes, send the result with
distribution.lyrics.post: isrc, lyrics, and subtitle when you have one. Pass subtitle as-is, in LRC. lyrics is required. If you already have lyrics and skipped transcription and sync, send those lyrics with the same call. Poll distribution.lyrics.get until status is success. The lyrics are then live in the catalog.