Movies

Catalog details and recommendations.

Search movies

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/movies

Search the movie catalog by title, release year, genre, language, cast member, company, or IMDb/TMDB ID. Combine filters to narrow the results and use sort to choose their order. The response is a paginated list of movie summaries; use a movie’s id or slug to fetch its full details. External-ID searches return a list because an ID can match more than one catalog entry.

Search movies › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

q

string · minLength: 1 · maxLength: 120

Match part of a movie title, ignoring case.

year_from

integer · min: 1800 · max: 2200

Earliest year to include (inclusive).

year_to

integer · min: 1800 · max: 2200

Latest year to include (inclusive).

genre

string · minLength: 1 · maxLength: 120

Filter by genre name, for example Drama. Matching ignores case.

language

string · minLength: 1 · maxLength: 120

Filter by original language, for example en.

release_from

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include movies released on or after this date (YYYY-MM-DD).

release_to

string · pattern: ^\d{4}-\d{2}-\d{2}$

Include movies released on or before this date (YYYY-MM-DD).

company_id

integer · min: 1 · max: 9007199254740991

Only movies associated with this company ID.

imdb_id

string · pattern: ^tt\d{5,12}$

Find movies by IMDb title ID, for example tt1375666.

tmdb_id

string · pattern: ^\d{1,12}$

Find movies by TMDB movie ID, for example 27205.

person_id

integer · min: 1 · max: 9007199254740991

Only records associated with this person ID.

has

string · minLength: 1 · maxLength: 120

Require all listed content sections, separated by commas. Allowed values: summary, spoiler-free-summary, ending, timeline, setting, themes, characters, faqs, profile

tone

string · enum

Filter by the movie’s overall emotional tone.

Enum values:

LIGHT

HOPEFUL

BITTERSWEET

BLEAK

DARK

TENSE

WHIMSICAL

MELANCHOLIC

mood

string · minLength: 1 · maxLength: 120

Only movies with this mood tag. Match the full tag.

pacing

string · enum

Filter by how slowly or quickly the story develops.

Enum values:

SLOW

STEADY

FAST

VARIABLE

intensity

string · enum

Filter by the intensity of the viewing experience.

Enum values:

LOW

MEDIUM

HIGH

complexity

string · enum

Filter by how complex the story is to follow.

Enum values:

STRAIGHTFORWARD

MODERATE

COMPLEX

VERY_COMPLEX

sort

string · enum

Order results by this field. A leading minus reverses the order.

Enum values:

title

release_date

-release_date

year

-year

Default: id

Search movies › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Search movies › Responses

The requested data. Examples use illustrative values.

ListMoviesResponse

object[] · required

object · required

Get movie details

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/movies/{movie}

Retrieve a movie’s title, release information, runtime, cast, directors, company, ratings, box-office figures, and external links. available_content lists the explanations available for that movie. Fetch each explanation from its corresponding content endpoint. Unknown values are returned as null; cast order does not indicate billing order.

Get movie details › path Parameters

movie

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get movie details › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get movie details › Responses

The requested data. Examples use illustrative values.

GetMovieResponse

object · required

GET/v1/movies/{movie}

curl https://whatsafterthemovie-main-0565fcb.zuplo.app/v1/movies/:movie \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": 101,
    "slug": "the-last-screening",
    "title": "The Last Screening",
    "year": 2025,
    "release_date": "2025-09-12",
    "language": "en",
    "genres": [
      "Drama"
    ],
    "image_url": "https://example.com/image.jpg",
    "imdb_id": "tt0000101",
    "tmdb_id": "101",
    "description": "A projectionist revisits the night that changed a small-town cinema.",
    "runtime": "112 minutes",
    "budget": 1,
    "after_credits": "reported",
    "company": {
      "id": 101,
      "slug": "northlight-pictures",
      "name": "Northlight Pictures",
      "image_url": "https://example.com/image.jpg"
    },
    "links": [
      {
        "source": "IMDb",
        "url": "https://example.com/source"
      }
    ],
    "ratings": [
      {
        "source": "IMDb",
        "critic_score": null,
        "critic_count": null,
        "user_score": "8.1",
        "user_count": "12500"
      }
    ],
    "echo_score": {
      "score": 1,
      "description": "A projectionist revisits the night that changed a small-town cinema.",
      "aspects": [
        {
          "name": "Alex Morgan",
          "score": 1,
          "description": "A projectionist revisits the night that changed a small-town cinema."
        }
      ]
    },
    "box_office": {
      "domestic": 1,
      "international": 1,
      "worldwide": 1
    },
    "cast": [
      {
        "id": 101,
        "slug": "alex-morgan",
        "name": "Alex Morgan",
        "image_url": "https://example.com/image.jpg",
        "character": "Mara"
      }
    ],
    "directors": [
      {
        "id": 101,
        "slug": "alex-morgan",
        "name": "Alex Morgan",
        "image_url": "https://example.com/image.jpg"
      }
    ],
    "available_content": [
      "summary"
    ]
  }
}

json

application/json

Get movie recommendations

GET

https://whatsafterthemovie-main-0565fcb.zuplo.app

/v1/movies/{movie}/recommendations

Discover movies related to a selected movie. The default similar mode returns ranked recommendations. Choose mode=threads to browse themed recommendation groups, each with a preview of up to five movies. To page through one group, send its thread_id with mode=threads. Genre and year filters apply to the recommended movies.

Get movie recommendations › path Parameters

movie

string · minLength: 1 · maxLength: 255 · required

ATM numeric ID or slug.

Get movie recommendations › query Parameters

limit

integer · min: 1 · max: 100

Maximum items in the returned page.

Default: 20

cursor

string · minLength: 1 · maxLength: 4096

The next_cursor from a previous response. Keep the same endpoint and filters. Valid for 24 hours.

mode

string · enum

similar returns ranked movies; threads returns themed groups of recommendations.

Enum values:

similar

threads

Default: similar

thread_id

integer · min: 1 · max: 9007199254740991

Thread belonging to this movie; requires mode=threads.

genre

string · minLength: 1 · maxLength: 120

Filter by genre name, for example Drama. Matching ignores case.

year_from

integer · min: 1800 · max: 2200

Earliest year to include (inclusive).

year_to

integer · min: 1800 · max: 2200

Latest year to include (inclusive).

Get movie recommendations › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get movie recommendations › Responses

The requested data. Examples use illustrative values.

anyOf

At least one variant must match. Multiple variants may match simultaneously.

Decision Table

Variant	Matching Criteria
	type = object · requires: data, pagination
	type = object · requires: data, pagination

Properties for Variant 1:

object[] · required

object · required

People