OmdbApiNet 1.1.0

OMDbApiNet is a .NET Standard 2.0 API (REST client) for the Open Movie Database (http://www.omdbapi.com/) to obtain IMDb data.

There is a newer version of this package available.
See the version list below for details.
Install-Package OmdbApiNet -Version 1.1.0
dotnet add package OmdbApiNet --version 1.1.0
<PackageReference Include="OmdbApiNet" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add OmdbApiNet --version 1.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

OMDb-API.NET

OMDb-API.NET is a .NET Standard 2.0 (C#) REST client for the Open Movie Database API, a web service to obtain movie information as found on IMDb.

Usage

Create OMDb Client

    var omdb = new OmdbClient("your_apikey");
    
    // enable ratings from Rotten Tomatoes
    var omdb = new OmdbClient("your_apikey", true);

You can get an api key on the OMDb website.

Get an Item (movie or series)

    // Item GetItemByTitle(string title, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title");
    var item = omdb.GetItemByTitle("title", true);

    // Item GetItemByTitle(string title, OmdbType type, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", OmdbType.Movie);
    var item = omdb.GetItemByTitle("title", OmdbType.Series, true);
    
    // Item GetItemByTitle(string title, int? year, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", 2017);
    var item = omdb.GetItemByTitle("title", 2017, true);
    
    // Item GetItemByTitle(string title, OmdbType type, int? year, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", OmdbType.Series, 2017);
    var item = omdb.GetItemByTitle("title", OmdbType.Movie, 2017, true);

    // Item GetItemById(string id, bool fullPlot = false);
    var item = omdb.GetItemById("imdb_id");
    var item = omdb.GetItemById("imdb_id", true);

You can get the type of an item with item.Type. item.Type can either be &quot;movie&quot;, &quot;series&quot; or &quot;episode&quot;.
For getting an episode use GetEpisodeBySeriesId(), GetEpisodeBySeriesTitle() or GetEpisodeByEpisodeId() instead.

Get an Episode

    // Episode GetEpisodeBySeriesId(string seriesId, int seasonNumber, int episodeNumber);
    var episode = omdb.GetEpisodeBySeriesId("imdb_series_id", 1, 1);
    
    // Episode GetEpisodeBySeriesTitle(string seriesTitle, int seasonNumber, int episodeNumber);
    var episode = omdb.GetEpisodeBySeriesTitle("imdb_series_title", 1, 1);
    
    // Episode GetEpisodeByEpisodeId(string episodeId);
    var episode = omdb.GetEpisodeByEpisodeId("imdb_id");

Get a Season

    // Season GetSeasonBySeriesId(string seriesId, int seasonNumber);
    var season = omdb.GetSeasonBySeriesId("imdb_series_id", 1);
    
    // Season GetSeasonBySeriesTitle(string seriesTitle, int seasonNumber);
    var season = omdb.GetSeasonBySeriesTitle("imdb_series_title", 1);

Get Search Results (movies and series)

    // SearchList GetSearchList(string query, int page = 1);
    var searchList = omdb.GetSearchList("query");
    var searchList = omdb.GetSearchList("query", 2);
    
    // SearchList GetSearchList(string query, OmdbType type, int page = 1);
    var searchList = omdb.GetSearchList("query", OmdbType.Movie);
    var searchList = omdb.GetSearchList("query", OmdbType.Series, 2);
    
    // SearchList GetSearchList(int? year, string query, int page = 1);
    var searchList = omdb.GetSearchList(2017, "query");
    var searchList = omdb.GetSearchList(2017, "query", 2);
    
    // SearchList GetSearchList(int? year, string query, OmdbType type, int page = 1);
    var searchList = omdb.GetSearchList(2017, "query", OmdbType.Movie);
    var searchList = omdb.GetSearchList(2017, "query", OmdbType.Series, 2);

The query can contain whitespaces.

OMDb-API.NET

OMDb-API.NET is a .NET Standard 2.0 (C#) REST client for the Open Movie Database API, a web service to obtain movie information as found on IMDb.

Usage

Create OMDb Client

    var omdb = new OmdbClient("your_apikey");
    
    // enable ratings from Rotten Tomatoes
    var omdb = new OmdbClient("your_apikey", true);

You can get an api key on the OMDb website.

Get an Item (movie or series)

    // Item GetItemByTitle(string title, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title");
    var item = omdb.GetItemByTitle("title", true);

    // Item GetItemByTitle(string title, OmdbType type, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", OmdbType.Movie);
    var item = omdb.GetItemByTitle("title", OmdbType.Series, true);
    
    // Item GetItemByTitle(string title, int? year, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", 2017);
    var item = omdb.GetItemByTitle("title", 2017, true);
    
    // Item GetItemByTitle(string title, OmdbType type, int? year, bool fullPlot = false);
    var item = omdb.GetItemByTitle("title", OmdbType.Series, 2017);
    var item = omdb.GetItemByTitle("title", OmdbType.Movie, 2017, true);

    // Item GetItemById(string id, bool fullPlot = false);
    var item = omdb.GetItemById("imdb_id");
    var item = omdb.GetItemById("imdb_id", true);

You can get the type of an item with item.Type. item.Type can either be &quot;movie&quot;, &quot;series&quot; or &quot;episode&quot;.
For getting an episode use GetEpisodeBySeriesId(), GetEpisodeBySeriesTitle() or GetEpisodeByEpisodeId() instead.

Get an Episode

    // Episode GetEpisodeBySeriesId(string seriesId, int seasonNumber, int episodeNumber);
    var episode = omdb.GetEpisodeBySeriesId("imdb_series_id", 1, 1);
    
    // Episode GetEpisodeBySeriesTitle(string seriesTitle, int seasonNumber, int episodeNumber);
    var episode = omdb.GetEpisodeBySeriesTitle("imdb_series_title", 1, 1);
    
    // Episode GetEpisodeByEpisodeId(string episodeId);
    var episode = omdb.GetEpisodeByEpisodeId("imdb_id");

Get a Season

    // Season GetSeasonBySeriesId(string seriesId, int seasonNumber);
    var season = omdb.GetSeasonBySeriesId("imdb_series_id", 1);
    
    // Season GetSeasonBySeriesTitle(string seriesTitle, int seasonNumber);
    var season = omdb.GetSeasonBySeriesTitle("imdb_series_title", 1);

Get Search Results (movies and series)

    // SearchList GetSearchList(string query, int page = 1);
    var searchList = omdb.GetSearchList("query");
    var searchList = omdb.GetSearchList("query", 2);
    
    // SearchList GetSearchList(string query, OmdbType type, int page = 1);
    var searchList = omdb.GetSearchList("query", OmdbType.Movie);
    var searchList = omdb.GetSearchList("query", OmdbType.Series, 2);
    
    // SearchList GetSearchList(int? year, string query, int page = 1);
    var searchList = omdb.GetSearchList(2017, "query");
    var searchList = omdb.GetSearchList(2017, "query", 2);
    
    // SearchList GetSearchList(int? year, string query, OmdbType type, int page = 1);
    var searchList = omdb.GetSearchList(2017, "query", OmdbType.Movie);
    var searchList = omdb.GetSearchList(2017, "query", OmdbType.Series, 2);

The query can contain whitespaces.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.3.0 908 7/28/2019
1.2.0 1,002 2/2/2019
1.1.0 295 10/26/2018