Skip to content
Miguel Hasse de Oliveira edited this page Mar 31, 2015 · 5 revisions

Movie Database .NET Client

Authentication

LoginAsync(string username, string password, CancellationToken cancellationToken)

This method is used to generate a valid request token and authenticate user with a TMDb username and password.

GetSessionAsync(string token, CancellationToken cancellationToken)

This method is used to generate a session id for user based authentication, or a guest session if a null token is used.

Movies

FindAsync(string id, string externalSource, CancellationToken cancellationToken)

The find method makes it easy to search for objects in our database by an external id. For instance, an IMDB ID. This will search all objects (movies, TV shows and people) and return the results in a single response. TV season and TV episode searches will be supported shortly.

SearchAsync(string query, string language, bool includeAdult, int page, CancellationToken cancellationToken)

Search for movies by title.

DiscoverAsync(string language, bool includeAdult, int? year, DateTime? minimumDate, DateTime? maximumDate, int? voteCount, decimal? voteAverage, string genres, string companies, int page, CancellationToken cancellationToken)

Discover movies by different types of data like average rating, number of votes, genres and certifications. You can get a valid list of certifications from the /certifications method.

GetAsync(int id, string language, bool appendAll, CancellationToken cancellationToken)

Get the basic movie information for a specific movie id.

GetImagesAsync(int id, string language, CancellationToken cancellationToken)

Get the images (posters and backdrops) for a specific movie id.

GetReviewsAsync(int id, string language, int page, CancellationToken cancellationToken)

Get the reviews for a particular movie id.

GetListsAsync(int id, string language, int page, CancellationToken cancellationToken)

Get the lists that the movie belongs to.

GetCreditsAsync(int id, CancellationToken cancellationToken)

Get the cast and crew information for a specific movie id.

GetVideosAsync(int id, string language, CancellationToken cancellationToken)

Get the videos (trailers, teasers, clips, etc...) for a specific movie id.

GetSimilarAsync(int id, string language, int page, CancellationToken cancellationToken)

Get the similar movies for a specific movie id.

GetGuestRatedAsync(string session, string language, int page, CancellationToken cancellationToken)

Get a list of rated movies for a specific guest session id.

GetPopularAsync(string language, int page, CancellationToken cancellationToken)

Get the list of popular movies on The Movie Database. This list refreshes every day.

GetTopRatedAsync(string language, int page, CancellationToken cancellationToken)

Get the list of top rated movies. By default, this list will only include movies that have 10 or more votes. This list refreshes every day.

GetNowPlayingAsync(string language, int page, CancellationToken cancellationToken)

Get the list of movies playing in theatres. This list refreshes every day. The maximum number of items this list will include is 100.

GetUpcomingAsync(string language, int page, CancellationToken cancellationToken)

Get the list of upcoming movies. This list refreshes every day. The maximum number of items this list will include is 100.

GetAlternativeTitlesAsync(int id, string language, CancellationToken cancellationToken)

Get the alternative titles for a specific movie id.

GetKeywordsAsync(int id, CancellationToken cancellationToken)

Get the plot keywords for a specific movie id.

GetReleasesAsync(int id, CancellationToken cancellationToken)

Get the release date and certification information by country for a specific movie id.

GetTranslationsAsync(int id, CancellationToken cancellationToken)

Get the translations for a specific movie id.

GetChangesAsync(DateTime? minimumDate, DateTime? maximumDate, int page, CancellationToken cancellationToken)

Get a list of movie ids that have been edited. The maximum number of days that can be returned in a single request is 14.

Shows

SearchAsync(string query, string language, DateTime? firstAirDate, int page, CancellationToken cancellationToken)

Search for TV shows by title.

DiscoverAsync(string language, int? year, DateTime? minimumDate, DateTime? maximumDate, int? voteCount, decimal? voteAverage, string genres, string networks, int page, CancellationToken cancellationToken)

Discover TV shows by different types of data like average rating, number of votes, genres, the network they aired on and air dates.

GetAsync(int id, string language, bool appendAll, CancellationToken cancellationToken)

Get the primary information about a TV series by id.

GetSeasonAsync(int id, int season, string language, bool appendAll, CancellationToken cancellationToken)

Get the primary information about a TV season by its season number.

GetEpisodeAsync(int id, int season, int episode, string language, bool appendAll, CancellationToken cancellationToken)

Get the primary information about a TV episode by combination of a season and episode number.

GetIdsAsync(int id, int? season, int? episode, CancellationToken cancellationToken)

Get the external ids for a TV series by id, TV season by its season number, or TV episode by combination of a season and episode number.

GetCreditsAsync(int id, CancellationToken cancellationToken)

