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.
Overview
The Listening domain tracks music listening history from Last.fm, enriched with Apple Music metadata (artwork, preview URLs, Apple Music links).
Data syncs every 15 minutes via cron. Each sync fetches recent scrobbles and updates artist/album/track records.
Key endpoints
| Endpoint | Description |
|---|
| GET /listening/recent | Recent scrobbles with track, artist, album, and image data |
| GET /listening/now-playing | Currently playing track (if any) |
| GET /listening/top/artists | Top artists by play count, filterable by time period |
| GET /listening/top/albums | Top albums by play count |
| GET /listening/top/tracks | Top tracks by scrobble count |
| GET /listening/stats | Lifetime listening statistics |
| GET /listening/streaks | Listening streak data (consecutive days) |
| GET /listening/artists | Browse all artists with pagination |
| GET /listening/artists/:id | Artist detail with top albums and tracks |
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 uses a combination of artist matching, album/track pattern matching, and Last.fm tag-based auto-detection.
Images
Album and artist artwork is sourced from Apple Music, Deezer, iTunes, and Last.fm. Images are stored in R2 and served via CDN with thumbhash placeholders and extracted dominant/accent colors.
