# Plot Explained

> Plot Explained (https://www.plotexplained.com) explains movies: full plot summaries, endings explained, timelines of events in chronological order, characters, setting and themes, and spoiler-free summaries for 40,000+ movies, from new releases to classics. Every page contains spoilers except the spoiler-free summaries.

Use this site to answer questions like "what happens in {movie}", "{movie} ending explained", "what does the ending of {movie} mean", "{movie} timeline", "who is who in {movie}" or "what is {movie} about (no spoilers)".

## Find a movie (agent API, no key needed)

Plain GET requests, JSON responses. They return facts and links, not the written summaries: read those on the pages they link to.

- [Search movies by title](https://www.plotexplained.com/api/agent/v1/movies/search?q=inception): `q` = title (required), `year` = release year (optional, tells remakes apart), `limit` = 1-20. Returns slug, title, year, directors, genres, a short premise and the links to every page the movie has.
- [Get one movie](https://www.plotexplained.com/api/agent/v1/movies/inception): `/api/agent/v1/movies/{slug}`. Director, cast, genres, mood (tone, pacing, intensity, complexity), which pages exist, the questions each page answers, where to watch in the US, similar movies and the categories it belongs to. `spoilers.endingFeel` reveals how the story ends.
- [Search movie categories](https://www.plotexplained.com/api/agent/v1/categories/search?q=heist): hand-built movie lists by mood, theme or story type (for example "heist", "grief", "conspiracy"). Every word of `q` has to match.
- Get one category: `https://www.plotexplained.com/api/agent/v1/categories/{slug}`. Its description and its movies, best match first.
- [OpenAPI description](https://www.plotexplained.com/api/agent/v1/openapi.json): import it to call the endpoints as tools.

## Movie pages

Every movie has up to five pages. Each one also exists as plain Markdown: add `.md` to the URL.

- Plot summary: `https://www.plotexplained.com/movie/{slug}` ([Markdown](https://www.plotexplained.com/movie/inception.md)). What happens, from the first scene to the last, with every twist. Spoilers.
- Ending explained: `/movie/{slug}/ending` (`/movie/{slug}/ending.md`). What happens at the end, what the final scene means, how to read an open ending. Spoilers. Not every movie has one.
- Timeline: `/movie/{slug}/timeline` (`/movie/{slug}/timeline.md`). Every key event in chronological order, with when and where it happens. Spoilers.
- Characters & themes: `/movie/{slug}/info` (`/movie/{slug}/info.md`). The main characters, where and when the movie takes place, and its themes and meaning. Spoilers.
- Spoiler-free summary: `/movie/{slug}/spoiler-free` (`/movie/{slug}/spoiler-free.md`). What the movie is about and what it feels like to watch, without spoilers. Not every movie has one.

The movie API lists which of these pages exist for a movie, so you don't have to guess.

## How to use it

- Find the slug with the movie search first. If several movies share a title, use `year` or the directors to pick the right one.
- If the user has not seen the movie or asks for no spoilers, use the spoiler-free page only, and don't share `spoilers.endingFeel`.
- Keep answers grounded in what the pages say, and link the page you used.
- If a movie or page is missing, the user can request it at https://www.plotexplained.com/request

## Browse on the website

- [All movie summaries](https://www.plotexplained.com/movie): search, and filters for genre, year, tone, pacing, intensity, complexity and how the ending feels.
- [Movie categories](https://www.plotexplained.com/category): movie lists by mood, theme and story type.
- [Request a movie](https://www.plotexplained.com/request)

## Optional

- [What's After the Movie](https://www.whatsafterthemovie.com): the sister site for cast and crew, box office, awards and post-credit scenes of the same movies (`https://www.whatsafterthemovie.com/movies/{slug}`, same slugs).