go-lastfm is a Go client library for accessing the Last.fm API
go get github.com/tsirynsdr/go-lastfmImport the package into your project.
import "github.com/tsirynsdr/go-lastfm"Construct a new Last.fm client, then use the various services on the client to access different parts of the Last.fm API. For example:
client := lastfm.NewClient("<YOUR API KEY>")
res, _ := client.Artist.GetInfo("Travis Scott")
info, _ := json.Marshal(res)
fmt.Println(string(info))Currently the following services are supported:
- Tag an album using a list of user supplied tag
- Get the metadata and tracklist for an album on Last.fm using the album name or a musicbrainz id
- Get the tags applied by an individual user to an album on Last.fm
- Get the top tags for an album on Last.fm, ordered by popularity
- Remove a user's tag from an album
- Search for an album by name. Returns album matches sorted by relevance
- Tag an artist with one or more user supplied tags
- Use the last.fm corrections data to check whether the supplied artist has a correction to a canonical artist
- Get the metadata for an artist. Includes biography, truncated at 300 characters
- Get all the artists similar to this artist
- Get the tags applied by an individual user to an artist on Last.fm
- Get the top albums for an artist on Last.fm, ordered by popularity
- Get the top tags for an artist on Last.fm, ordered by popularity
- Get the top tracks by an artist on Last.fm, ordered by popularity
- Remove a user's tag from an artist
- Search for an artist by name. Returns artist matches sorted by relevance
- Get the top artists chart
- Get the top tracks chart
- Get the most popular artists on Last.fm by country
- Get the most popular tracks on Last.fm last week by country
- Get a paginated list of all the artists in a user's library, with play counts and tag counts
- Get the metadata for a tag
- Search for tags similar to this one. Returns tags ranked by similarity, based on listening data
- Get the top albums tagged by this tag, ordered by tag count
- Get the top artists tagged by this tag, ordered by tag count
- Fetches the top global tags on Last.fm, sorted by popularity (number of times used)
- Get the top tracks tagged by this tag, ordered by tag count
- Get a list of available charts for this tag, expressed as date ranges which can be sent to the chart services
- Tag an album using a list of user supplied tags
- Use the last.fm corrections data to check whether the supplied track has a correction to a canonical track
- Get the metadata for a track on Last.fm using the artist/track name or a musicbrainz id
- Get the similar tracks for this track on Last.fm, based on listening data
- Get the tags applied by an individual user to a track on Last.fm
- Get the top tags for this track on Last.fm, ordered by tag count
- Love a track for a user profile
- Remove a user's tag from a track
- Track.scrobble
- Track.search
- Track.unlove
- Track.updateNowPlaying
- Get a list of the user's friends on Last.fm
- Get information about a user profile
- Get the last 50 tracks loved by a user
- Get the user's personal tags
- Get a list of the recent tracks listened to by this user
- Get the top albums listened to by a user
- Get the top artists listened to by a user
- Get the top tags used by this user
- Get the top tracks listened to by a user
- Get an album chart for a user profile, for a given date range
- Get an artist chart for a user profile, for a given date range
- Get a list of available charts for this user, expressed as date ranges which can be sent to the chart services
- Get a track chart for a user profile, for a given date range
👤 Tsiry Sandratraina
- Twitter: @tsiry_sndr
- Github: @tsirysndr
Give a ⭐️ if this project helped you!