Partial Musixmatch client API documentation and its C# implementation
MusixmatchClientLib is a .NET library designed to interact with Musixmatch client API easily. This project also contains an information about Musixmatch's hidden endpoints to work with.
Definitions:
- W: Work in progress
- H: Hold
- I: Implemented
- S: Code-documented (summary)
- T: Tested
- D: Wiki-documented
- R: Research in progress (for undocumented)
- U: Ignored (useless)
Core
- Custom request function | I
Officially implemented API methods
- chart.artists.get | IS
- chart.tracks.get | IST
- track.search | IST
- track.get | IST
- track.lyrics.get | IST
- track.snippet.get | IST
- track.subtitle.get | IST
- track.richsync.get | IST
- track.lyrics.translation.get | IS
- track.subtitle.translation.get | W
- music.genres.get | IS
- matcher.lyrics.get | HU
- matcher.track.get | HU
- matcher.subtitle.get | HU
- artist.get | IST
- artist.search | IST
- artist.albums.get | IST
- artist.related.get | H
- album.get | IST
- album.tracks.get | IST
Unofficial API methods
- track.subtitle.post | IST
- track.lyrics.post | IST
- track.translation.post | H
- crowd.user.feedback.get | IS
- crowd.polls.tracks.search | IS
- token.get | IST
- credentials.post | IST
- crowd.user.suggestion.lyrics.get | IST
- crowd.user.suggestion.subtitles.get | IST
- crowd.user.suggestion.translations.get | IST
- crowd.user.suggestion.votes.get | IST
- ai.question.post | WRIST
- crowd.chart.users.get | IST
- track.richsync.post | IS
- crowd.score.get | WIST
Missions API
- Get missions | IT
- Get tasks | W
Project
- Write samples for all the functions | H
- Create wiki | H
All the information provided in this repository is for educational purposes only. Please do not use this to write bots or other automation applications. This platform is good for it is supported by people. There is no point in the race for points, they will not give you anything. Another thing is the database of lyrics, which has been replenished every day since the beginning of Musixmatch's existence, and continues to grow to this day. It is open to absolutely everyone, free of charge.
I apologize for such a long story. In any case, you can get points for free without destroying the database of lyrics. I do not recommend doing this, because it is against the rules for using Musixmatch, however, if you don’t care what the paragraph above says, at least make sure you don’t do the following:
- Don't write bots to translate lyrics (machine-translated texts are just awful)
- Don't write bots to recognize lyrics (STT is shit when used with songs)
- Don't write bots to sync lyrics (as above, STT is a bad idea)
- Don't write bots to check lyrics (they have to be checked by human)
- Don't write bots to spam lyrics (oh my god why)
- Don't write bots to spam translations (same as above)
- Don't write bots at all
Using the library is quite simple. A complete list of samples is under development, until it's ready I'll leave some usage examples:
MusixmatchToken class represents the Musixmatch client token, that is used in all the client requests.
It can be requested from Musixmatch:
MusixmatchToken token = new MusixmatchToken();Or it can be extracted from Musixmatch desktop application and used in the library:
MusixmatchToken token = new MusixmatchToken("MyToken");Also, a token requested from Musixmatch has limited capabilities (let's call it guest token) until you log in through the browser:
MusixmatchToken token = new MusixmatchToken();
Process.Start(token.GetAuthUrl()); // Open a browser with auth linkTo create a MusixmatchClient class you have to pass a MusixmatchToken to its constructor:
MusixmatchToken token = new MusixmatchToken("MyToken");
MusixmatchClient client = new MusixmatchClient(token);Song search:
// Search by query
List<track> tracks = client.SongSearch("Hommarju - Universe");
// Search by artist and track name
List<track> tracks = client.SongSearch("Kobaryo", "Speed Complexxx");
// Search by the lyrics part
List<track> tracks = client.SongSearchByLyrics("Watchin' you every night, to cast a small spell of fright");
// It is also possible to separate lines with '\n'
List<track> tracks = client.SongSearchByLyrics("Just like you never ruined my heart\nLike you never said the words");
// Advanced search by parameters
List<track> tracks = client.SongSearch(new TrackSearchParameters
{
Album = "Heartache Debug", // Album name
Artist = "t+pazolite", // Artist name
Title = "Messed Up Gravity", // Track name
LyricsQuery = "", // Search by the given part of lyrics
Query = "t+pazolite - Messed Up Gravity", // Search query, covers all the search parameters above
HasLyrics = false, // Only search for tracks with lyrics
HasSubtitles = false, // Only search for tracks with synced lyrics
Language = "", // Only search for tracks with lyrics in specified language
Sort = TrackSearchParameters.SortStrategy.TrackRatingDesc // List sorting strategy
});Song lyrics:
// Search for the track and get lyrics
int trackId = client.SongSearch("REDALiCE - Alive").First().TrackId;
Lyrics lyrics = client.GetTrackLyrics(trackId);
string lyricsBody = lyrics.Instrumental != 1 ? lyrics.LyricsBody : "This track is instrumental"; // lyrics.LyricsBody is null when the track is instrumentalSong lyrics (synced):
// Search for the track and get synced lyrics
int trackId = client.SongSearch("REDALiCE - Alive").First().TrackId;
List<LyricsLine> lyrics = client.GetSyncedLyrics(trackId); // Throws ResourceNotFound if the track has no subtitles, check that firstGet track by id:
// Get track by its Musixmatch id
Track track = client.GetTrackById(206481521);
string trackName = track.TrackName;Get track snippet:
// Get track snippet (short line of lyrics to define the song)
int trackId = client.SongSearch("REDALiCE - Alive").First().TrackId;
string snippet = client.GetTrackSnippet(trackId);Submit track synced lyrics:
// Submit track lyrics with time sync (in Musixmatch format)
int trackId = client.SongSearch("REDALiCE - Alive").First().TrackId;
client.SubmitTrackLyricsSynced(trackId, "[{\"text\":\"You make me feel alive\",\"time\":{\"total\":17.33,\"minutes\":0,\"seconds\":17,\"hundredths\":33}}]");Currently this library supports only MusixmatchRequestException. It has a StatusCode property to understand the problem better.
The docs are (a bit) outdated. Check sample project for new usage.
Just star the project so as to understand that it is not useless and I could continue developing it (and become a little happier ^_^)
Eimaen is still waiting for MusixmatchClientLib.Exploits fixes!