class

Tmdb::Movie

Inherits Tmdb::ImageUrls < Tmdb::PosterUrls < Reference < Object

Constructors

detail(id : Int64, language : String | Nil = nil) : Movie

Get the primary information about a movie.

Source
latest(language : String | Nil = nil, skip_cache : Bool = false) : Movie

Get the most newly created movie. This is a live response and will continuously change.

Source
new(data : JSON::Any)
Source

Class methods

now_playing(language : String | Nil = nil, region : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(MovieResult)

Get a list of movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.

You can optionally specify a region prameter which will narrow the search to only look for theatrical release dates within the specified country.

Source
popular(language : String | Nil = nil, region : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(MovieResult)

Get a list of the current popular movies on TMDB. This list updates daily.

Source
top_rated(language : String | Nil = nil, region : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(MovieResult)

Get the top rated movies on TMDB.

Source
upcoming(language : String | Nil = nil, region : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(MovieResult)

Get a list of upcoming movies in theatres. This is a release type query that looks for all movies that have a release type of 2 or 3 within the specified date range.

You can optionally specify a region prameter which will narrow the search to only look for theatrical release dates within the specified country.

Source

Instance methods

adult?
Source
alternative_titles(country : String | Nil = nil) : Array(AlternativeTitle)

Get all of the alternative titles for a movie.

Source
backdrop_path
Source
backdrops(language : String | Nil = nil, include_image_language : Array(String) | Nil = nil) : Array(Backdrop)

See #images

Source
belongs_to_collection
Source
budget
Source
cast(language : String | Nil = nil) : Array(Movie::Cast)
Source
changes(start_date : Time | Nil = nil, end_date : Time | Nil = nil) : Array(Change)

Get the changes for a movie. By default only the last 24 hours are returned.

You can query up to 14 days in a single query by using the start_date and end_date query parameters.

Source
credits(language : String | Nil = nil) : Array(Movie::Cast | Movie::Crew)

Get the cast and crew for a movie.

Source
crew(language : String | Nil = nil) : Array(Movie::Crew)
Source
external_ids

Get the external ids for a movie. We currently support the following external sources.

  • IMDb ID
  • Facebook
  • Instagram
  • Twitter
Source
genres
Source
homepage
Source
images(language : String | Nil = nil, include_image_language : Array(String) | Nil = nil) : Array(Backdrop | Poster)

Get the images that belong to a movie.

Querying images with a language parameter will filter the results. If you want to include a fallback language (especially useful for backdrops) you can use the include_image_language parameter. This should be a comma seperated value like so: include_image_language=en,null.

Source
imdb_id
Source
keywords

Get the keywords that have been added to a movie.

Source
original_language
Source
original_title
Source
overview
Source
popularity
Source
poster_path
Source
posters(language : String | Nil = nil, include_image_language : Array(String) | Nil = nil) : Array(Poster)

See #images

Source
production_companies
Source
production_countries
Source
recommendations(language : String | Nil = nil) : LazyIterator(MovieResult)

Get a list of recommended movies for a movie.

Source
release_date
Source
release_dates

Get the release date along with the certification for a movie.

Source
revenue
Source
runtime
Source
similar_movies(language : String | Nil = nil) : LazyIterator(MovieResult)

Get a list of similar movies. This is not the same as the "Recommendation" system you see on the website.

These items are assembled by looking at keywords and genres.

Source
spoken_languages
Source
status
Source
tagline
Source
title
Source
translations

Get a list of translations that have been created for a movie.

Source
user_reviews(language : String | Nil = nil) : LazyIterator(Review)

Get the user reviews for a movie.

Source
video?
Source
videos(language : String | Nil = nil) : Array(Video)

Get the videos that have been added to a movie.

Source
vote_average
Source
vote_count
Source
watch_providers

Powered by our partnership with JustWatch, you can query this method to get a list of the availabilities per country by provider.

This is not going to return full deep links, but rather, it's just enough information to display what's available where.

You can link to the provided TMDB URL to help support TMDB and provide the actual deep links to the content.

Please note: In order to use this data you must attribute the source of the data as JustWatch. If we find any usage not complying with these terms we will revoke access to the API.

Source

Nested types