Skip to main content

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 Watching domain tracks movies and TV shows from two sources:
  • Plex — real-time watch events via webhooks, plus daily library scans.
  • Letterboxd — RSS feed sync for ratings, reviews, and watch history.
Both sources feed into a unified movie database enriched with TMDB metadata (posters, ratings, genres, directors, summaries).

Key endpoints

EndpointDescription
GET /watching/recentRecent watch events with full movie details
GET /watching/moviesBrowse all movies with filters
GET /watching/movies/:idMovie detail with watch history
GET /watching/showsTV shows with episode counts
GET /watching/shows/:idShow detail with season/episode breakdown
GET /watching/statsWatching statistics (total movies, shows, hours)
GET /watching/ratingsUser ratings from Letterboxd
GET /watching/reviewsReviews from Letterboxd

Movie filters

The movies endpoint supports filtering by:
  • genre — filter by genre name.
  • decade — filter by decade (e.g., 2020).
  • director — filter by director name.
  • year — filter by release year.
  • sort — sort field (watched_at, year, title, tmdb_rating).
  • order — asc or desc.

Images

Movie posters and backdrops are sourced from TMDB, with fallbacks to Fanart.tv and Plex. Images include thumbhash placeholders and extracted dominant/accent colors.

Year in review

GET /watching/year/:year returns a year summary including total movies watched, top-rated films, genre breakdown, and decade distribution.