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 15 minutes. Browse every endpoint in the API reference.

Recently played albums

Use recent albums for unique albums ordered by their newest scrobble, with artist metadata and artwork. Use all year summaries to browse listening totals by year. Album matching confirms a played song on the catalog release. Featured credits can differ in the song title; live recordings still require a matching live album or performance qualifier. Verified recording credits can establish an album’s compilation or collaboration credit without merging the artists. An audited album filing carries forward to later plays of that same source album, preserving recording artists and plays of other releases. Recent catalog links are checked independently of disc-art availability, so an existing link to the wrong release can be repaired too. Pins, exclusions and conflicting identities remain protected. This does not enroll historical listening for artwork generation.

Time periods

Top list endpoints accept a period parameter:

Sparklines

The top artists, top albums, and top tracks endpoints accept ?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. overall uses yearly buckets spanning the listening history. If there is no history to anchor a window, the sparkline may be absent.

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.