canonical: https://jentic.com/apis/lyrics.simpmusic.org/lyrics-simpmusic # Lyrics Simpmusic SimpMusic Lyrics API The SimpMusic Lyrics API serves synced and plain song lyrics along with community-contributed translations. It lets a caller look up lyrics by video id, search by free text, song title, or artist, fetch translated lyrics by language, and contribute new lyrics, translations, and votes. Read and search endpoints are public, while contribution endpoints are signed with an HMAC header. ## For AI agents Look up and search synced or plain song lyrics, fetch community translations, and contribute lyrics or votes through the SimpMusic Lyrics API. ## Scope Does not stream audio, host music files, or manage playlists. Use for retrieving, searching, and contributing song lyrics and translations only. ## Capabilities - Look up synced or plain lyrics by video id - Search lyrics by free text, song title, or artist - Fetch community translations by video id and language - Contribute a new lyric or a translated lyric - Vote on the accuracy of a lyric or a translation ## Use cases ### Serve lyrics to an AI agent An AI agent integration created through Jentic needs the words to a track. The SimpMusic Lyrics API returns synced or plain lyrics for a video id and supports search by title or artist, so the agent can fetch and display lyrics inside a music or chat experience without maintaining its own lyrics store. Example prompt: Search lyrics by song title, then fetch the synced lyrics for the matching video id ### Show translated lyrics Listeners often want lyrics in another language. The SimpMusic Lyrics API fetches community translations for a video id and a specific language, so an automation can present a translated version alongside the original and fall back to the plain lyrics when no translation exists. Example prompt: Fetch the translated lyrics for a video id in a chosen language ### Crowdsource lyric contributions Missing or wrong lyrics improve through contributions. The SimpMusic Lyrics API lets a caller submit a new lyric or translation and vote on accuracy, so an agent can add lyrics it has verified and raise the ranking of correct entries, with contribution calls signed by an HMAC header. Example prompt: Submit a new lyric for a video id and vote on an existing translation ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/v1/search` | Search lyrics | | GET | `/v1/{videoId}` | Get lyrics by video ID | | POST | `/v1` | Create a new lyric | | POST | `/v1/vote` | Vote for a lyric | | GET | `/v1/translated/{videoId}` | Get translated lyrics by video ID | | POST | `/v1/translated` | Create a translated lyric | | GET | `/v1/search/artist` | Search lyrics by artist | ## Key resources - **Lyrics** — Create lyrics and get synced or plain lyrics by video id - **Translations** — Create and fetch translated lyrics by video id and language - **Votes** — Vote on the accuracy of lyrics and translations - **Search** — Search lyrics by free text, song title, or artist ## AI readiness 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. - **Score:** 68 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 68 / 100 - AI-Readiness & Agent Experience: 54 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 71 / 100 - **View full report:** https://jentic.com/apis/lyrics.simpmusic.org/lyrics-simpmusic/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the SimpMusic Lyrics API by hand means signing contribution requests with an HMAC header while leaving read and search calls unauthenticated. Through Jentic you install once, import SimpMusic Lyrics from the API Directory, store the signing key once, and your agent calls it. - **Permission scoping:** The video id sits in the URL path for reads, so a rule can keep your agent read-only by allowing only the lookup and search operations. You choose the operations it may call, so contribution operations like creating lyrics or voting are not included unless you add them. - **Credential handling:** Your SimpMusic signing key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get lyrics by video id' or 'search lyrics by artist', and Jentic returns the matching SimpMusic Lyrics operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Musixmatch** — Musixmatch is a large commercial lyrics catalog; SimpMusic Lyrics is a community-contributed lyrics and translation API. - **MusicBrainz** — MusicBrainz provides open music metadata; pair it with SimpMusic Lyrics to match tracks to artists and releases. - **Last.fm** — Last.fm exposes listening data and track info; pair it with SimpMusic Lyrics to add lyrics to scrobbled tracks. ## FAQ ### What authentication does the SimpMusic Lyrics API use? The read and search endpoints of the SimpMusic Lyrics API are public and need no credential, while the contribution endpoints that create lyrics, add translations, or vote require an HMAC signature in the X-HMAC header, per its OpenAPI spec. Through Jentic the signing key is stored encrypted by your own Jentic One instance and injected at call time. ### Can I search for lyrics with the SimpMusic Lyrics API? Yes. The search endpoint accepts free text, and dedicated endpoints search by song title or artist, so an agent can find a track and then fetch its synced or plain lyrics by video id. ### What are the rate limits for the SimpMusic Lyrics API? The SimpMusic Lyrics API spec documents a limit of 30 requests per minute per IP address, applied across all endpoints, with rate-limit headers returned on responses. Design agent flows to stay within that ceiling and back off when it is reached. ### How do I fetch song lyrics through Jentic? Install Jentic One on your own infrastructure with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then import the SimpMusic Lyrics API from the API Directory and search for 'get song lyrics by video id'. Reads need no credential, and storing the HMAC key once lets your agent contribute too. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Is there a SimpMusic Lyrics MCP server? You don't need an MCP server to give your agent the SimpMusic Lyrics API. Jentic connects it directly from the API Directory: import it, and your agent calls the public read endpoints or signs contributions, with operations discovered on demand instead of loaded into the agent's context. ### Can I limit what my agent is allowed to do with the SimpMusic Lyrics API? Yes. The video id sits in the URL path for reads, so a rule can allow only the lookup and search operations, keeping the agent read-only while contribution operations like creating lyrics or voting stay out of reach unless you add them. Every action it takes is recorded in an audit log.