Musixmatch API
Musixmatch lyrics API is a robust service that permits you to search and retrieve lyrics in the simplest possible way. It just works. Include millions of…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Musixmatch lyrics API is a robust service that permits you to search and retrieve lyrics in the simplest possible way. It just works.
Include millions of licensed lyrics on your website or in your application legally.
The fastest, most powerful and legal way to display lyrics on your website or in your application.
Read musixmatch API Terms & Conditions and the Privacy Policy:
Before getting started, you must take a look at the API Terms & Conditions and the Privacy Policy. We’ve worked hard to make this service completely legal so that we are all protected from any foreseeable liability. Take the time to read this stuff.
Register for an API key:
All you need to do is register in order to get your API key, a mandatory parameter for most of our API calls. It’s your personal identifier and should be kept secret:
https://api.musixmatch.com/ws/v1.1/track.get?apikey=YOUR_API_KEYIntegrate the musixmatch service with your web site or application
In the most common scenario you only need to implement two API calls:
The first call is to match your catalog to ours using the track.search function and the second is to get the lyrics using the track.lyrics.get api. That’s it!
API Methods
What does the musiXmatch API do?
The musiXmatch API allows you to read objects from our huge 100% licensed lyrics database.
To make your life easier we are providing you with one or more examples to show you how it could work in the wild. You’ll find both the API request and API response in all the available output formats for each API call. Follow the links below for the details.
The current API version is 1.1, the root URL is located at https://api.musixmatch.com/ws/1.1/
Supported input parameters can be found on the page Input Parameters. Use UTF-8 to encode arguments when calling API methods.
Every response includes a status_code. A list of all status codes can be consulted at Status Codes.
Music meta data
The musiXmatch api is built around lyrics, but there are many other data we provide through the api that can be used to improve every existent music service.
Track
Inside the track object you can get the following extra information:
TRACK RATING
The track rating is a score 0-100 identifying how popular is a song in musixmatch.
You can use this information to sort search results, like the most popular songs of an artist, of a music genre, of a lyrics language.
INSTRUMENTAL AND EXPLICIT FLAGS
The instrumental flag identifies songs with music only, no lyrics.
The explicit flag identifies songs with explicit lyrics or explicit title. We're able to identify explicit words and set the flag for the most common languages.
FAVOURITES
How many users have this song in their list of favourites.
Can be used to sort tracks by num favourite to identify more popular tracks within a set.
MUSIC GENRE
The music genere of the song.
Can be used to group songs by genre, as input for similarity alghorithms, artist genre identification, navigate songs by genere, etc.
SONG TITLES TRANSLATIONS
The track title, as translated in different lanauages, can be used to display the right writing for a given user, example:
LIES (Bigbang) becomes 在光化門 in chinese
HALLELUJAH (Bigbang) becomes ハレルヤ in japanese
Artist
Inside the artist object you can get the following nice extra information:
COMMENTS AND COUNTRY
An artist comment is a short snippet of text which can be mainly used for disambiguation.
The artist country is the born country of the artist/group
There are two perfect search result if you search by artist with the keyword "U2". Indeed there are two distinct music groups with this same name, one is the most known irish group of Bono Vox, the other is a less popular (world wide speaking) group from Japan.
Here's how you can made use of the artist comment in your search result page:
U2 (Irish rock band)
U2 (あきやまうに)
You can also show the artist country for even better disambiguation:
U2 (Irish rock band) from Ireland
U2 (あきやまうに) from Japan
ARTIST TRANSLATIONS
When you create a world wide music related service you have to take into consideration to display the artist name in the user's local language. These translation are also used as aliases to improve the search results.
Let's use PSY for this example.
Western people know him as PSY but korean want to see the original name 싸이.
Using the name translations provided by our api you can show to every user the writing they expect to see.
Furthermore, when you search for "psy gangnam style" or "싸이 gangnam style" with our search/match api you will still be able to find the song.
ARTIST RATING
The…
Endpoints 16
Track
- GETGET /album.tracks.get
/album.tracks.get?format=json&callback=string&album_id=string&f_has_lyrics=string&page=0.0&page_size=0.0 - GETGET /chart.tracks.get
/chart.tracks.get?format=json&callback=string&page=0.0&page_size=0.0&country=us&f_has_lyrics=string - GETGET /matcher.track.get
/matcher.track.get?format=json&callback=string&q_artist=string&q_track=string&f_has_lyrics=0.0&f_has_subtitle=0.0 - GETGET /track.get
/track.get?format=json&callback=string&track_id=string - GETGET /track.search
/track.search?format=json&callback=string&q_track=string&q_artist=string&q_lyrics=string&f_artist_id=0.0&f_music_genre_id=0.0&f_lyrics_language=0.0&f_has_lyrics=0.0&s_artist_rating=string&s_track_rating=string&quorum_factor=1&page_size=0.0&page=0.0
Artist
- GETGET /artist.get
/artist.get?format=json&callback=string&artist_id=string - GETGET /artist.related.get
/artist.related.get?format=json&callback=string&artist_id=string&page_size=0.0&page=0.0 - GETGET /artist.search
/artist.search?format=json&callback=string&q_artist=string&f_artist_id=0.0&page=0.0&page_size=0.0 - GETGET /chart.artists.get
/chart.artists.get?format=json&callback=string&page=0.0&page_size=0.0&country=us
Album
- GETGET /album.get
/album.get?format=json&callback=string&album_id=string - GETGET /artist.albums.get
/artist.albums.get?format=json&callback=string&artist_id=string&s_release_date=string&g_album_name=string&page_size=0.0&page=0.0
Lyrics
- GETGET /matcher.lyrics.get
/matcher.lyrics.get?format=json&callback=string&q_track=string&q_artist=string - GETGET /track.lyrics.get
/track.lyrics.get?format=json&callback=string&track_id=string
Subtitle
- GETGET /matcher.subtitle.get
/matcher.subtitle.get?format=json&callback=string&q_track=string&q_artist=string&f_subtitle_length=0.0&f_subtitle_length_max_deviation=0.0 - GETGET /track.subtitle.get
/track.subtitle.get?format=json&callback=string&track_id=string
Snippet
- GETGET /track.snippet.get
/track.snippet.get?format=json&callback=string&track_id=string
API details
- Base URL
https://api.musixmatch.com/ws/1.1- Authentication
- An API key in the apikey query parameter
- Operations
- 16 operations on 16 pathsGET 16
- Main resources
- Track 5Artist 4Album 2Lyrics 2Subtitle 2Snippet 1
- Response formats
application/json- Description format
- Swagger 2.0, API version
1.1.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Musixmatch API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Musixmatch API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the apikey query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /album.tracks.get” (GET /album.tracks.get?format=json&callback=string&album_id=string&f_has_lyrics=string&page=0.0&page_size=0.0), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Musixmatch API?
Musixmatch lyrics API is a robust service that permits you to search and retrieve lyrics in the simplest possible way. It just works. Include millions of… It is listed under Media & content and has 16 endpoints.
Who publishes the Musixmatch API?
It is listed from Musixmatch's public API description (an OpenAPI document), not published by Musixmatch on Swastik Codes. Anyone who controls musixmatch.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Musixmatch API?
Requests go to https://api.musixmatch.com/ws/1.1. Endpoint paths are added to this base URL.
How do I authenticate with the Musixmatch API?
With an API key in the apikey query parameter.
How many endpoints does the Musixmatch API have?
16 operations on 16 paths (16 GET). The largest groups are Track, Artist, Album, Lyrics.
Is forking the Musixmatch API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.