Upcoming
Get a list of movies that are being released soon.
Returns a paginated list of movies that are scheduled for upcoming theatrical release.
Results are filtered by region when a region parameter is provided.
async upcoming(params?: MovieListParams): Promise<MovieDateRangeList>TMDB Reference: Movie Upcoming
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
language | Language | ❌ | Language for localized titles and overviews. Defaults to en-US. |
page | number | ❌ | Page number for paginated results. Defaults to 1. |
region | CountryISO3166_1 | ❌ | ISO 3166-1 country code to filter results by country. |
Returns
A MovieDateRangeList — a
PaginatedResponse<MovieResultItem> plus a dates
field reporting the release-date window this list was queried over.
Example
import { TMDB } from "@lorenzopant/tmdb";
const tmdb = new TMDB("your-api-key");
const { results } = await tmdb.movieLists.upcoming();
// With params
const italian = await tmdb.movieLists.upcoming({ language: "it-IT", region: "IT" });