class Tmdb::Movie

Included Modules

Defined in:

movie.cr
movie/cast.cr
movie/credit_base.cr
movie/crew.cr

Constructors

Class Method Summary

Instance Method Summary

Instance methods inherited from module Tmdb::ImageUrls

backdrop_url(size : String = "original") : String backdrop_url

Instance methods inherited from module Tmdb::PosterUrls

poster_url(size : String = "original") : String poster_url

Constructor Detail

def self.detail(id : Int64, language : String | Nil = nil) : Movie #

Get the primary information about a movie.


[View source]
def self.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.


[View source]
def self.new(data : JSON::Any) #

[View source]

Class Method Detail

def self.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.


[View source]
def self.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.


[View source]
def self.top_rated(language : String | Nil = nil, region : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(MovieResult) #

Get the top rated movies on TMDB.


[View source]
def self.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.


[View source]

Instance Method Detail

def adult? : Bool #

[View source]
def alternative_titles(country : String | Nil = nil) : Array(AlternativeTitle) #

Get all of the alternative titles for a movie.


[View source]
def backdrop_path : String | Nil #

[View source]
def backdrops(language : String | Nil = nil, include_image_language : Array(String) | Nil = nil) : Array(Backdrop) #

See #images


[View source]
def belongs_to_collection : Collection | Nil #

[View source]
def budget : Int64 #

[View source]
def cast(language : String | Nil = nil) : Array(Movie::Cast) #

[View source]
def 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.


[View source]
def credits(language : String | Nil = nil) : Array(Movie::Cast | Movie::Crew) #

Get the cast and crew for a movie.


[View source]
def crew(language : String | Nil = nil) : Array(Movie::Crew) #

[View source]
def external_ids : Array(ExternalId) #

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

  • IMDb ID
  • Facebook
  • Instagram
  • Twitter

[View source]
def genres : Array(Genre) #

[View source]
def homepage : String | Nil #

[View source]
def id : Int64 #

[View source]
def 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.


[View source]
def imdb_id : String | Nil #

[View source]
def keywords : Array(Keyword) #

Get the keywords that have been added to a movie.


[View source]
def original_language : String #

[View source]
def original_title : String #

[View source]
def overview : String | Nil #

[View source]
def popularity : Float64 #

[View source]
def poster_path : String | Nil #

[View source]
def posters(language : String | Nil = nil, include_image_language : Array(String) | Nil = nil) : Array(Poster) #

See #images


[View source]
def production_companies : Array(Company) #

[View source]
def production_countries : Array(Country) #

[View source]
def recommendations(language : String | Nil = nil) : LazyIterator(MovieResult) #

Get a list of recommended movies for a movie.


[View source]
def release_date : Time | Nil #

[View source]
def release_dates : Array(Tuple(String, Array(Release))) #

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


[View source]
def revenue : Int64 #

[View source]
def runtime : Int32 | Nil #

[View source]
def 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.


[View source]
def spoken_languages : Array(Language) #

[View source]
def status : Status #

[View source]
def tagline : String | Nil #

[View source]
def title : String #

[View source]
def translations : Array(Translation) #

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


[View source]
def user_reviews(language : String | Nil = nil) : LazyIterator(Review) #

Get the user reviews for a movie.


[View source]
def video? : Bool #

[View source]
def videos(language : String | Nil = nil) : Array(Video) #

Get the videos that have been added to a movie.


[View source]
def vote_average : Float64 #

[View source]
def vote_count : Int32 #

[View source]
def watch_providers : Hash(String, Watch) #

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.


[View source]