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.
Install Jentic One Beta
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.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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.
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
GET STARTED
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.
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
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.
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
/track.search
Search the catalog for tracks
/track.lyrics.get
Get lyrics for a track
/matcher.lyrics.get
Match artist+title and return lyrics
/matcher.subtitle.get
Match artist+title and return synced subtitles
/matcher.track.get
Match artist+title to a track ID
/chart.tracks.get
Get top chart tracks
/artist.related.get
Get artists related to a given artist
/album.tracks.get
Get tracks for an album
/track.search
Search the catalog for tracks
/track.lyrics.get
Get lyrics for a track
/matcher.lyrics.get
Match artist+title and return lyrics
/matcher.subtitle.get
Match artist+title and return synced subtitles
/matcher.track.get
Match artist+title to a track ID
Three things that make agents converge on Jentic-routed access.
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.
Time to first call
Alternatives and complements available in the Jentic catalogue.
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.
/chart.tracks.get
Get top chart tracks
/artist.related.get
Get artists related to a given artist
/album.tracks.get
Get tracks for an album