imdb-api / imdbapilib

IMDb API is a web service for receiving movie, serial and cast information.

IMDbApiLib

The TV-API is a web service for receiving movie, serial and cast informations. APIs results is a JSON and includes items such as movie specifications, images, posters, trailers, ratings, Wikipedia page content and more. see more »

Nuget

Install from Nuget using the command: Install-Package IMDbApiLib View more about that here: https://nuget.org/packages/IMDbApiLib

API Documentation

https://tv-api.com/api

Usage

Usage Examples

var apiLib = new ApiLib("API-Key");

// Search
var data = await apiLib.SearchMovieAsync("leon the professional 1994");

// Title Data
var data = await apiLib.TitleAsync("tt0110413");

// Title Data (French Language)
var data = await apiLib.TitleAsync("tt0110413", Language.fr);

// Title Data - Get Full Data
var data = await apiLib.TitleAsync("tt0110413", Language.en, "FullActor,FullCast,Posters,Images,Trailer,Ratings,Wikipedia");

// Report - As PNG File
var data = await apiLib.ReportAsync("tt0110413", Language.en);

// Images (From IMDb)
var data = await apiLib.ImagesAsync("tt0110413");

// Posters (From TheMovieDb)
var data = await apiLib.PostersAsync("tt0110413");

// Trailer
var data = await apiLib.TrailerAsync("tt0110413");

// ExternalSites (Get Movie or Series TV in all external sites with Identifier and URL)
var data = await apiLib.ExternalSitesAsync("tt0110413");

// Ratings (Get ratings of Movie or Series TV in: IMDb, Metacritic, RottenTommatoes, TheMovieDb and TV.com)
var data = await apiLib.RatingsAsync("tt0110413");

// Wikipedia (PlainText and Html)
var data = await apiLib.WikipediaAsync("tt0110413", , IMDbApiLib.Models.Language.en);

// AdvancedSearch
var input = new AdvancedSearchInput();
input.Genres = AdvancedSearchGenre.Action | AdvancedSearchGenre.Adventure;
input.Sort = AdvancedSearchSort.User_Rating_Descending;
input.ReleaseDateFrom = "2010-01-01";
input.NumberOfVotesFrom = 5000;

input.Languages = AdvancedSearchLanguage.English | AdvancedSearchLanguage.French;
// OR - Multiple languages
//input.LanguagesStr = $"{AdvancedSearchLanguage.English.GetDescription()},{AdvancedSearchLanguage.French.GetDescription()}";

input.Countries = AdvancedSearchCountry.United_States;
// OR - Multiple countries
//input.CountriesStr = $"{AdvancedSearchCountry.United_States},{AdvancedSearchCountry.France},{AdvancedSearchCountry.United_Kingdom}";

string queryString = input.ToString();
var advancedSearchdata = await apiLib.AdvancedSearchAsync(input);

---

List of all APIs

Search APIs

• Search (expression)
• SearchTitle (expression)
• SearchMovie (expression)
• SearchSeries (expression)
• SearchName (expression)
• SearchEpisode (expression)
• SearchCompany (expression)
• SearchKeyword (expression)
• AdvancedSearch (params)

Title APIs

• Title (id, options?)
• Report (id, options?)
• FullCast (id)
• Posters (id)
• Images (id, options?)
• Trailer (id)
• Ratings (id)
• UserRatings (id)
• SeasonEpisodes (id, seasonNumber)
• ExternalSites (id)
• Wikipedia (id)
• Reviews (id)
• MetacriticReviews (id)
• FAQ (id)
• Awards (id)

Other APIs

• Top250Movies ()
• Top250TVs ()
• MostPopularMovies ()
• MostPopularTVs ()
• InTheaters ()
• ComingSoon ()
• BoxOffice ()
• BoxOfficeAllTime ()
• Name (nmId)
• NameAwards (nmId)
• Company (coId)
• Keyword (kwId)
• YouTubeTrailer (id)

Tools APIs

• Usage ()
• ResizeImage (WxH, url)
• ResizePoster (WxH, url)

imdbapilib's Issues

How to fetch all information about movie?

I have a movie "12 angry men". How to get all information about this movie?
I'm trying to do this:
var apiLib = new ApiLib("API-Key"); var data = await apiLib.SearchMovieAsync("12 angry men"); cw(data); // i doesn't return any information
If I had id (for example, tt0110413) I would try to do this:
var data = await apiLib.TitleAsync("tt0110413"); var title = data.title; //etc cw(title);

is the site down now?

The API is excellent, and I'm absolutely addicted to it. But now I wonder if the site is currently down for eyery one? I apologize if this message is bothering you.

macOS build

On the home page it says this is an Avalonia project but I can't see any references to Avalonia. This seems like a standard WinForms application. Am I missing something here? Thanks :-)

Search by IMDb Score

Wonder if it's possible to search all movies by a IMDb score range? Or really any search by genre, year, actor, or director. Is that something that could be accomplished the way the data is structured?

Is this API set fully compatible with the APIs of imdb.com?

Is the API set fully compatible with imdb.com's API?
Is there a list of differences?

Parse title Fr lang

Hello. How do I get a title in French?

Retrieve title of movie in specific language

Hi there,

I was wondering whether there is a possiblity to retrieve the title of a movie in a given language.

When I have the following code with the language 'de' for german:

TitleData? title = await api.TitleAsync("tt0241527", IMDbApiLib.Models.Language.de);

I get a TitleData object with the Title 'Harry Potter and the Sorcerer's Stone' and an empty string for the OriginalTitle.
Only the Plot is in german. But I need the title in german ('Harry Potter und der Stein der Weisen')

In some forums I found that you have to set the request header "Accept-Language" to the specific language, but I couldn't get that to work either.

Is there any way to get the title in german?

Advanced Search generates invalid URL for TitleType

AdvancedSearchInput.ToString() has title_type listed twice.

ie.

var input = new AdvancedSearchInput
{
     TitleType = AdvancedSearchTitleType.Video
};
var text = input.ToString();

will produce ?title_type=video&title_type=video

imdblib request

Hi!
it's possible to implement web proxy?
thanks!