# OpenClaw-Last.fm
A openclaw Skill with Last.fm API
## Requirements
- Last.fm API Key ([Get in website](https://www.last.fm/api))
## How to request API
- Root URL: `https://ws.audioscrobbler.com/2.0/` (GET/POST)
### Required parameters
- `api_key`: API Key
- `method`: Method name
- `format`: XML (default) or JSON
---
## Methods
Below are commonly used Last.fm methods grouped by resource type.
All requests use the same base URL and append query parameters.
---
### Artist
#### `artist.getInfo`
Get detailed information about a specific artist (bio, images, stats, tags, similar artists, etc.).
**Example request (JSON):**GET https://ws.audioscrobbler.com/2.0/?method=artist.getinfo&artist=Radiohead&api_key=YOUR_API_KEY&format=json
#### `artist.getTopTracks`
Get the top tracks for an artist, ordered by playcount.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=artist.gettoptracks&artist=Radiohead&api_key=YOUR_API_KEY&format=json
#### `artist.getTopAlbums`
Get the top albums for an artist, ordered by playcount.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=artist.gettopalbums&artist=Radiohead&api_key=YOUR_API_KEY&format=json
#### `artist.search`
Search for artists by name and get a list of matching artists.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=artist.search&artist=Radiohead&api_key=YOUR_API_KEY&format=json
---
### Album
#### `album.getInfo`
Get album metadata (tracks, tags, playcount, cover art, etc.) for a given artist and album.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=album.getinfo&artist=Radiohead&album=OK+Computer&api_key=YOUR_API_KEY&format=json
#### `album.getTopTags`
Get the most popular tags applied to a specific album.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=album.gettoptags&artist=Radiohead&album=OK+Computer&api_key=YOUR_API_KEY&format=json
#### `album.search`
Search for albums by name and get possible matches.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=album.search&album=OK+Computer&api_key=YOUR_API_KEY&format=json
---
### Track
#### `track.getInfo`
Get detailed metadata for a track, including album, duration, listeners, playcount, and wiki (if available).
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=track.getinfo&artist=Radiohead&track=Karma+Police&api_key=YOUR_API_KEY&format=json
#### `track.getTopTags`
Get the most popular tags for a given track.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=track.gettoptags&artist=Radiohead&track=Karma+Police&api_key=YOUR_API_KEY&format=json
#### `track.search`
Search for tracks by name (and optionally by artist) and get a list of matches.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=track.search&track=Karma+Police&api_key=YOUR_API_KEY&format=json
---
### User
#### `user.getInfo`
Get profile information about a user (playcount, country, age (if public), images, etc.).
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=someusername&api_key=YOUR_API_KEY&format=json
#### `user.getRecentTracks`
Get the list of recently scrobbled tracks by a user, including timestamps and “now playing” status.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=someusername&limit=20&api_key=YOUR_API_KEY&format=json
#### `user.getTopArtists`
Get a user’s top artists over a specific period (overall, 7day, 1month, 3month, 6month, 12month).
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=someusername&period=1month&limit=20&api_key=YOUR_API_KEY&format=json
#### `user.getTopTracks`
Get a user’s top tracks over a selected period.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=user.gettoptracks&user=someusername&period=3month&limit=20&api_key=YOUR_API_KEY&format=json
---
### Library
#### `library.getArtists`
Get a paginated list of all artists in a user’s library with play counts and tag counts.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=library.getartists&user=someusername&limit=10&page=1&api_key=YOUR_API_KEY&format=json
#### `library.getAlbums`
Get albums from a user’s library, optionally filtered by artist.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=library.getalbums&user=someusername&limit=10&page=1&api_key=YOUR_API_KEY&format=json
#### `library.getTracks`
Get tracks from a user’s library with their play counts.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=library.gettracks&user=someusername&limit=10&page=1&api_key=YOUR_API_KEY&format=json
---
### Chart
#### `chart.getTopArtists`
Get the global top artists chart on Last.fm.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=chart.gettopartists&api_key=YOUR_API_KEY&format=json
#### `chart.getTopTracks`
Get the global top tracks chart.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=chart.gettoptracks&api_key=YOUR_API_KEY&format=json
#### `chart.getTopTags`
Get the global top tags chart.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=chart.gettoptags&api_key=YOUR_API_KEY&format=json
---
### Tag
#### `tag.getInfo`
Get metadata for a tag (description, reach, total uses, etc.).
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=tag.getinfo&tag=k-pop&api_key=YOUR_API_KEY&format=json
#### `tag.getTopArtists`
Get top artists associated with a specific tag.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=tag.gettopartists&tag=k-pop&api_key=YOUR_API_KEY&format=json
#### `tag.getTopTracks`
Get top tracks associated with a tag.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=tag.gettoptracks&tag=k-pop&api_key=YOUR_API_KEY&format=json
#### `tag.getTopAlbums`
Get top albums associated with a tag.
**Example request:**GET https://ws.audioscrobbler.com/2.0/?method=tag.gettopalbums&tag=k-pop&api_key=YOUR_API_KEY&format=json
---