TMDb library by dom53

A library/wrapper of TMDb's API - themoviedb.org Still in alpha!

GitHub repository is updated earlier and regularly than NuGet

Required Newtonsoft.Json

Warning

Always use try - catch to wrapper your code

try
{
    //your code
}
catch (ApiException ex)
{
    Console.WriteLine(ex);
}

Examples

Movies

Getting basic info for "The Lord of the Rings: The Return of the King".

TmdbClient mdbClient = new TmdbClient("your_api_key");
Movie movie = await mdbClient.GetMovieDetails(122, new UrlParameters {
    {"append_to_response", "videos,images"}
});

Console.WriteLine("Movie      : {0}", movie.title);
Console.WriteLine("Popularity : {0}", movie.popularity);
Console.WriteLine("Runtime    : {0}", movie.runtime);

Simple example of Discover movies. Discover search movie by UrlParameters.

Discover

TmdbClient mdbClient = new TmdbClient("your_api_key");
ResultObject<DiscoverMovie> movieObject = await mdbClient.DiscoverMovie(new UrlParameters {
    {"language", "cs-CZ"},
    {"include_adult", "false" },
    {"primary_release_year", "2019" }
});

Console.WriteLine(movieObject.total_results);       // Get number of total result
Console.WriteLine(movieObject.total_pages);         // Get number of total pages
Console.WriteLine(movieObject.page);                // Get page

foreach (var movie_item in movieObject.results)
{
    Console.WriteLine("Title: {0}\nVote: {1}", movie_item.title, movie_item.vote_average);
}

Authentication

Login

TmdbClient mdbClient = new TmdbClient("your_api_key");
bool isLogin = await mdbClient.Login("username", "password");

Logout

TmdbClient mdbClient = new TmdbClient("your_api_key");
bool isLogout = await mdbClient.Logout();

Movie Rating

For methods that required authentication you has to be login woth you credentials

TmdbClient mdbClient = new TmdbClient("your_api_key");
bool movieRated = await mdbClient.RateMovie(movie_id_int, movie_rate);

Tips

• All methods are async and awaitable
• Most methods are very straightforward, and do as they are named (you get info as they are named), movie, person etc.
• Each Class has its own toString method for prinit basic info about movie, tv etc...
• All UrlParameters you can find on official TMDb api doc (table Query String) for example: UrlParameters for DiscoverMovie

ResultObject class

List of classes they require ResultObject

• DiscoverMovie
• DiscoverTv
• SearchMovie
• SearchTvShows
• SimilarMovie
• SimilarTv
• TrendingMovie

Changelog

Next update

• Add almost all Tv methods
• Add almost all Search methods
• Little edit in folder structure and some methods (not so important)
• Add DeleteTvRating and DeleteMovieRating methods
• Methods Get, Post and Deleted are now available for override

1.0.3.0

• Add all Movies method except (GetAccountStates, GetLists, GetNowPlaying, GetLatest)

1.0.2.2

• Add all endpoints (it does not include methods, methods will be added individually next updates)

1.0.2.1

• Authentication (login, logout)
• Methods Get, Post and Deleted are now protected

Plans to the future

• Authentication (in progress)
• Account methods
• Create all get method
• Create list of available methods
• Create better documentation