@chirag127/lastfm

Zero-dependency Last.fm API client for Node.js / Deno / Cloudflare Workers.

Install

npm install @chirag127/lastfm

Usage

import { getRecentTracks, getTopArtists, getTopTracks, getUserInfo } from '@chirag127/lastfm';

const API_KEY = 'your_lastfm_api_key';
const USER = 'chirag127';

const tracks = await getRecentTracks(API_KEY, USER);          // last 50 tracks
const artists = await getTopArtists(API_KEY, USER, '7day');   // top artists this week
const top = await getTopTracks(API_KEY, USER, 'overall', 10); // all-time top 10 tracks
const info = await getUserInfo(API_KEY, USER);                // user profile object

API

All functions throw on HTTP error or Last.fm API error.

| Function | Params | Returns | |---|---|---| | getRecentTracks(apiKey, username, limit=50) | — | track[] | | getTopArtists(apiKey, username, period='1month', limit=20) | period: overall\|7day\|1month\|3month\|6month\|12month | artist[] | | getTopTracks(apiKey, username, period='1month', limit=20) | same periods | track[] | | getUserInfo(apiKey, username) | — | user object |

Get an API key at https://www.last.fm/api/account/create.

License

MIT