Musixmatch API

Musixmatch lyrics, translations, meanings and credits, as JSON

Musixmatch (musixmatch.com) is the largest lyrics catalogue on the web, with community translations, song credits and song-meaning notes.

endpoints
25
credits per call
0–3

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

25 active endpoints, on 0, 2 and 3 credit tiers.

  • POST/musixmatch/v1/search2 credits
  • POST/musixmatch/v1/search_artists2 credits
  • POST/musixmatch/v1/track3 credits
  • POST/musixmatch/v1/lyrics2 credits
  • POST/musixmatch/v1/translation2 credits
  • POST/musixmatch/v1/analysis2 credits
  • POST/musixmatch/v1/structure2 credits
  • POST/musixmatch/v1/credits2 credits
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Musixmatch API

5 of 25 endpoints, ready to run

View docs ↗

A song's full lyrics with lines, stanzas, language and writers

2 credits1 required · 0 optional
POST/musixmatch/v1/lyrics
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Musixmatch endpoints does ReefAPI ship?

25 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

25 endpoints

search

2 cr

Search Musixmatch's song catalogue by free text, title, artist, title + artist, a lyrics phra…

required
—
optional
—

search_artists

2 cr

Search Musixmatch artists by name.

required
query
optional
—

track

3 cr

One song in full.

required
—
optional
—

lyrics

2 cr

The full lyrics of one song in one light call.

required
—
optional
—

translation

2 cr

A song's lyrics translated line by line into one language, as Musixmatch's community publishe…

required
language
optional
—

analysis

2 cr

What a song is about, as its musixmatch.com page states it.

required
—
optional
—

structure

2 cr

A song's structure as its musixmatch.com page marks it.

required
—
optional
—

credits

2 cr

Everyone credited on a song (songwriters, composers, producers, performers, engineers …) with…

required
—
optional
—

writers

2 cr

