✓ Verified ✍️ Content Creation ✓ Enhanced Data

Lastfm

Access Last.fm listening history, music stats.

Rating: 4.1 (217 reviews)
Downloads: 16,470 downloads
Version: 1.0.0

Overview

Access Last.fm listening history, music stats.

Complete Documentation

View Source →

Last.fm API Skill

Access Last.fm listening history, music stats, and discovery.

Configuration

Required env vars (add to your shell profile or optionally ~/.clawdbot/.env):

LASTFM_API_KEY — your Last.fm API key (get one here)
LASTFM_USER — your Last.fm username

Base URL: http://ws.audioscrobbler.com/2.0/ Docs: https://lastfm-docs.github.io/api-docs/

Example Output

Here's what 17+ years of scrobbling looks like:

text

Total scrobbles: 519,778
Unique artists: 13,763
Unique tracks: 68,435
Unique albums: 33,637

Top Artists (all time):
• System of a Down (52,775 plays)
• Eminem (15,400 plays)
• Dashboard Confessional (10,166 plays)
• Edguy (10,161 plays)
• Metallica (9,927 plays)

Top Tracks (all time):
• System of a Down - Aerials (1,405 plays)
• System of a Down - Toxicity (1,215 plays)
• System of a Down - Sugar (1,149 plays)
• System of a Down - Chop Suey (1,116 plays)
• System of a Down - Prison Song (1,102 plays)

Quick Reference

All requests use GET with these base params:

text

?api_key=$LASTFM_API_KEY&format=json&user=$LASTFM_USER

User Endpoints

#### Recent Tracks (what's playing / recently played)

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&limit=10"

First track with @attr.nowplaying=true is currently playing
Returns: artist, track name, album, timestamp, images

#### User Info (profile stats)

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

Returns: playcount, artist_count, track_count, album_count, registered date

#### Top Artists

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&period=7day&limit=10"

period: overall | 7day | 1month | 3month | 6month | 12month

#### Top Albums

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.gettopalbums&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&period=7day&limit=10"

#### Top Tracks

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.gettoptracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&period=7day&limit=10"

#### Loved Tracks

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getlovedtracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&limit=10"

#### Weekly Charts

bash

# Weekly artist chart
curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getweeklyartistchart&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

# Weekly track chart
curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getweeklytrackchart&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

# Weekly album chart
curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getweeklyalbumchart&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

Artist/Track/Album Info

#### Artist Info

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=artist.getinfo&artist=Tame+Impala&api_key=$LASTFM_API_KEY&format=json&username=$LASTFM_USER"

Adding username includes user's playcount for that artist

#### Similar Artists

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=artist.getsimilar&artist=Tame+Impala&api_key=$LASTFM_API_KEY&format=json&limit=10"

#### Artist Top Tracks

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=artist.gettoptracks&artist=Tame+Impala&api_key=$LASTFM_API_KEY&format=json&limit=10"

#### Track Info

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=track.getinfo&artist=Tame+Impala&track=The+Less+I+Know+The+Better&api_key=$LASTFM_API_KEY&format=json&username=$LASTFM_USER"

#### Similar Tracks

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=track.getsimilar&artist=Tame+Impala&track=Elephant&api_key=$LASTFM_API_KEY&format=json&limit=10"

#### Album Info

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=album.getinfo&artist=Tame+Impala&album=Currents&api_key=$LASTFM_API_KEY&format=json&username=$LASTFM_USER"

Search

#### Search Artists

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=artist.search&artist=tame&api_key=$LASTFM_API_KEY&format=json&limit=5"

#### Search Tracks

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=track.search&track=elephant&api_key=$LASTFM_API_KEY&format=json&limit=5"

#### Search Albums

bash

curl -s "http://ws.audioscrobbler.com/2.0/?method=album.search&album=currents&api_key=$LASTFM_API_KEY&format=json&limit=5"

Charts (Global)

bash

# Top artists globally
curl -s "http://ws.audioscrobbler.com/2.0/?method=chart.gettopartists&api_key=$LASTFM_API_KEY&format=json&limit=10"

# Top tracks globally
curl -s "http://ws.audioscrobbler.com/2.0/?method=chart.gettoptracks&api_key=$LASTFM_API_KEY&format=json&limit=10"

Useful jq Filters

For JSON processing, see the jq skill on ClawdHub.

bash

