# Rewind

> Personal data aggregation API. Syncs and serves data from the services that track your life.

## Docs

- [Welcome to Rewind](https://docs.rewind.rest/introduction.md): A personal archive of everything you listen to, run, watch, read, collect, and attend, served as one API you and Claude can query.
- [Quickstart](https://docs.rewind.rest/quickstart.md): Make your first authenticated API call in a few minutes.
- [Authentication](https://docs.rewind.rest/authentication.md): API keys and authorization
- [OpenAPI Spec](https://docs.rewind.rest/openapi-spec.md): Machine-readable schema for every Rewind endpoint
- [Listening](https://docs.rewind.rest/domains/listening.md): Last.fm and Apple Music scrobble data, with top lists, streaks, and a year in review.
- [Running](https://docs.rewind.rest/domains/running.md): Track running activities synced from Strava, including distance, pace, elevation, splits, gear, and personal records.
- [Watching](https://docs.rewind.rest/domains/watching.md): Movies and TV shows from Plex and Letterboxd, enriched with TMDB metadata.
- [Reading](https://docs.rewind.rest/domains/reading.md): Instapaper articles, reading progress, and highlights, with semantic search across everything you have saved.
- [Collecting](https://docs.rewind.rest/domains/collecting.md): Discogs vinyl and Trakt physical media in one place, cross-referenced with your listening and watching.
- [Attending](https://docs.rewind.rest/domains/attending.md): Live events, tickets, and game attendance parsed from your calendar and inbox, with sports score enrichment.
- [Images](https://docs.rewind.rest/domains/images.md): Image pipeline, CDN, and color extraction
- [Troubleshooting](https://docs.rewind.rest/troubleshooting.md): Diagnose authentication failures, rate limits, stale data, MCP setup, and image issues against the Rewind API.
- [Changelog](https://docs.rewind.rest/changelog.md): API updates and new features.
- [Now playing](https://docs.rewind.rest/api-reference/listening/now-playing.md): Returns the currently playing or most recently scrobbled track from Last.fm.
- [Recent scrobbles](https://docs.rewind.rest/api-reference/listening/recent-scrobbles.md): Returns the most recent scrobbles. Supports date filtering via date, from, and to params and page-based pagination.
- [Top artists](https://docs.rewind.rest/api-reference/listening/top-artists.md): Returns your top artists for a given time period.
- [Top albums](https://docs.rewind.rest/api-reference/listening/top-albums.md): Returns top albums for a given time period. Pass `include_sparklines=true` to attach a play-count time series per album (1month/3month/6month/12month/overall).
- [Top tracks](https://docs.rewind.rest/api-reference/listening/top-tracks.md): Returns your top tracks for a given time period, optionally scoped to a single artist.
- [Listening stats](https://docs.rewind.rest/api-reference/listening/listening-stats.md): Returns listening statistics. Supports optional date filtering to scope stats to a time period.
- [Listening history](https://docs.rewind.rest/api-reference/listening/scrobble-history.md): Returns paginated scrobble history with optional filters.
- [Browse artists](https://docs.rewind.rest/api-reference/listening/browse-artists.md): Returns paginated list of all artists.
- [Browse albums](https://docs.rewind.rest/api-reference/listening/browse-albums.md): Returns paginated list of all albums.
- [Artist detail](https://docs.rewind.rest/api-reference/listening/artist-detail.md): Returns detailed information about an artist including top albums and tracks.
- [Album detail](https://docs.rewind.rest/api-reference/listening/album-detail.md): Returns detailed information about an album including tracks.
- [Listening calendar](https://docs.rewind.rest/api-reference/listening/scrobble-calendar.md): Returns daily scrobble counts for a given year.
- [Listening trends](https://docs.rewind.rest/api-reference/listening/listening-trends.md): Returns monthly trend data for a given metric.
- [Listening streaks](https://docs.rewind.rest/api-reference/listening/listening-streaks.md): Returns current and longest listening streaks.
- [Year in review](https://docs.rewind.rest/api-reference/listening/year-in-review.md): Returns year-in-review listening data. Optionally pass ?month=N to scope to a single month.
- [Genre breakdown](https://docs.rewind.rest/api-reference/listening/genre-breakdown.md): Returns a genre breakdown over time, grouped by period and designed for stacked bar charts.
- [Running stats](https://docs.rewind.rest/api-reference/running/lifetime-running-statistics.md): Returns aggregate lifetime running statistics.
- [All year summaries](https://docs.rewind.rest/api-reference/running/all-year-summaries.md): Returns running summaries for all years.
- [Single year summary](https://docs.rewind.rest/api-reference/running/single-year-summary.md): Returns running summary for a specific year.
- [Personal records](https://docs.rewind.rest/api-reference/running/personal-records.md): Returns personal records for standard race distances.
- [Latest runs](https://docs.rewind.rest/api-reference/running/recent-activities.md): Returns the last N activities (default 10, max 50). Supports date filtering via date, from, and to params and page-based pagination.
- [List activities](https://docs.rewind.rest/api-reference/running/list-activities.md): Returns a paginated, filterable list of running activities.
- [Activity detail](https://docs.rewind.rest/api-reference/running/activity-detail.md): Returns a single activity by Strava ID.
- [Activity splits](https://docs.rewind.rest/api-reference/running/activity-splits.md): Returns per-mile splits for a specific activity.
- [Gear list](https://docs.rewind.rest/api-reference/running/gear-list.md): Returns all gear/shoes with activity counts.
- [Activity calendar](https://docs.rewind.rest/api-reference/running/activity-calendar.md): Returns daily activity heatmap data for a given year.
- [Cumulative distance chart](https://docs.rewind.rest/api-reference/running/cumulative-distance-chart.md): Returns year-over-year cumulative distance data for charting.
- [Pace trend chart](https://docs.rewind.rest/api-reference/running/pace-trend-chart.md): Returns pace over time with a rolling weighted average.
- [Time of day chart](https://docs.rewind.rest/api-reference/running/time-of-day-chart.md): Returns run frequency by hour of day.
- [Elevation chart](https://docs.rewind.rest/api-reference/running/elevation-chart.md): Returns elevation data with cumulative totals.
- [Cities](https://docs.rewind.rest/api-reference/running/cities.md): Returns cities where runs occurred with counts and distances.
- [Running streaks](https://docs.rewind.rest/api-reference/running/running-streaks.md): Returns current and longest running streaks.
- [Race activities](https://docs.rewind.rest/api-reference/running/race-activities.md): Returns all race activities, optionally filtered by distance category.
- [Eddington number](https://docs.rewind.rest/api-reference/running/eddington-number.md): Returns the Eddington number and progress toward the next target.
- [Year in review](https://docs.rewind.rest/api-reference/running/year-in-review.md): Returns a year-in-review summary with monthly breakdown and top runs.
- [Recent watches](https://docs.rewind.rest/api-reference/watching/recent-watches.md): Returns most recently watched movies. Supports date filtering via date, from, and to params.
- [List movies](https://docs.rewind.rest/api-reference/watching/list-movies.md): Returns paginated list of movies with optional filters.
- [Movie detail](https://docs.rewind.rest/api-reference/watching/movie-detail.md): Returns full details for a single movie including watch history.
- [Watch stats](https://docs.rewind.rest/api-reference/watching/watch-stats.md): Returns aggregate watching statistics. Supports optional date filtering to scope stats to a time period.
- [Genre stats](https://docs.rewind.rest/api-reference/watching/genre-stats.md): Returns genre breakdown for all watched movies.
- [Decade stats](https://docs.rewind.rest/api-reference/watching/decade-stats.md): Returns decade breakdown for all watched movies.
- [Director stats](https://docs.rewind.rest/api-reference/watching/director-stats.md): Returns top directors by movie count.
- [Watch calendar](https://docs.rewind.rest/api-reference/watching/watch-calendar.md): Returns daily watch counts for a given year.
- [Watch trends](https://docs.rewind.rest/api-reference/watching/watch-trends.md): Returns weekly or monthly watch counts. Supports date filtering via from/to params.
- [List TV shows](https://docs.rewind.rest/api-reference/watching/list-tv-shows.md): Returns paginated list of TV shows.
- [Show detail](https://docs.rewind.rest/api-reference/watching/show-detail.md): Returns full details for a single TV show including watched episodes.
- [Season detail](https://docs.rewind.rest/api-reference/watching/season-detail.md): Returns watched episodes for a specific season of a show.
- [Rated movies](https://docs.rewind.rest/api-reference/watching/rated-movies.md): Returns paginated list of movies with user ratings.
- [Movie reviews](https://docs.rewind.rest/api-reference/watching/movie-reviews.md): Returns paginated list of movies with user reviews.
- [Year in review](https://docs.rewind.rest/api-reference/watching/year-in-review.md): Returns aggregate stats and top-rated movies for a specific year.
- [Recent articles](https://docs.rewind.rest/api-reference/reading/recent-articles.md): Returns recently saved or finished articles, ordered by most recent activity.
- [Currently reading](https://docs.rewind.rest/api-reference/reading/currently-reading.md): Returns articles currently being read (progress > 0 and < 0.75).
- [List articles](https://docs.rewind.rest/api-reference/reading/list-articles.md): Returns a paginated list of articles, filterable by status, tag, domain, and starred.
- [Article detail](https://docs.rewind.rest/api-reference/reading/article-detail.md): Returns a single article with its embedded highlights.
- [Archived articles](https://docs.rewind.rest/api-reference/reading/archived-articles.md): Returns finished articles, paginated.
- [List highlights](https://docs.rewind.rest/api-reference/reading/list-highlights.md): Returns all highlights newest first, with parent article context.
- [Random highlight](https://docs.rewind.rest/api-reference/reading/random-highlight.md): Returns a single random highlight with article context.
- [Reading stats](https://docs.rewind.rest/api-reference/reading/reading-stats.md): Returns aggregate reading statistics: total articles, finished count, currently reading, total highlights, word count, and average read time.
- [Reading calendar](https://docs.rewind.rest/api-reference/reading/reading-calendar.md): Returns daily counts of saved and finished articles for a given year.
- [Reading streaks](https://docs.rewind.rest/api-reference/reading/reading-streaks.md): Returns current and longest reading streaks (consecutive days with a finished article).
- [Tag breakdown](https://docs.rewind.rest/api-reference/reading/tag-breakdown.md): Returns tags with article counts, sorted by count descending.
- [Top domains](https://docs.rewind.rest/api-reference/reading/top-domains.md): Returns top source domains with article counts, sorted by count descending.
- [Year in review](https://docs.rewind.rest/api-reference/reading/year-in-review.md): Returns year-in-review reading data.
- [List vinyl collection](https://docs.rewind.rest/api-reference/collecting/list-vinyl-collection.md): Paginated, filterable, searchable Discogs vinyl collection with artist and image data.
- [Collection stats](https://docs.rewind.rest/api-reference/collecting/collection-statistics.md): Aggregate statistics for the vinyl collection. Supports optional date filtering to scope stats to items added within a time period.
- [Recent vinyl additions](https://docs.rewind.rest/api-reference/collecting/recent-additions.md): Most recently added items to the vinyl collection. Supports date filtering via date, from, and to params.
- [Vinyl record detail](https://docs.rewind.rest/api-reference/collecting/collection-item-detail.md): Full detail for a single collection item including tracklist, country, and marketplace data.
- [Wantlist](https://docs.rewind.rest/api-reference/collecting/wantlist.md): Paginated Discogs wantlist with sorting.
- [Format breakdown](https://docs.rewind.rest/api-reference/collecting/format-breakdown.md): Count of collection items grouped by primary format (Vinyl, CD, Cassette, etc).
- [Genre breakdown](https://docs.rewind.rest/api-reference/collecting/genre-breakdown.md): Count of collection items grouped by genre.
- [Top collected artists](https://docs.rewind.rest/api-reference/collecting/top-artists.md): Artists ranked by number of releases in the collection.
- [Collection-listening cross-reference](https://docs.rewind.rest/api-reference/collecting/collection-listening-cross-reference.md): Cross-references vinyl collection with Last.fm listening data showing play counts and match confidence.
- [Collection calendar](https://docs.rewind.rest/api-reference/collecting/collection-calendar.md): Returns daily addition counts for a given year (vinyl and media combined).
- [List physical media collection](https://docs.rewind.rest/api-reference/collecting/list-physical-media-collection.md): Paginated, filterable Trakt physical media collection (Blu-ray, DVD, etc) with movie metadata.
- [Physical media stats](https://docs.rewind.rest/api-reference/collecting/physical-media-statistics.md): Aggregate statistics for the physical media collection by format, resolution, HDR, genre, and decade.
- [Recently added physical media](https://docs.rewind.rest/api-reference/collecting/recently-added-physical-media.md): Most recently added items to the physical media collection. Supports date filtering via date, from, and to params.
- [Media format breakdown](https://docs.rewind.rest/api-reference/collecting/media-format-breakdown.md): Count of physical media items grouped by format type (bluray, dvd, etc).
- [Owned vs watched cross-reference](https://docs.rewind.rest/api-reference/collecting/owned-vs-watched-cross-reference.md): Cross-references physical media collection with watch history showing watched/unwatched status.
- [Physical media item detail](https://docs.rewind.rest/api-reference/collecting/physical-media-item-detail.md): Full detail for a single physical media item including movie metadata and watch history.
- [List attended events](https://docs.rewind.rest/api-reference/attending/list-attended-events.md): Returns events you have tickets for, filterable by category, type, season, year, venue, team, and attendance status. Includes tickets for events you did not attend.
- [Get an attended event](https://docs.rewind.rest/api-reference/attending/get-attended-event.md): Returns a single attended event with its venue, tickets, performers, and event_data.
- [Attended games in a sports season](https://docs.rewind.rest/api-reference/attending/get-attended-season.md): Returns the games you attended (or hold tickets for) in a given league and season, with your win-loss record across them.
- [List venues](https://docs.rewind.rest/api-reference/attending/list-venues.md): Returns the venues catalog used by attended events. Includes city, state, country, lat/long, and capacity when known.
- [Aggregate attending stats](https://docs.rewind.rest/api-reference/attending/get-attending-stats.md): Returns counts of attended events broken down by category, event_type, and year. Useful for top-line stats on the portfolio page.
- [List players you have watched play](https://docs.rewind.rest/api-reference/attending/list-attended-players.md): Returns players who appeared in any event you attended, filterable by league, team, and name. Includes both photo variants when available.
- [Get a player you have watched play](https://docs.rewind.rest/api-reference/attending/get-attended-player.md): Returns the player bio with both photo variants when available, plus a list of every attended event in which they appeared along with that game's stat lines.
- [Year in review](https://docs.rewind.rest/api-reference/attending/year-in-review.md): Returns a year-in-review summary for attended events: totals, monthly breakdown, top venues, top concert performers, and the full event list. 404 when no attended events exist for the year.
- [Cross-domain activity feed](https://docs.rewind.rest/api-reference/feed/cross-domain-activity-feed.md): Returns a cross-domain activity feed with cursor-based pagination.
- [Single-domain activity feed](https://docs.rewind.rest/api-reference/feed/single-domain-activity-feed.md): Returns an activity feed filtered to a single domain with cursor-based pagination.
- [On this day](https://docs.rewind.rest/api-reference/feed/on-this-day.md): Returns activity from a given calendar date across all years, grouped by year.
- [Cross-domain search](https://docs.rewind.rest/api-reference/search/cross-domain-search.md): Full-text search across all data domains (listening, running, watching, collecting, reading).
- [Health check](https://docs.rewind.rest/api-reference/system/health-check.md): Returns API health status and current timestamp.
- [Sync health status](https://docs.rewind.rest/api-reference/system/sync-health-status.md): Returns the latest sync status for each data domain, including last sync time, items synced, duration, and 24-hour error rate.
- [Get image by entity](https://docs.rewind.rest/api-reference/images/get-image-by-entity.md): Serve image via CDN redirect. Triggers the image pipeline on cache miss. Returns a 302 redirect to the CDN URL with metadata in response headers.
- [Webhooks](https://docs.rewind.rest/api-reference/webhooks/overview.md): How Rewind receives inbound events from Strava and Plex to keep your data fresh in near real time.
- [MCP Server](https://docs.rewind.rest/mcp/overview.md): Connect AI assistants to your Rewind data using the Model Context Protocol.
- [Connect via local stdio](https://docs.rewind.rest/mcp/connect-local.md): Run the Rewind MCP server as a local child process for Claude Desktop and Claude Code, communicating over stdin and stdout.
- [Connect via the hosted server](https://docs.rewind.rest/mcp/connect-remote.md): Connect a mobile or web MCP client to the hosted Rewind server at mcp.rewind.rest, using either a Bearer token or the GitHub sign-in flow.
- [Rich responses](https://docs.rewind.rest/mcp/rich-responses.md): How Rewind MCP tools return images, links, structured data, and interactive cards beyond plain text.
- [Resources and prompts](https://docs.rewind.rest/mcp/resources-and-prompts.md): Pull full entity records into a conversation with @-mentionable resources, and kick off multi-step queries with the built-in prompt templates.
- [Listening](https://docs.rewind.rest/reference/mcp-tools/listening.md): MCP tools for your Last.fm and Apple Music listening history.
- [Running](https://docs.rewind.rest/reference/mcp-tools/running.md): MCP tools for your Strava running activities and stats.
- [Watching](https://docs.rewind.rest/reference/mcp-tools/watching.md): MCP tools for your Plex and Letterboxd movie and TV history.
- [Reading](https://docs.rewind.rest/reference/mcp-tools/reading.md): MCP tools for your Instapaper articles and highlights.
- [Collecting](https://docs.rewind.rest/reference/mcp-tools/collecting.md): MCP tools for your Discogs vinyl and physical media collections.
- [Attending](https://docs.rewind.rest/reference/mcp-tools/attending.md): MCP tools for the live events and games you have attended.
- [Cross-domain](https://docs.rewind.rest/reference/mcp-tools/cross-domain.md): Search, feed, on-this-day, and health tools that span every domain.

## OpenAPI Specs

- [openapi](https://docs.rewind.rest/openapi.json)