Get the cast & crew information about a TV series. Just like the website, we pull this information from the last season of the series.

GetImagesAsync(int id, int? season, int? episode, string language, CancellationToken cancellationToken)

Get the images (episode stills) for a TV series by id, TV season by its season number, or TV episode by combination of a season and episode number. Since episode stills don't have a language, this call will always return all images.

GetSimilarAsync(int id, string language, int page, CancellationToken cancellationToken)

Get the similar TV shows for a specific tv id.

GetVideosAsync(int id, int? season, int? episode, string language, CancellationToken cancellationToken)

Get the videos that have been added to a TV series (trailers, opening credits, etc...)

GetTranslationsAsync(int id, CancellationToken cancellationToken)

Get the list of translations that exist for a TV series. These translations cascade down to the episode level.

GetPopularAsync(string language, int page, CancellationToken cancellationToken)

Get the list of popular TV shows. This list refreshes every day.

GetTopRatedAsync(string language, int page, CancellationToken cancellationToken)

Get the list of top rated TV shows. By default, this list will only include TV shows that have 2 or more votes. This list refreshes every day.

GetChangesAsync(DateTime? minimumDate, DateTime? maximumDate, int page, CancellationToken cancellationToken)

Get a list of TV show ids that have been edited. The maximum number of days that can be returned in a single request is 14.

GetNetworkAsync(int id, CancellationToken cancellationToken)

This method is used to retrieve the basic information about a TV network. You can use this ID to search for TV shows with the discover.

Companies

GetAsync(int id, CancellationToken cancellationToken)

This method is used to retrieve all of the basic information about a company.

GetMoviesAsync(int id, string language, int page, CancellationToken cancellationToken)

Get the list of movies associated with a particular company.

SearchAsync(string query, int page, CancellationToken cancellationToken)

Search for companies by name.

Genres

GetAsync(DataInfoType type, CancellationToken cancellationToken)

Get the list of genres.

GetMoviesAsync(int id, string language, bool includeAdult, int page, CancellationToken cancellationToken)

Get the list of movies for a particular genre by id. By default, only movies with 10 or more votes are included.

People

GetAsync(int id, bool appendAll, CancellationToken cancellationToken)

Get the general person information for a specific id.

GetCreditsAsync(int id, string language, DataInfoType type, CancellationToken cancellationToken)

Get the movie credits for a specific person id.

GetImagesAsync(int id, CancellationToken cancellationToken)

Get the images for a specific person id.

GetIdsAsync(int id, CancellationToken cancellationToken)

Get the external ids for a specific person id.

SearchAsync(string query, bool includeAdult, int page, CancellationToken cancellationToken)

Search for people by name.

GetChangesAsync(DateTime? minimumDate, DateTime? maximumDate, int page, CancellationToken cancellationToken)

Get a list of people ids that have been edited. The maximum number of days that can be returned in a single request is 14.

Collections

GetAsync(int id, string language, bool appendAll, CancellationToken cancellationToken)

Get the basic collection information for a specific collection id.

GetImagesAsync(int id, string language, CancellationToken cancellationToken)

Get all of the images for a particular collection by collection id.

SearchAsync(string query, string language, int page, CancellationToken cancellationToken)

Search for collections by name.

Lists

GetAsync(string id, CancellationToken cancellationToken)

Get a list by id.

ContainsAsync(string id, int movieId, CancellationToken cancellationToken)

Check to see if a movie ID is already added to a list.

CreateAsync(string session, string name, string description, string language, CancellationToken cancellationToken)

This method lets users create a new list. A valid session id is required.

InsertAsync(string session, string id, string mediaId, CancellationToken cancellationToken)

This method lets users add new movies to a list that they created. A valid session id is required.

RemoveAsync(string session, string id, string mediaId, CancellationToken cancellationToken)

This method lets users delete movies from a list that they created. A valid session id is required.

ClearAsync(string session, string id, CancellationToken cancellationToken)

Clear all of the items within a list. This is a irreversible action and should be treated with caution. A valid session id is required.

DeleteAsync(string session, string id, CancellationToken cancellationToken)

Delete a list by id.

Reviews

GetAsync(string id, CancellationToken cancellationToken)

Get the full details of a review by id.

Settings

GetCertificationsAsync(DataInfoType type, CancellationToken cancellationToken)

Get the list of supported certifications for movie and/or tv shows.

GetConfigurationAsync(CancellationToken cancellationToken)

Get the system wide configuration information. Some elements of the API require some knowledge of this configuration data.

GetTimezonesAsync(CancellationToken cancellationToken)

Get the list of supported timezones for the API methods that support them.

GetJobsAsync(CancellationToken cancellationToken)

Get a list of valid jobs.