# IMDb API

> 4 public methods for IMDb (imdb.com), each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by IMDb.

- Page: https://fous.com/methods/imdb.com

## Methods

### [List top charts](https://fous.com/methods/imdb.com/list-top-charts.md)

`imdb.com/list_top_charts`, read. Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.

Returns: rank, title, year, IMDb rating, votes, runtime, age rating, IMDb link, weekly rank change, title ID, runtime minutes

### [Get IMDb Parents Guide](https://fous.com/methods/imdb.com/get-parents-guide.md)

`imdb.com/get_parents_guide`, read. Gets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release.

Returns: title, year, IMDb link, age certifications by country, Parents Guide categories with severity, vote counts and example descriptions

### [Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md)

`imdb.com/get_movie_or_show`, read. Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.

Returns: title, type, years, rating, votes, metascore, age rating, runtime, genres, plot, directors, writers, cast, countries, languages, release date, budget, gross, awards, poster, link

### [Get film person](https://fous.com/methods/imdb.com/get-person.md)

`imdb.com/get_person`, read. Finds a film person on IMDb by name, IMDb person link or person ID and returns their biography, awards summary, known-for titles and filmography (without self-appearances, archive footage and thanks).

Returns: name, professions, known-for titles, birth and death dates, birthplace, short biography, awards summary, photo, IMDb link, filmography with year, role, type and rating