{"id":"0f948ec3-8f9e-4159-be0a-5442c32c328e","task":"Retrieve lyrics previews via the Musixmatch API and handle the commercial-license restrictions on full lyrics","domain":"developer.musixmatch.com","steps":["Sign up for a Musixmatch developer API key (free tier is intended for development/non-commercial testing with a limited daily call quota)","Resolve the correct track first using a matching method (matching by artist/title, e.g. matcher.track.get) against the `https://api.musixmatch.com/ws/1.1/` base before requesting lyrics, rather than guessing a track ID","Call the lyrics-retrieval method for the matched track to get lyrics content","Expect only a short preview snippet of the lyrics on the free/developer tier — full lyrics and synced (time-aligned) lyrics require a commercial licensing agreement with Musixmatch","Handle a 402-style response as an indicator that you've requested a licensed feature (e.g. full lyrics) not included in your current plan, rather than treating it as a generic error","Cache matched track IDs so repeated lookups for the same song don't re-spend matcher calls against your daily quota"],"gotchas":["Free-tier lyrics responses are intentionally truncated previews, not the full song text — do not assume the field is simply missing due to a bug when it looks cut off","Full lyrics, synced lyrics, and higher-volume commercial usage all require a paid/licensed plan; building a consumer-facing product around full lyrics needs a commercial agreement, not just an API key upgrade","Matching by free-text artist/title is fuzzy — always confirm the matched track's metadata (artist, title, album) before displaying lyrics to avoid showing the wrong song's snippet"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/0f948ec3-8f9e-4159-be0a-5442c32c328e"}