musixmatch.com APImusixmatch.com ↗
Access Musixmatch lyrics, song metadata, artist profiles, discographies, and translations via 7 structured endpoints. No official API key required.
curl -X GET 'https://api.parse.bot/scraper/63f6e22b-d8f9-4a3f-a671-a3f30a5eca54/get_song_lyrics?language=en&track_vanity=shape-of-you&artist_vanity=ed-sheeran' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve full lyrics for a specific song in a specified language. Returns the complete lyrics text, language, and verification status.
| Param | Type | Description |
|---|---|---|
| language | string | ISO 639-2 language code for the lyrics language (e.g. 'it', 'es', 'fr'). |
| track_vanityrequired | string | Track vanity ID (slug from URL, e.g. 'shape-of-you'). |
| artist_vanityrequired | string | Artist vanity ID (slug from URL, e.g. 'ed-sheeran'). |
{
"type": "object",
"fields": {
"track": "string track vanity ID",
"artist": "string artist vanity ID",
"lyrics": "string containing the full song lyrics text",
"language": "string ISO language code",
"verified": "boolean or null indicating if lyrics are verified"
},
"sample": {
"data": {
"track": "shape-of-you",
"artist": "ed-sheeran",
"lyrics": "The club isn′t the best place to find a lover...",
"language": "en",
"verified": null
},
"status": "success"
}
}About the musixmatch.com API
The Musixmatch API exposes 7 endpoints covering lyrics retrieval, song metadata, artist profiles, full discographies, and album tracklists from Musixmatch. The get_song_lyrics endpoint returns the complete lyrics text, ISO language code, and a verified flag for any song identified by its URL slug. get_song_details adds moods, themes, writers, and album context. Together these endpoints give developers direct access to the core data found across Musixmatch's catalog.
Lyrics and Song Data
The get_song_lyrics endpoint accepts an artist_vanity and track_vanity (both URL slugs, e.g. ed-sheeran and shape-of-you) plus an optional language parameter as an ISO 639-2 code. It returns the full lyrics string, the detected language, and a verified boolean indicating whether the lyrics have been confirmed by the community. The get_song_details endpoint returns the same song's title, moods array, themes array, writers list, a structured album object (name, id, release_date, type, track_count), and a meaning object containing an explanation when one is available.
Translations and Multilingual Coverage
get_song_translations returns a translations object that maps ISO language codes to integer completion percentages, showing how much of a song's lyrics have been translated into each supported language. This makes it straightforward to determine whether a full translation exists before attempting to fetch it.
Artist Profiles and Discographies
get_artist_profile returns an artist's name, genres array, popular_songs list (each with title, album, and vanity_id), and a discography_summary with album_count and single_count. For the full catalog, get_artist_discography returns an array of release objects including id, type (album or single), title, vanity_id, track_count, and release_year as a millisecond timestamp.
Albums and Discovery
get_album_details accepts an artist_vanity and album_vanity (the slug portion from vanity_id returned by get_artist_discography) and returns the full tracklisting as an array of objects with title, id, has_lyrics, and vanity_id per track. The get_discover_feed endpoint requires no parameters and returns trending chart_artists, top_lyric_videos with YouTube URLs, curated community_featured cards, and a genres list — useful for building browseable music interfaces without any seed query.
- Display full song lyrics with language and verification status in a music player app using
get_song_lyrics. - Build a multilingual lyric site by checking translation completion percentages via
get_song_translationsbefore rendering. - Show song mood and theme tags alongside lyrics using the
moodsandthemesarrays fromget_song_details. - Generate artist discography pages with album type, track count, and release year from
get_artist_discography. - Populate album detail views with full tracklists and
has_lyricsflags usingget_album_details. - Seed a music discovery feed with chart artists, lyric videos, and genre categories from
get_discover_feed. - Surface songwriter credits alongside lyrics using the
writersarray inget_song_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Musixmatch have an official developer API?+
What does the `verified` field in `get_song_lyrics` actually indicate?+
verified field is a boolean (or null) that reflects whether the lyrics for that song have been marked as verified by Musixmatch's community or editorial process. A null value typically means verification status is unknown or not applicable for that track.Does the API support searching for songs or artists by name or keyword?+
artist_vanity or track_vanity slug. The get_discover_feed endpoint provides trending artists and tracks without a query, but there is no free-text search endpoint. You can fork this API on Parse and revise it to add a search endpoint.Are time-synced (LRC) or line-by-line lyrics available?+
get_song_lyrics endpoint returns lyrics as a single full-text string without timestamps or line-level metadata. You can fork this API on Parse and revise it to add a synced-lyrics endpoint if that data is exposed on the source pages you target.How should I construct vanity IDs to use as input parameters?+
artist_vanity is ed-sheeran. For a track it is the slug that appears after the artist in the URL. For albums, the album_vanity is the slug portion that follows the artist segment in the vanity_id field returned by get_artist_discography.