Skip to main content

​
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:

​
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. 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.