class

Tmdb::Tv::Show

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

Constructors

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

Get the primary TV show details by id.

Source
latest(language : String | Nil = nil, skip_cache : Bool = false) : Show
Source
new(data : JSON::Any)
Source

Class methods

airing_today(language : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(ShowResult)

Get a list of TV shows that are airing today. This query is purely day based as we do not currently support airing times.

Source
on_the_air(language : String | Nil = nil, skip_cache : Bool = false) : LazyIterator(ShowResult)

Get a list of shows that are currently on the air.

This query looks for any TV show that has an episode with an air date in the next 7 days.

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

Get the top rated TV shows on TMDB.

Source

Instance methods

aggregated_credits(language : String | Nil = nil) : Array(Tv::AggregatedCast | Tv::AggregatedCrew)

Get the aggregate credits (cast and crew) that have been added to a TV show.

This call differs from the main #credits call in that it does not return the newest season but rather, is a view of all the entire cast & crew for all episodes belonging to a TV show.

Source
alternative_titles(language : String | Nil = nil) : Array(AlternativeTitle)

Returns all of the alternative titles for a TV show.

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

See #images

Source
changes(start_date : Time | Nil = nil, end_date : Time | Nil = nil) : Array(Change)

Get the changes for a TV show. 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.

TV show changes are different than movie changes in that there are some edits on seasons and episodes that will create a change entry at the show level. These can be found under the season and episode keys. These keys will contain a series_id and episode_id. You can use the season changes and episode changes methods to look these up individually.

Source
content_ratings(language : String | Nil = nil) : Array(Tv::Rating)

Get the list of content ratings (certifications) that have been added to a TV show.

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

Get the credits (cast and crew) that have been added to a TV show.

Source
episode_groups(language : String | Nil = nil) : Array(Tv::EpisodeGroupResult)

Get all of the episode groups that have been created for a TV show. With a group ID you can call the Tmdb::Tv::EpisodeGroup.detail method.

Source
episode_run_time
Source
external_ids(language : String | Nil = nil) : Array(ExternalId)

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

  • IMDb ID
  • TVDB ID
  • Freebase MID*
  • Freebase ID*
  • TVRage ID*
  • Facebook
  • Instagram
  • Twitter

* Defunct or no longer available as a service

Source
first_air_date
Source
genres
Source
homepage
Source
images(language : String | Nil = nil) : Array(Backdrop | Poster)

Get the images that belong to a TV show.

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
in_production?
Source
keywords

Get the keywords that have been added to a TV show.

Source
languages
Source
last_air_date
Source
last_episode_to_air
Source
name
Source
networks
Source
next_episode_to_air
Source
number_of_episodes
Source
number_of_seasons
Source
origin_country
Source
original_language
Source
original_name
Source
overview
Source
popularity
Source
poster_path
Source
posters(language : String | Nil = nil) : Array(Poster)

See #images

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

Get the list of TV show recommendations for this item.

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

Get the reviews for a TV show.

Source
screened_theatrically

Get a list of seasons or episodes that have been screened in a film festival or theatre.

Source
seasons
Source
similar_tv_shows(language : String | Nil = nil) : LazyIterator(ShowResult)

Get a list of similar TV shows. These items are assembled by looking at keywords and genres.

Source
spoken_languages
Source
status
Source
tagline
Source
translations

Get a list of the translations that exist for a TV show.

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

Get the videos that have been added to a TV show.

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