Musixmatch API
0
AI ReadinessNon-Ready (F)0/100
Official vendor OpenAPI document · agent-readyMediaAudio ProcessingapiKey16 EndpointsREST
For Agents
Search and retrieve licensed song lyrics, translations, charts, and music metadata from Musixmatch. Returns lyric text, synced subtitles, and snippets across 16 search and lookup operations.
Use for: I need to display the lyrics for a song in my app, Search for a track by artist and title, Retrieve synced karaoke subtitles for a track, List the top chart tracks in the United States
Not supported: Does not stream audio, sell music, or generate lyrics from scratch - use for licensed lyrics search, retrieval, and music metadata only.
The Musixmatch API provides legal access to a licensed catalog of song lyrics, translations, and music metadata covering millions of tracks. It supports track and artist search, lookup of tracks, artists, and albums by their Musixmatch IDs, ranked country charts, plus matcher endpoints that resolve a track from artist+title strings to canonical Musixmatch identifiers. Subtitle and snippet endpoints return synced lyric lines for karaoke and follow-along experiences.
Install Jentic One Beta
Connect the Musixmatch API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Musixmatch API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmusixmatch.com%2Fmusixmatch" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmusixmatch.com%2Fmusixmatch" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Musixmatch API.
Search the lyrics catalog by track title, artist, or a word in the lyrics
Retrieve full lyric text or a short snippet for a matched track
Pull synced subtitle lines for karaoke and follow-along playback
Resolve a track from artist and title strings via the matcher endpoints
Look up artist albums, related artists, and album track lists
Get top chart artists and tracks for a given country
Match a track to its lyrics using just the artist name and title
Use Cases
Patterns agents use Musixmatch API for, with concrete tasks.
★ In-App Lyrics Display
Show licensed lyrics inside a music app or web player without managing licensing deals individually with publishers. The /track.lyrics.get endpoint returns the lyric text for a known track ID; /matcher.lyrics.get accepts artist+title and returns lyrics in one call. Musixmatch handles the rights coverage that ad-hoc lyric scraping would violate.
Call GET /matcher.lyrics.get with q_artist and q_track for the currently playing song and render the returned lyric text in the player UI.
Karaoke and Synced Subtitles
Drive a karaoke experience with line-by-line synced lyrics that highlight as the track plays. The /matcher.subtitle.get endpoint returns subtitle lines with timestamps that a player can step through using the audio's current position. Subtitles are licensed for follow-along display alongside playback.
Call GET /matcher.subtitle.get with the artist and title and the audio duration, then drive a karaoke UI from the returned timed lines.
Music Discovery via Charts and Related Artists
Surface trending tracks and adjacent artists for editorial pages and recommendation widgets. /chart.tracks.get and /chart.artists.get return ranked lists for a country; /artist.related.get returns artists frequently listened to alongside a target artist. These power 'top this week' and 'fans also like' modules without operating a recommendation pipeline.
Call GET /chart.tracks.get for country=US to render the current top 10 tracks, then call /artist.related.get for each top artist to populate a 'fans also like' row.
Track Matching for Catalog Reconciliation
Reconcile track listings from external systems against Musixmatch identifiers to attach lyrics and metadata. The /matcher.track.get endpoint maps an artist+title pair to a canonical commontrack_id, which downstream systems store for stable lookups. This pattern is the same one used by streaming clients to attach lyrics to a now-playing track.
For each track in an external playlist, call GET /matcher.track.get with q_artist and q_track and store the returned commontrack_id.
AI Agent Lyrics Lookup
Equip a Jentic-driven agent with licensed lyrics access for chat experiences and creative tools. The agent searches Jentic for 'get song lyrics' and Jentic returns the GET /matcher.lyrics.get operation with its parameter schema. Jentic injects the apikey query parameter at execution time so the credential never enters the agent's prompt.
Through Jentic, search for 'get song lyrics by artist and title', load GET /matcher.lyrics.get, and return the lyric text for a user-specified track.
Key Endpoints
16 endpoints — the musixmatch api provides legal access to a licensed catalog of song lyrics, translations, and music metadata covering millions of tracks.
METHOD
PATH
DESCRIPTION
GET
/track.search
Search the catalog for tracks
GET
/track.lyrics.get
Get lyrics for a track
GET
/matcher.lyrics.get
Match artist+title and return lyrics
GET
/matcher.subtitle.get
Match artist+title and return synced subtitles
GET
/matcher.track.get
Match artist+title to a track ID
GET
/chart.tracks.get
Get top chart tracks
GET
/artist.related.get
Get artists related to a given artist
GET
/album.tracks.get
Get tracks for an album
GET
/track.search
Search the catalog for tracks
GET
/track.lyrics.get
Get lyrics for a track
GET
/matcher.lyrics.get
Match artist+title and return lyrics
GET
/matcher.subtitle.get
Match artist+title and return synced subtitles
GET
/matcher.track.get
Match artist+title to a track ID
GET
/chart.tracks.get
Get top chart tracks
GET
/artist.related.get
Get artists related to a given artist
GET
/album.tracks.get
Get tracks for an album
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
M
Musixmatch API
- Non-Ready (F)0/100
99
Foundational Compliance56
Developer Experience & Jentic Compatibility6
AI-Readiness & Agent Experience94
Agent Usability15
Security0
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
99
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
97%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
56
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: CSignals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
25%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
6
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: FSignals: 4
22%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
0%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
0%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
15
Security
Trust, risk posture, and security compliance.
Grade: FSignals: 1
15%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
0
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: FSignals: 1
0%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Musixmatch API by hand means appending its apikey as a query parameter on every call and learning its dotted operation names like track.lyrics.get and matcher.track.get yourself. Through Jentic you install once, import the Musixmatch API from the API Directory, store the apikey once, and your agent calls it.
Permission scoping
Search and lookup targets travel as request parameters, so limit the agent to the operations it needs, such as searching tracks or getting lyrics. You choose which operations are in scope, and nothing beyond those reads is reachable.
Credential isolation
Your Musixmatch apikey is stored once, encrypted, by your own Jentic One instance and appended as the query parameter at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get song lyrics' or 'match a track to its lyrics', and Jentic returns the matching Musixmatch operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Musixmatch API through Jentic.
What authentication does the Musixmatch API use?
Musixmatch uses an API key passed as the apikey query parameter on every request. Through Jentic, the apikey is stored in your Jentic One instance and appended to each request at execution time, so the key never appears in agent code or logs.
Can I display licensed lyrics in my app with the Musixmatch API?
Yes. GET /track.lyrics.get and GET /matcher.lyrics.get return licensed lyrics that publishers permit Musixmatch to relicense to API consumers. Musixmatch's pre-launch checklist on docs.musixmatch.com sets the display conditions: show the `lyrics_copyright` value you receive whenever you display lyrics, apply the country restrictions returned with the content, add the lyrics tracking script, and show the 'Lyrics powered by' image linked to the backlink URL returned with the lyrics. Read the API terms of service to confirm your application complies.
How do I match a now-playing track to its lyrics through Jentic?
Through Jentic, search for 'match a track and get lyrics', load the GET /matcher.lyrics.get operation, and submit the artist and title strings. Jentic appends the apikey, calls Musixmatch, and returns the lyric body to your agent.
What are the rate limits for the Musixmatch API?
The OpenAPI spec declares no rate-limit fields, headers, or extensions, so no ceiling is visible in the specification itself. Musixmatch enforces per-day request limits on its own side and reports a usage-limit status inside the response body rather than in HTTP headers, and its pre-launch checklist tells you to check your API call limits against the traffic you expect. Read the figures that apply to your account on docs.musixmatch.com.
Can I retrieve synced subtitles for karaoke?
Yes. GET /matcher.subtitle.get returns lyric lines with timestamps suitable for synchronized highlighting during playback. Pair this with the audio duration so Musixmatch can align the subtitle file to your specific audio source.
Does the Musixmatch API expose chart data?
Yes. GET /chart.tracks.get and GET /chart.artists.get return ranked lists by country, which power 'trending now' modules without operating a separate analytics pipeline.
Is there a Musixmatch MCP server?
You don't need an MCP server to give your agent Musixmatch. Jentic connects it directly from the API Directory: import the Musixmatch API, store your apikey once, and your agent can search tracks, match an artist and title, and pull lyrics or synced subtitles, with no extra tool definitions loaded into its context.
Can I limit what my agent is allowed to do with the Musixmatch API?
Yes. Because you run Jentic One yourself, your own rules decide which Musixmatch operations and credentials the agent may use, so you can grant only the reads it needs, such as GET /track.search and GET /matcher.lyrics.get, while leaving chart and matcher operations out of scope. Search and lookup targets travel as request parameters, so the agent can only reach the operations you have put in scope and nothing beyond those reads. Your Musixmatch apikey is held by your Jentic One instance and appended at execution time, so it never enters the agent's prompt or logs.
GET STARTED