Musixmatch
Musixmatch song lyrics as JSON: the full lyrics text, line-by-line translations, song meaning, moods and themes, credits, song structure, writers, ISRC / Spotify / iTunes ids, track search with filters, artists, albums and country charts.
/musixmatch/v1/search2 creditsSearch Musixmatch's song catalogue by free text, title, artist, title + artist, a lyrics phrase or songwriter, with filters for artist id, genre, lyrics language, has lyrics, has synced lyrics, instrumental and first-release date range, and 5 sort orders. Each row is the full track record (ids incl. ISRC / Spotify / iTunes, album, duration, rating, flags, genres). `total` is Musixmatch's own count, which it caps at 10,000; real paging up to 100 per page and row 10,000 (no repeated rows across pages on the popularity / oldest orders, measured on 4 lists × 4 pages; relevance pages can repeat).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free text matched against title, artist and lyrics (Musixmatch `q`). |
| title | optional | — | Match the song title only. |
| artist | optional | — | Match the artist name only. |
| title_artist | optional | — | Match words against title and artist together. |
| lyrics | optional | — | Match a phrase inside the lyrics. |
| writer | optional | — | Match the songwriter name. |
| artist_id | optional | — | Only songs by this Musixmatch artist id. |
| genre_id | optional | — | Only songs in this Musixmatch genre id (see `genres`; 14 = Pop). |
| lyrics_language | optional | — | Only songs whose lyrics are in this language: 2-letter code, 3-letter code or English name (see `languages`). |
| has_lyrics | optional | — | true = only songs with lyrics on Musixmatch. |
| has_synced_lyrics | optional | — | true = only songs that have time-synced lyrics on Musixmatch. |
| instrumental | optional | — | true = only instrumental songs. |
| released_after | optional | — | Only songs first released on or after this date (YYYY-MM-DD or a year). |
| released_before | optional | — | Only songs first released on or before this date (YYYY-MM-DD or a year). |
| sort = auto | optional | auto · relevance · popularity · least_popular · artist_popularity · oldest | auto (default), relevance, popularity, least_popular, artist_popularity or oldest. auto = popularity when Musixmatch matches fewer than its 10,000-row cap (an exact lyrics line or name: 'is this the real life is this just fantasy' → Queen's Bohemian Rhapsody first of 2,733), otherwise relevance (loose words, where popularity surfaces unrelated popular songs); `sort_used` says which. Measured on 7 famous lyrics lines: auto put a song with the right title first 7/7 and the original artist first 4/7 (the other 3 match loosely and Musixmatch ranks covers first). relevance pages repeat rows (49 repeats across 4 pages of 50 for 'taylor swift'); popularity and oldest page without repeats, so walk deep lists with sort=popularity. Newest-first is not offered: Musixmatch answers it with 0-1 rows. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 20 | optional | 1–100 | Rows per page, 1-100 (Musixmatch's own maximum is 100, measured). Pages stop at row 10,000 (page × per_page ≤ 10,000). |
/musixmatch/v1/search_artists2 creditsSearch Musixmatch artists by name. Each row is the full artist record (aliases, genres, rating, social links, Spotify / iTunes / 7digital ids, MusicBrainz id). Musixmatch's own total, 100 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Artist name to search. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 20 | optional | 1–100 | Rows per page, 1-100 (Musixmatch's own maximum is 100, measured). Pages stop at row 10,000 (page × per_page ≤ 10,000). |
/musixmatch/v1/track3 creditsOne song in full — everything its musixmatch.com page shows plus the API record: full lyrics text (lines and stanzas), lyrics language, copyright / writers line, the lyrics contributor, song structure (verse / chorus / bridge with their lines), meaning, moods, themes with quotes and audience rating, credits with roles, translation coverage per language, contributor history, the album with its track list, YouTube videos, the most famous line, and the full id set (ISRCs, Spotify, iTunes, 7digital, SoundCloud), duration, rating, genres and the has_subtitles / has_richsync (synced lyrics) flags.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/lyrics2 creditsThe full lyrics of one song in one light call: text, lines, stanzas, language, copyright line, writers with their role codes, publishers, explicit / instrumental / verified flags.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/translation2 creditsA song's lyrics translated line by line into one language, as Musixmatch's community published it: each lyrics line next to its translation, plus the raw translation rows (translator id and roles, dates). The languages a song is translated into, with % complete, are in `track`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| language | required | — | Target language: 2-letter code (es), 3-letter code (spa) or English name (spanish). |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/analysis2 creditsWhat a song is about, as its musixmatch.com page states it: the meaning paragraph, main moods, main themes each with quoted lines, and the audience (age) rating with its reason.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/structure2 creditsA song's structure as its musixmatch.com page marks it: sections in order (intro, verse, pre-chorus, chorus, bridge, outro …) each with its lyrics lines.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/credits2 creditsEveryone credited on a song (songwriters, composers, producers, performers, engineers …) with each person's roles and the role group (Songwriter, Production, Performer, Engineering …), as the musixmatch.com credits page lists them, plus the track record.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/writers2 creditsThe songwriters registered for a song with their role code (CA composer and lyricist, C composer, A lyricist …).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/contributions2 creditsWho transcribed, synced, structured and verified a song's lyrics on Musixmatch: the lyrics author (name, rank, score) and the contribution history (who, what, when, human or AI).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| track | optional | — | The song: Musixmatch id (`69032569`), 'Artist/Track' as in the song URL (`Ed-Sheeran/Shape-of-You`), a musixmatch.com/lyrics link, an ISRC (`GBAHS1600463`) or a Spotify track id / link. Or pass `title` (+ `artist`) instead. An 'Artist/Track' or link Musixmatch does not have under that exact address (plain letters for Şımarık, a typo) is looked up by its artist and title words, and the answer says so in `resolved_by_search`. |
| title | optional | — | Find the song by its title instead of `track` (plain letters work: simarik = Şımarık). |
| artist | optional | — | With `title`: the artist, to pick the right song. |
| isrc | optional | — | Look the song up by ISRC instead of `track`. |
| spotify_id | optional | — | Look the song up by Spotify track id (or open.spotify.com/track link). |
| itunes_id | optional | — | Look the song up by Apple Music / iTunes track id. |
| track_id | optional | — | Musixmatch's per-release track id (the song page's `track_id`, not the commontrack id). |
/musixmatch/v1/tracks2 creditsUp to 100 songs by Musixmatch id in ONE upstream request (Musixmatch's own batch endpoint), each the full track record. Ids Musixmatch does not know are listed in `missing`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| ids | required | — | Up to 100 Musixmatch song ids (commontrack ids), as a list or comma-separated. |
/musixmatch/v1/artist2 creditsOne artist in full: the API record (aliases, genres, rating, social links, MusicBrainz / Spotify / iTunes / 7digital ids, active dates) plus everything the artist page shows — image, top songs, albums, every credited collaborator with roles, upcoming concerts, lyric videos, top contributors.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | The artist: Musixmatch artist id (`49581672`), the URL name (`Ed-Sheeran`) or a musixmatch.com/artist link. |
/musixmatch/v1/artist_albums2 creditsAn artist's discography: albums, EPs and singles, newest or oldest first, 100 per page with Musixmatch's own total. `group_editions` merges editions of the same album (Ed Sheeran: 228 releases → 147 grouped, measured).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | The artist: Musixmatch artist id (`49581672`), the URL name (`Ed-Sheeran`) or a musixmatch.com/artist link. |
| sort = newest | optional | newest · oldest | newest (default) or oldest release first. |
| group_editions | optional | — | true = one row per album name (editions merged). |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 20 | optional | 1–100 | Rows per page, 1-100 (Musixmatch's own maximum is 100, measured). Pages stop at row 10,000 (page × per_page ≤ 10,000). |
/musixmatch/v1/artist_tracks2 creditsEvery song by an artist, most popular first by default, with the same filters as `search` (has lyrics, has synced lyrics, language, genre, dates). Musixmatch's own total; 100 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | The artist: Musixmatch artist id (`49581672`), the URL name (`Ed-Sheeran`) or a musixmatch.com/artist link. |
| sort = popularity | optional | auto · relevance · popularity · least_popular · artist_popularity · oldest | popularity (default), relevance, least_popular, artist_popularity or oldest (relevance pages can repeat rows). |
| has_lyrics | optional | — | true = only songs with lyrics. |
| has_synced_lyrics | optional | — | true = only songs with time-synced lyrics. |
| lyrics_language | optional | — | Only songs whose lyrics are in this language. |
| released_after | optional | — | First released on or after. |
| released_before | optional | — | First released on or before. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 20 | optional | 1–100 | Rows per page, 1-100 (Musixmatch's own maximum is 100, measured). Pages stop at row 10,000 (page × per_page ≤ 10,000). |
/musixmatch/v1/artist_collaborators2 creditsEvery songwriter, producer and musician credited with an artist, with their roles, as the artist's collaborators page lists them (the page lists them all at once: Ed Sheeran 246, measured).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | The artist: Musixmatch artist id (`49581672`), the URL name (`Ed-Sheeran`) or a musixmatch.com/artist link. |
/musixmatch/v1/album2 creditsOne album: label, copyright and ℗ lines, release date and type, track count, genres, Spotify / iTunes ids, cover art, plus its track list (each the full track record), 100 per page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| album | required | — | Musixmatch album id (`61820619`), 'Artist/Album' as in the album URL (`Ed-Sheeran/Deluxe-3`) or a musixmatch.com/album link. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 100 | optional | 1–100 | Tracks per page, 1-100 (default 100). |
/musixmatch/v1/creator2 creditsA songwriter / producer / musician profile from musixmatch.com/creator: name, aliases, biography, roles, photo, the artists they worked with, and the songs they are credited on.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| creator | required | — | The creator's URL name (`Steve-Mccutcheon`, as linked from `credits`) or a musixmatch.com/creator link. |
/musixmatch/v1/creator_credits2 creditsThe songs a songwriter / producer is credited on, with their roles on each, as the creator page lists them (the page lists at most 100, measured on a creator with more).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| creator | required | — | The creator's URL name or musixmatch.com/creator link. |
/musixmatch/v1/charts2 creditsMusixmatch song charts for a country: top, hot (trending), weekly and weekly new entries. Each row is the full track record with its chart position. A chart holds up to 100 songs (US top: 95, measured); page 2 of a chart is empty.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = us | optional | — | Two-letter country code of the chart (us, gb, it, de, jp, br …). Validated against Musixmatch's own country list (`countries` action); an unknown code is refused, because the API silently answers the US chart for it. |
| chart = top | optional | top · hot · mxmweekly · mxmweekly_new | top (default), hot, mxmweekly or mxmweekly_new. |
| has_lyrics | optional | — | true = only songs with lyrics. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 100 | optional | 1–100 | Rows, 1-100 (default 100). |
/musixmatch/v1/chart_artists2 creditsMusixmatch's artist chart for a country, each row the full artist record with its chart position (US: 67 artists, Japan: 59, measured).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| country = us | optional | — | Two-letter country code of the chart (us, gb, it, de, jp, br …). Validated against Musixmatch's own country list (`countries` action); an unknown code is refused, because the API silently answers the US chart for it. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 100 | optional | 1–100 | Rows, 1-100 (default 100). |
/musixmatch/v1/discover2 creditsMusixmatch's discover page: trending songs, top songs, this week's top in the US and Italy, top albums, top artists, top lyric videos and the genre list — every list it shows.
Try in playground →/musixmatch/v1/translated_tracks2 creditsSongs whose lyrics are translated into a language (Musixmatch's 'translated' discover list), each the full track record. Musixmatch serves 100 songs per language and stops there (page × per_page ≤ 100, measured: the 101st row is never served); popularity order or Musixmatch's own id order.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| language | required | — | 2-letter code, 3-letter code or English name. |
| sort = id | optional | id · popularity | id (default: Musixmatch's own order, lowest song id = oldest catalogue entry first, measured) or popularity. |
| page = 1 | optional | 1– | Page number, 1-based. |
| per_page = 20 | optional | 1–100 | Rows per page, 1-100 (Musixmatch's own maximum is 100, measured). Pages stop at row 10,000 (page × per_page ≤ 10,000). |
/musixmatch/v1/genresfreeEvery Musixmatch music genre with its id, parent id and full name — the ids `search` filters by.
Try in playground →/musixmatch/v1/languagesfreeEvery language Musixmatch knows (2-letter and 3-letter codes, name) — the codes `translation`, `translated_tracks` and the lyrics-language filter take.
Try in playground →/musixmatch/v1/countriesfreeEvery country code Musixmatch's charts accept, with the country name.
Try in playground →curl -X POST https://api.reefapi.com/musixmatch/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"title":"hello","artist":"adele"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.