The songwriters registered for a song with their role code (CA composer and lyricist, C compo…

required
—
optional
—

contributions

2 cr

Who transcribed, synced, structured and verified a song's lyrics on Musixmatch.

required
—
optional
—

tracks

2 cr

Up to 100 songs by Musixmatch id in ONE upstream request (Musixmatch's own batch endpoint), e…

required
ids
optional
—

artist

2 cr

One artist in full.

required
artist
optional
—

artist_albums

2 cr

An artist's discography.

required
artist
optional
—

artist_tracks

2 cr

Every song by an artist, most popular first by default, with the same filters as search (has…

required
artist
optional
—

artist_collaborators

2 cr

Every songwriter, producer and musician credited with an artist, with their roles, as the art…

required
artist
optional
—

album

2 cr

One album.

required
album
optional
—

creator

2 cr

A songwriter / producer / musician profile from musixmatch.com/creator.

required
creator
optional
—

creator_credits

2 cr

The songs a songwriter / producer is credited on, with their roles on each, as the creator pa…

required
creator
optional
—

charts

2 cr

Musixmatch song charts for a country.

required
—
optional
—

chart_artists

2 cr

Musixmatch's artist chart for a country, each row the full artist record with its chart posit…

required
—
optional
—

discover

2 cr

Musixmatch's discover page.

required
—
optional
—

translated_tracks

2 cr

Songs whose lyrics are translated into a language (Musixmatch's 'translated' discover list),…

required
language
optional
—

genres

0 cr

Every Musixmatch music genre with its id, parent id and full name.

required
—
optional
—

languages

0 cr

Every language Musixmatch knows (2-letter and 3-letter codes, name).

required
—
optional
—

countries

0 cr

Every country code Musixmatch's charts accept, with the country name.

required
—
optional
—

Every parameter, every allowed value →

Missing a Musixmatch endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Musixmatch API works

Musixmatch is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

02
Call
POST /musixmatch/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
0 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a song name to its lyrics, translation and credits

Search once, then open the song by its Musixmatch id.

01search?title=hello&artist=adele
GET/musixmatch/v1/search?title=hello&artist=adele

28 matches; the first is Adele's Hello, commontrack_id 47305969, with its ISRC, Spotify ids and flags.

02track?track=47305969
GET/musixmatch/v1/track?track=47305969

Lyrics, 13 structure sections, meaning and moods, 7 credits, 58 translation languages, the album and 1 video.

03translation?track=69032569&language=es
GET/musixmatch/v1/translation?track=69032569&language=es

Every lyrics line next to its Spanish translation (88 of 88 for Shape of You).

04credits?track=69032569
GET/musixmatch/v1/credits?track=69032569

17 people with their roles, grouped as songwriter, production and musician.

A song record with its lyrics, translations, meaning and full credits, ready to store or display.

request
curl -X POST https://api.reefapi.com/musixmatch/v1/lyrics \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"track":"Ed-Sheeran/Shape-of-You"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "musixmatch",
    "endpoint": "lyrics",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Musixmatch field actually contains

Fields that read differently from how they look. Every row was measured against live musixmatch.com on 2026-11-19.

FieldWhat it holds
commontrack_idMusixmatch's song id: one id for all releases of a song (single, album, deluxe). `track_id` is the id of one release. Every action that takes a song accepts the commontrack id, 'Artist/Track' from the song URL, the musixmatch.com link, an ISRC or a Spotify track id.
lyrics.body / lines / stanzasThe lyrics text exactly as Musixmatch publishes it (line breaks kept), the non-empty lines, and the lines grouped by blank-line stanzas. On 8 of 8 songs checked the text equalled the song page.
lyrics.available / restrictedMusixmatch withholds some lyrics from its own site (several Japanese titles in our sample): available is false, body is null and copyright carries Musixmatch's notice "Unfortunately we're not authorized to show these lyrics."
lyrics.copyrightThe "Writer(s): …" line Musixmatch prints under the lyrics.
has_subtitles / has_richsyncWhether Musixmatch holds line-synced and word-synced lyrics for the song. The synced lyrics themselves are not available without a Musixmatch account and are not returned.
rating / favouritesMusixmatch's own 0-100 track rating (Shape of You: 90) and how many Musixmatch users saved the song (59,653). Neither is a stream count.
analysisThe song page's "meaning" paragraph, its main moods, its main themes each with quoted lines, and the age rating with its reason (Shape of You: PG-13). Null when the page shows none.
translations_availableEvery language the lyrics are translated into, with % of lines done (Shape of You: 22 languages; Adele's Hello: 58).
redirected_fromSet when musixmatch.com serves a different song page for the 'Artist/Track' you asked: the site itself sends Queen/Bohemian-Rhapsody to Queen/Don-t-Stop-Me-Now. The record returned is the one the site serves.

`total` on searches is Musixmatch's own count, which it caps at 10,000; pages stop at row 10,000. With the default relevance order Musixmatch's later pages can repeat rows (49 repeats over 4 pages of 50 for "taylor swift"); sort=popularity paged with no repeats.

Coverage

Musixmatch coverage, measured

Every number below was read from live musixmatch.com on 2026-11-19: 124 calls over 25 actions, 122 answered and 2 correctly reported as a song without lyrics, plus 8 checks that wrong inputs get the right error.

Checks

On 11 songs in 5 languages, title, artist, album and the synced-lyrics flag equalled the musixmatch.com song page 11 of 11 times, and the lyrics text equalled the page on 8 of 8 songs that have visible lyrics. Search results resolved to the same song in `tracks` 5 of 5 times.

Filters

Every search filter changed the count: "hello adele" 225 → has lyrics 73, synced lyrics 34, instrumental 19, Pop genre 24, English lyrics 60, released since 2016 135. Unknown chart countries are refused instead of silently answering the US chart.

Fields

Title, artist, album, duration, rating and release date were filled on every one of 1,024 rows; ISRC on 89-98% of rows per list, Spotify id 80-97%, cover art 77-98%.

Paging

Up to 100 rows per page and row 10,000 (Musixmatch caps its counts at 10,000). Sorted by popularity, four consecutive pages repeated no row on four lists; Musixmatch's relevance order can repeat rows on later pages. Ed Sheeran's 228 releases came back over 3 pages with no overlap.

Limits

Synced (time-stamped) lyrics and Musixmatch's autocomplete are not available without an account. Some lyrics are withheld by Musixmatch itself (several Japanese songs). Charts hold up to 100 songs, the translated-songs list 100 per language, a songwriter page up to 100 credits.

Use cases

What people build with Musixmatch

The jobs this data is most often used for.

25

endpoints

0/2/3

credits per call

01

Show full lyrics and translations in a music, karaoke or language-learning app.

02

Match a Spotify or Apple Music catalogue to lyrics through ISRC and Spotify ids.

03

Build songwriter and producer credit databases for publishing research.

04

Track which songs trend in each country's Musixmatch charts.

Pricing

What Musixmatch data costs

The cheapest call here is 0 credits, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 746 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/musixmatch/v1/lyrics \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"track":"Ed-Sheeran/Shape-of-You"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/musixmatch/v1/lyrics",
    headers={"x-api-key": REEF_KEY},
    json={
        "track": "Ed-Sheeran/Shape-of-You"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Musixmatch.

Does it return the full lyrics?▾

Yes, the full text as Musixmatch shows it on its own song page, with lines and stanzas (Shape of You: 88 lines). Songs Musixmatch itself withholds come back with available: false and Musixmatch's notice.

Can I get synced (time-stamped) lyrics?▾

No. Musixmatch does not serve its line- or word-synced lyrics without an account. `has_subtitles` and `has_richsync` tell you whether a song has them.

How do I find a song's lyrics from a Spotify link or an ISRC?▾

Pass it as `track`: a Spotify track link or id, an ISRC like GBAHS1600463, a musixmatch.com link, 'Artist/Track' or the Musixmatch id all work in `lyrics`, `track`, `translation`, `credits` and the other song actions. Or pass `title` and `artist`: plain letters work (title simarik, artist tarkan finds Tarkan's Şımarık).

Which translations are there?▾

`track` lists every language a song is translated into with the % done; `translation` returns the lyrics line by line next to the translation for one language, as Musixmatch's community published it (Adele's Hello into French: 48 of 48 lines).

Can I search inside lyrics?▾

Yes: `search` with `lyrics` matches a phrase inside the lyrics ("is this the real life is this just fantasy" → Queen's Bohemian Rhapsody first). It also searches by title, artist, title + artist, free text and songwriter, filtered by lyrics language, genre, has lyrics, has synced lyrics, instrumental and release dates.

Who wrote and produced a song?▾

`credits` lists everyone credited with their roles and role group (songwriter, production, musician; Shape of You: 17 people), `writers` gives the registered songwriters, and `creator` opens a songwriter's profile with up to 100 credited songs.

Which charts are there?▾

Top, hot (trending), weekly and weekly new songs per country, up to 100 songs each (UK hot: 94 on 2026-11-19; checked for the US, UK, Italy, Brazil, Japan and Germany), plus an artist chart per country. `countries` lists the 251 country codes Musixmatch accepts.

How fresh is the data?▾

Every call reads Musixmatch live. Only the genre, language and country lists are kept for up to a day.

What is the Musixmatch API?▾

Musixmatch API is a ReefAPI endpoint group for 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. It returns live JSON through POST requests under /musixmatch/v1.

Is the Musixmatch API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Musixmatch calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Musixmatch login or account?▾

No login to Musixmatch is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Musixmatch data?▾

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Musixmatch API use?▾

Musixmatch actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Musixmatch from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call musixmatch actions with the same key, credit pool and JSON envelope used by normal REST requests.

Same key

47 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Musixmatch, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-19.