> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/listening/now-playing).

## 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](/api-reference/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](/api-reference/listening/year-in-review) 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](/domains/images) for the source and fallback details.

## From Claude

You can also explore your listening history from Claude. Set up the [MCP server](/mcp/overview), then the [listening tools](/reference/mcp-tools/listening) are yours. Ask for your top artists this month, or what you played on a given day.