# Recent tracks: artist - track
jq '.recenttracks.track[] | "\(.artist["#text"]) - \(.name)"'

# Top artists: name (playcount)
jq '.topartists.artist[] | "\(.name) (\(.playcount))"'

# Check if currently playing
jq '.recenttracks.track[0] | if .["@attr"].nowplaying == "true" then "Now playing: \(.artist["#text"]) - \(.name)" else "Last played: \(.artist["#text"]) - \(.name)" end'

Notes

No auth needed for read-only endpoints (just API key)
Rate limit: be reasonable, no hard limit documented
URL-encode artist/track/album names (spaces → + or %20)
Images come in sizes: small, medium, large, extralarge

Installation

Terminal bash


openclaw install lastfm

Copied!

💻Code Examples

• System of a Down - Prison Song (1,102 plays)

-system-of-a-down---prison-song-1102-plays.txt

## Quick Reference

All requests use GET with these base params:

?api_key=$LASTFM_API_KEY&format=json&user=$LASTFM_USER

apikeylastfmapikeyformatjsonuserlastfmuser.txt

### User Endpoints

#### Recent Tracks (what's playing / recently played)

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getrecenttracks&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&limit=10"

curl--s-httpwsaudioscrobblercom20methodusergetrecenttracksuserlastfmuserapikeylastfmapikeyformatjsonlimit10.txt

- First track with `@attr.nowplaying=true` is currently playing
- Returns: artist, track name, album, timestamp, images

#### User Info (profile stats)

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getinfo&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

curl--s-httpwsaudioscrobblercom20methodusergetinfouserlastfmuserapikeylastfmapikeyformatjson.txt

- Returns: playcount, artist_count, track_count, album_count, registered date

#### Top Artists

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.gettopartists&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json&period=7day&limit=10"

curl--s-httpwsaudioscrobblercom20methodusergettopartistsuserlastfmuserapikeylastfmapikeyformatjsonperiod7daylimit10.txt

- `period`: overall | 7day | 1month | 3month | 6month | 12month

#### Top Albums

curl -s "http://ws.audioscrobbler.com/2.0/?method=user.getweeklyalbumchart&user=$LASTFM_USER&api_key=$LASTFM_API_KEY&format=json"

curl--s-httpwsaudioscrobblercom20methodusergetweeklyalbumchartuserlastfmuserapikeylastfmapikeyformatjson.txt

### Artist/Track/Album Info

#### Artist Info

curl -s "http://ws.audioscrobbler.com/2.0/?method=artist.getinfo&artist=Tame+Impala&api_key=$LASTFM_API_KEY&format=json&username=$LASTFM_USER"

curl--s-httpwsaudioscrobblercom20methodartistgetinfoartisttameimpalaapikeylastfmapikeyformatjsonusernamelastfmuser.txt

- Adding `username` includes user's playcount for that artist

#### Similar Artists

curl -s "http://ws.audioscrobbler.com/2.0/?method=album.getinfo&artist=Tame+Impala&album=Currents&api_key=$LASTFM_API_KEY&format=json&username=$LASTFM_USER"

curl--s-httpwsaudioscrobblercom20methodalbumgetinfoartisttameimpalaalbumcurrentsapikeylastfmapikeyformatjsonusernamelastfmuser.txt

### Search

#### Search Artists

curl -s "http://ws.audioscrobbler.com/2.0/?method=tag.gettopartists&tag=brazilian&api_key=$LASTFM_API_KEY&format=json&limit=10"

curl--s-httpwsaudioscrobblercom20methodtaggettopartiststagbrazilianapikeylastfmapikeyformatjsonlimit10.txt

## Useful jq Filters

For JSON processing, see the [jq skill on ClawdHub](https://clawdhub.com/skills/jq).

example.txt

Total scrobbles: 519,778
Unique artists: 13,763
Unique tracks: 68,435
Unique albums: 33,637

Top Artists (all time):
• System of a Down (52,775 plays)
• Eminem (15,400 plays)
• Dashboard Confessional (10,166 plays)
• Edguy (10,161 plays)
• Metallica (9,927 plays)

Top Tracks (all time):
• System of a Down - Aerials (1,405 plays)
• System of a Down - Toxicity (1,215 plays)
• System of a Down - Sugar (1,149 plays)
• System of a Down - Chop Suey (1,116 plays)
• System of a Down - Prison Song (1,102 plays)