Images
Get backdrops, logos, and posters for a movie.
Get images associated with a movie. If a language is specified it acts as a filter on the results.
Use include_image_language to include images from additional languages.
async images(params: MovieImagesParams): Promise<MovieImages>TMDB Reference: Movie Images
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
movie_id | number | ✅ | TMDB movie identifier. |
language | Language | LanguageISO6391 | ❌ | Language for image metadata. Defaults to en-US. |
include_image_language | (Language | "null")[] | ❌ | Languages to include images for. Pass an array (e.g., ["en", "null"]). Use "null" to include untagged images. |
Returns
Example
const { backdrops, posters, logos } = await tmdb.movies.images({
movie_id: 550,
language: "en-US",
include_image_language: ["en", "null"],
});