# 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):**
```http
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