watway/WatTMDB

.NET Library for use with Version 3 API available from The Movie Db (migrated from CodePlex)

WatTMDB

.NET Library for use with Version 3 API available from The Movie Db

Migrated from https://wattmdb.codeplex.com/

Website: http://www.themoviedb.org API: http://docs.themoviedb.apiary.io

Note: you will need to request an API key from TMDb to be able to use this library. Instructions to obtain an API key can be found here.

The library takes advantage of RestSharp to simplify the requests and JSON responses.

Using the Library

Add a reference to WatTmdb.dll to your project.

The main api class is Tmdb in the WatTmdb.V3 namespace. The constructer takes your API key, and also an option language string, for example "en", or you can pass null.

WatTmdb.V3.Tmdb api = new Tmdb("apikey", "en");
or
WatTmdb.V3.Tmdb api = new Tmdb("apikey");

The api class contains most of the methods currently available by The Movie Db service, except those that are used for updating information back into The Movie Db.

Available Methods

Configuration

http://help.themoviedb.org/kb/api/configuration

TmdbConfiguration GetConfiguration()

Searching

http://help.themoviedb.org/kb/api/search

TmdbMovieSearch SearchMovie(string query, int page)
TmdbPersonSearch SearchPerson(string query, int page)
TmdbCompanySearch SearchCompany(string query, int page)

Movie Collections

http://help.themoviedb.org/kb/api/collections

TmdbCollection GetCollectionInfo(int CollectionID)

Movie Info

http://help.themoviedb.org/kb/api/movie-info-2

TmdbMovie GetMovieInfo(int MovieID)
TmdbMovie GetMovieByIMDB(string IMDB_ID)
TmdbMovieAlternateTitles GetMovieAlternateTitles(int MovieID, string Country)
TmdbMovieCast GetMovieCast(int MovieID)
TmdbMovieImages GetMovieImages(int MovieID)
TmdbMovieKeywords GetMovieKeywords(int MovieID)
TmdbMovieReleases GetMovieReleases(int MovieID)
TmdbMovieTrailers GetMovieTrailers(int MovieID)
TmdbSimilarMovies GetSimilarMovies(int MovieID, int page)
TmdbTranslations GetMovieTranslations(int MovieID)

Person Info

http://help.themoviedb.org/kb/api/person-info-2

TmdbPerson GetPersonInfo(int PersonID)
TmdbPersonCredits GetPersonCredits(int PersonID)
TmdbPersonImages GetPersonImages(int PersonID)

Miscellaneous Movie

http://help.themoviedb.org/kb/api/misc-movie

TmdbNowPlaying GetNowPlayingMovies(int page)
TmdbPopular GetPopularMovies(int page)
TmdbTopRated GetTopRatedMovies(int page)
TmdbUpcoming GetUpcomingMovies(int page)

Company Info

http://help.themoviedb.org/kb/api/company-info-2

TmdbCompany GetCompanyInfo(int CompanyID)
TmdbCompanyMovies GetCompanyMovies(int CompanyID, int page)

Genre Info

http://help.themoviedb.org/kb/api/genre-info

TmdbGenre GetGenreList()
TmdbGenreMovies GetGenreMovies (int GenreID)

Authentication Methods

1. GetAuthToken - generate a valid request token for user based authentication. TMDB api
2. GetAuthSession - generate a session id for user based authentication. TMDB api
3. GetGuestSession - generate a guest session id. TMDB api

Account Methods

1. GetAccountInfo - get basic information for an account TMDB api
2. GetAccountLists - get lists that have been created and movies marked as a favourite TMDB api
3. GetAccountRatedMovies - get list of rated movies for an account TMDB api
4. GetAccountWatchlistMovies - get list of movies on an accounts watchlist TMDB api

Changes Methods

1. GetChangesByMovie - Get list of movie ides that have been edited. Defaults to changes in the last 24 hours. Then use the method GetMovieChanges to get the data that has changed. TMDB api
2. GetChangesByPerson - Get list of person ids that have been edited. Defaults to changes in the last 24 hours. Then use the method GetPersonChanges to get the data that has changed. TMDB api

Keyword Methods

1. GetKeyword - get the basic information for a specific keyword id. TMDB api
2. GetKeywordMovies - get the list of movies for a particular keyword by id. TMDB api

Movie Methods

1. GetMovieLists - get the lists that the movie belongs to. TMDB api
2. GetMovieChanges - get list of changes for a specific movie. TMDB api

Person Methods

1. GetPersonChanges - get the list of changes for a specific person. TMDB api

If you're after a list of the Genres available, you can use the GetGenreList method.