Listening
Last.fm and Apple Music scrobble data, with top lists, streaks, and a year in review.
Overview
The Listening domain tracks your music history from Last.fm, enriched with Apple Music metadata.
- Last.fm: scrobble history, top artists, albums, and tracks, and listening streaks.
- Apple Music: artwork, preview URLs, and Apple Music links layered onto matched records.
Scrobbles sync every few minutes. Browse every endpoint in the API reference.
Time periods
Top list endpoints accept a period parameter:
| Period | Description |
|---|---|
7day | Last 7 days |
1month | Last 30 days |
3month | Last 90 days |
6month | Last 180 days |
12month | Last 365 days |
overall | All time |
Sparklines
GET /listening/top/artists accepts ?include_sparklines=true to attach a per-artist play-count time series, suitable for rendering an inline sparkline next to each item.
| Period | Granularity | Points |
|---|---|---|
1month | day | 28 |
3month | week | 13 |
6month | week | 26 |
12month | week | 52 |
points is ordered oldest to newest and zero-filled. The most recent bucket is partial (current week or current day in progress). Weekly buckets anchor on the Monday of the week. 7day and overall omit the field; treat its absence as "no sparkline".
Filtering
- Audiobooks, podcasts, and holiday music are automatically filtered from all listening endpoints.
- The filter system combines artist matching, album and track pattern matching, and Last.fm tag-based auto-detection.
- Standard date filters (
date,from,to).
Year in review
GET /listening/year/:year returns year-in-review listening data for a single year. Optionally pass ?month=N to scope the summary to a single month.
Images
Album and artist artwork is served through the shared image pipeline, with thumbhash placeholders and extracted dominant and accent colors. See Images for the source and fallback details.
From Claude
You can also explore your listening history from Claude. Set up the MCP server, then the listening tools are yours. Ask for your top artists this month, or what you played on a given day.