{"files":{"SKILL.md":"---\nname: musixmatch-api\ndescription: \"Musixmatch API skill. Use when working with Musixmatch for album.tracks.get, album.get, artist.related.get. Covers 16 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Musixmatch API\nAPI version: 1.1.0\n\n## Auth\nApiKey apikey in query\n\n## Base URL\nhttps://api.musixmatch.com/ws/1.1\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /album.tracks.get -- verify access\n3. Explore available endpoints below\n\n## Endpoints\n16 endpoints across 16 groups. See references/api-spec.lap for full details.\n\n### Album.tracks.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /album.tracks.get |  |\n\n### Album.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /album.get |  |\n\n### Artist.related.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /artist.related.get |  |\n\n### Artist.albums.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /artist.albums.get |  |\n\n### Artist.search\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /artist.search |  |\n\n### Artist.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /artist.get |  |\n\n### Matcher.subtitle.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /matcher.subtitle.get |  |\n\n### Matcher.track.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /matcher.track.get |  |\n\n### Matcher.lyrics.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /matcher.lyrics.get |  |\n\n### Track.snippet.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /track.snippet.get |  |\n\n### Track.lyrics.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /track.lyrics.get |  |\n\n### Track.subtitle.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /track.subtitle.get |  |\n\n### Track.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /track.get |  |\n\n### Track.search\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /track.search |  |\n\n### Chart.tracks.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /chart.tracks.get |  |\n\n### Chart.artists.get\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /chart.artists.get |  |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all album.tracks.get?\" -> GET /album.tracks.get\n- \"List all album.get?\" -> GET /album.get\n- \"List all artist.related.get?\" -> GET /artist.related.get\n- \"List all artist.albums.get?\" -> GET /artist.albums.get\n- \"List all artist.search?\" -> GET /artist.search\n- \"List all artist.get?\" -> GET /artist.get\n- \"List all matcher.subtitle.get?\" -> GET /matcher.subtitle.get\n- \"List all matcher.track.get?\" -> GET /matcher.track.get\n- \"List all matcher.lyrics.get?\" -> GET /matcher.lyrics.get\n- \"List all track.snippet.get?\" -> GET /track.snippet.get\n- \"List all track.lyrics.get?\" -> GET /track.lyrics.get\n- \"List all track.subtitle.get?\" -> GET /track.subtitle.get\n- \"List all track.get?\" -> GET /track.get\n- \"List all track.search?\" -> GET /track.search\n- \"List all chart.tracks.get?\" -> GET /chart.tracks.get\n- \"List all chart.artists.get?\" -> GET /chart.artists.get\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Musixmatch API\n@base https://api.musixmatch.com/ws/1.1\n@version 1.1.0\n@auth ApiKey apikey in query\n@common_fields {format: any # output format: json, jsonp, xml., callback: any # jsonp callback}\n@endpoints 16\n@toc album.tracks.get(1), album.get(1), artist.related.get(1), artist.albums.get(1), artist.search(1), artist.get(1), matcher.subtitle.get(1), matcher.track.get(1), matcher.lyrics.get(1), track.snippet.get(1), track.lyrics.get(1), track.subtitle.get(1), track.get(1), track.search(1), chart.tracks.get(1), chart.artists.get(1)\n\n@group album.tracks.get\n@endpoint GET /album.tracks.get\n@required {album_id: any # The musiXmatch album id}\n@optional {f_has_lyrics: any # When set, filter only contents with lyrics, page: any # Define the page number for paginated results, page_size: any # Define the page size for paginated results.Range is 1 to 100.}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group album.get\n@endpoint GET /album.get\n@required {album_id: any # The musiXmatch album id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group artist.related.get\n@endpoint GET /artist.related.get\n@required {artist_id: any # The musiXmatch artist id}\n@optional {page_size: any # Define the page size for paginated results.Range is 1 to 100., page: any # Define the page number for paginated results}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group artist.albums.get\n@endpoint GET /artist.albums.get\n@required {artist_id: any # The musiXmatch artist id}\n@optional {s_release_date: any # Sort by release date (asc|desc), g_album_name: any # Group by Album Name, page_size: any # Define the page size for paginated results.Range is 1 to 100., page: any # Define the page number for paginated results}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group artist.search\n@endpoint GET /artist.search\n@optional {q_artist: any # The song artist, f_artist_id: any # When set, filter by this artist id, page: any # Define the page number for paginated results, page_size: any # Define the page size for paginated results.Range is 1 to 100.}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group artist.get\n@endpoint GET /artist.get\n@required {artist_id: any # The musiXmatch artist id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group matcher.subtitle.get\n@endpoint GET /matcher.subtitle.get\n@optional {q_track: any # The song title, q_artist: any # The song artist, f_subtitle_length: any # Filter by subtitle length in seconds, f_subtitle_length_max_deviation: any # Max deviation for a subtitle length in seconds}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group matcher.track.get\n@endpoint GET /matcher.track.get\n@optional {q_artist: any # The song artist, q_track: any # The song title, f_has_lyrics: any # When set, filter only contents with lyrics, f_has_subtitle: any # When set, filter only contents with subtitles}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group matcher.lyrics.get\n@endpoint GET /matcher.lyrics.get\n@optional {q_track: any # The song title, q_artist: any # The song artist}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group track.snippet.get\n@endpoint GET /track.snippet.get\n@required {track_id: any # The musiXmatch track id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group track.lyrics.get\n@endpoint GET /track.lyrics.get\n@required {track_id: any # The musiXmatch track id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group track.subtitle.get\n@endpoint GET /track.subtitle.get\n@required {track_id: any # The musiXmatch track id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group track.get\n@endpoint GET /track.get\n@required {track_id: any # The musiXmatch track id}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group track.search\n@endpoint GET /track.search\n@optional {q_track: any # The song title, q_artist: any # The song artist, q_lyrics: any # Any word in the lyrics, f_artist_id: any # When set, filter by this artist id, f_music_genre_id: any # When set, filter by this music category id, f_lyrics_language: any # Filter by the lyrics language (en,it,..), f_has_lyrics: any # When set, filter only contents with lyrics, s_artist_rating: any # Sort by our popularity index for artists (asc|desc), s_track_rating: any # Sort by our popularity index for tracks (asc|desc), quorum_factor: any # Search only a part of the given query string.Allowed range is (0.1 – 0.9), page_size: any # Define the page size for paginated results.Range is 1 to 100., page: any # Define the page number for paginated results}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group chart.tracks.get\n@endpoint GET /chart.tracks.get\n@optional {page: any # Define the page number for paginated results, page_size: any # Define the page size for paginated results.Range is 1 to 100., country: any # A valid ISO 3166 country code, f_has_lyrics: any # When set, filter only contents with lyrics}\n@returns(200) The request was successful.\n\n@endgroup\n\n@group chart.artists.get\n@endpoint GET /chart.artists.get\n@optional {page: any # Define the page number for paginated results, page_size: any # Define the page size for paginated results.Range is 1 to 100., country: any # A valid ISO 3166 country code}\n@returns(200) The request was successful.\n\n@endgroup\n\n@end\n"}}