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 album
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 this week
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 search and lookup by track, artist, album, ISRC, and chart position, 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 and genre; /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
The Musixmatch apikey is stored in the Jentic vault and appended as a query parameter at execution time. Agents never embed the key in code or prompts, which prevents accidental leaks.
Intent-based discovery
Agents search Jentic with intents like 'get song lyrics' or 'match a track' and Jentic returns the matching Musixmatch operation with its parameter schema, so the agent can call it without browsing the developer portal.
Time to first call
Direct Musixmatch integration including key management, matcher logic, and licensing review typically takes 1-2 days. Through Jentic the search, load, execute flow runs in under an hour.
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 the Jentic vault 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. Read Musixmatch's terms for the display obligations (attribution, length restrictions on free tiers) tied to your plan.
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?
Rate limits depend on the Musixmatch plan tier and are not enforced via the OpenAPI spec. Free developer keys have low daily call ceilings; commercial plans raise the cap. Check response headers for usage indicators and the Musixmatch developer portal for current quotas.
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.
/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