# Rewind

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

## Docs

- [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.
- [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.
- [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 + season. Pair with a public schedule API (MLB Stats API, ESPN, etc.) on the consumer side to overlay attendance on the full schedule.
- [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 attended events](https://docs.rewind.rest/api-reference/attending/list-attended-events.md): Returns events you have tickets for, optionally filtered by category, event_type, season, year, venue, team, and attendance status. Includes events you bought tickets for but did not attend (attended=false).
- [List players you have watched play](https://docs.rewind.rest/api-reference/attending/list-attended-players.md): Returns players who appeared in any attended sports event. Filterable by league, team_id, and `name` (case-insensitive substring match against full_name). Includes both photo variants when available.
- [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.
- [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.
- [Collection calendar](https://docs.rewind.rest/api-reference/collecting/collection-calendar.md): Returns daily addition counts for a given year (vinyl and media combined).
- [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.
- [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 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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [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.
- [Top collected artists](https://docs.rewind.rest/api-reference/collecting/top-artists.md): Artists ranked by number of releases in the collection.
- [Wantlist](https://docs.rewind.rest/api-reference/collecting/wantlist.md): Paginated Discogs wantlist with sorting.
- [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.
- [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.
- [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.
- [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.
- [Album detail](https://docs.rewind.rest/api-reference/listening/album-detail.md): Returns detailed information about an album including tracks.
- [Artist detail](https://docs.rewind.rest/api-reference/listening/artist-detail.md): Returns detailed information about an artist including top albums and tracks.
- [Browse albums](https://docs.rewind.rest/api-reference/listening/browse-albums.md): Returns paginated list of all albums.
- [Browse artists](https://docs.rewind.rest/api-reference/listening/browse-artists.md): Returns paginated list of all artists.
- [Genre breakdown](https://docs.rewind.rest/api-reference/listening/genre-breakdown.md): Returns genre breakdown over time, grouped by period. Designed for stacked bar charts. Pass `compare_to=previous_year` to also receive the same window shifted back by one year as a `compare` array — useful for ghost-overlay charts that need both windows in a single round trip.
- [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 streaks](https://docs.rewind.rest/api-reference/listening/listening-streaks.md): Returns current and longest listening streaks.
- [Listening trends](https://docs.rewind.rest/api-reference/listening/listening-trends.md): Returns monthly trend data for a given metric.
- [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.
- [Listening calendar](https://docs.rewind.rest/api-reference/listening/scrobble-calendar.md): Returns daily scrobble counts for a given year.
- [Listening history](https://docs.rewind.rest/api-reference/listening/scrobble-history.md): Returns paginated scrobble history with optional filters.
- [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 artists](https://docs.rewind.rest/api-reference/listening/top-artists.md): Returns top artists for a given time period. Pass `include_sparklines=true` to attach a play-count time series per artist. Rolling periods (1month/3month/6month/12month) return daily or weekly buckets; `overall` returns yearly buckets covering the artist's lifetime; `7day` is unsupported and the fie…
- [Top tracks](https://docs.rewind.rest/api-reference/listening/top-tracks.md): Returns top tracks for a given time period. Pass `artist_id` (or `artist_name` substring) to filter to a single artist's catalog — composes with `period` and the date filters. Pass `include_sparklines=true` to attach a play-count time series per track (1month/3month/6month/12month/overall).
- [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.
- [Archived articles](https://docs.rewind.rest/api-reference/reading/archived-articles.md): Returns finished articles, paginated.
- [Article detail](https://docs.rewind.rest/api-reference/reading/article-detail.md): Returns a single article with its embedded highlights.
- [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.
- [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 calendar](https://docs.rewind.rest/api-reference/reading/reading-calendar.md): Returns daily counts of saved and finished articles for a given year.
- [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 streaks](https://docs.rewind.rest/api-reference/reading/reading-streaks.md): Returns current and longest reading streaks (consecutive days with a finished article).
- [Recent articles](https://docs.rewind.rest/api-reference/reading/recent-articles.md): Returns recently saved or finished articles, ordered by most recent activity.
- [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.
- [Activity calendar](https://docs.rewind.rest/api-reference/running/activity-calendar.md): Returns daily activity heatmap data for a given year.
- [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.
- [All year summaries](https://docs.rewind.rest/api-reference/running/all-year-summaries.md): Returns running summaries for all years.
- [Cities](https://docs.rewind.rest/api-reference/running/cities.md): Returns cities where runs occurred with counts and distances.
- [Cumulative distance chart](https://docs.rewind.rest/api-reference/running/cumulative-distance-chart.md): Returns year-over-year cumulative distance data for charting.
- [Eddington number](https://docs.rewind.rest/api-reference/running/eddington-number.md): Returns the Eddington number and progress toward the next target.
- [Elevation chart](https://docs.rewind.rest/api-reference/running/elevation-chart.md): Returns elevation data with cumulative totals.
- [Gear list](https://docs.rewind.rest/api-reference/running/gear-list.md): Returns all gear/shoes with activity counts.
- [Running stats](https://docs.rewind.rest/api-reference/running/lifetime-running-statistics.md): Returns aggregate lifetime running statistics.
- [List activities](https://docs.rewind.rest/api-reference/running/list-activities.md): Returns a paginated, filterable list of running activities.
- [Pace trend chart](https://docs.rewind.rest/api-reference/running/pace-trend-chart.md): Returns pace over time with a rolling weighted average.
- [Personal records](https://docs.rewind.rest/api-reference/running/personal-records.md): Returns personal records for standard race distances.
- [Race activities](https://docs.rewind.rest/api-reference/running/race-activities.md): Returns all race activities, optionally filtered by distance category.
- [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.
- [Running streaks](https://docs.rewind.rest/api-reference/running/running-streaks.md): Returns current and longest running streaks.
- [Single year summary](https://docs.rewind.rest/api-reference/running/single-year-summary.md): Returns running summary for a specific year.
- [Time of day chart](https://docs.rewind.rest/api-reference/running/time-of-day-chart.md): Returns run frequency by hour of day.
- [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.
- [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.
- [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.
- [Genre stats](https://docs.rewind.rest/api-reference/watching/genre-stats.md): Returns genre breakdown for all watched movies.
- [List movies](https://docs.rewind.rest/api-reference/watching/list-movies.md): Returns paginated list of movies with optional filters.
- [List TV shows](https://docs.rewind.rest/api-reference/watching/list-tv-shows.md): Returns paginated list of TV shows.
- [Movie detail](https://docs.rewind.rest/api-reference/watching/movie-detail.md): Returns full details for a single movie including watch history.
- [Movie reviews](https://docs.rewind.rest/api-reference/watching/movie-reviews.md): Returns paginated list of movies with user reviews.
- [Rated movies](https://docs.rewind.rest/api-reference/watching/rated-movies.md): Returns paginated list of movies with user ratings.
- [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.
- [Season detail](https://docs.rewind.rest/api-reference/watching/season-detail.md): Returns watched episodes for a specific season of a show.
- [Show detail](https://docs.rewind.rest/api-reference/watching/show-detail.md): Returns full details for a single TV show including watched episodes.
- [Watch calendar](https://docs.rewind.rest/api-reference/watching/watch-calendar.md): Returns daily watch counts for a given year.
- [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.
- [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.
- [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.
- [Authentication](https://docs.rewind.rest/authentication.md): API keys and authorization
- [Changelog](https://docs.rewind.rest/changelog.md): API updates and new features.
- [Attending](https://docs.rewind.rest/domains/attending.md): Live events, tickets, and game attendance
- [Collecting](https://docs.rewind.rest/domains/collecting.md): Discogs vinyl and Trakt physical media
- [Images](https://docs.rewind.rest/domains/images.md): Image pipeline, CDN, and color extraction
- [Listening](https://docs.rewind.rest/domains/listening.md): Last.fm and Apple Music scrobble data
- [Reading](https://docs.rewind.rest/domains/reading.md): Instapaper articles, reading progress, and highlights
- [Running](https://docs.rewind.rest/domains/running.md): Strava activity data
- [Watching](https://docs.rewind.rest/domains/watching.md): Plex and Letterboxd movie and TV data
- [Introduction](https://docs.rewind.rest/introduction.md): Personal data aggregation API
- [MCP Server](https://docs.rewind.rest/mcp-server.md): Connect AI assistants to your Rewind data using the Model Context Protocol
- [OpenAPI Spec](https://docs.rewind.rest/openapi-spec.md): Machine-readable schema for every Rewind endpoint
- [Quick Start](https://docs.rewind.rest/quickstart.md): Make your first API call in 5 minutes

## OpenAPI Specs

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