# themoviedb.org API

> 4 public methods for themoviedb.org, each 1 credit per completed run.

Unofficial. Not affiliated with or endorsed by themoviedb.org.

- Page: https://fous.com/methods/themoviedb.org

## Methods

### [Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md)

`themoviedb.org/get_movie`, read. Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.

Returns: title, original title, tagline, overview, release date, age rating, runtime, genres, user score, votes, budget, revenue, language, directors, writers, cast, trailers, where to watch, poster and backdrop images, TMDB link and ID

### [List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md)

`themoviedb.org/list_trending`, read. Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.

Returns: rank, title, year, type, user score, overview, poster link, TMDB link

### [Get TV show details](https://fous.com/methods/themoviedb.org/get-tv-show.md)

`themoviedb.org/get_tv_show`, read. Finds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country.

Returns: name, overview, first and last air dates, status, next and last episodes, season and episode counts, seasons, networks, creators, cast, genres, user score, where to watch, poster, TMDB link and ID

### [List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md)

`themoviedb.org/list_upcoming_movies`, read. Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score.

Returns: title, release date, genres, overview, user score, poster link, TMDB link