find_tmdb: Retrieve objects in TMDb database by an external id.

In TMDb: Access to TMDb API

Description

The find method makes it easy to search for objects in our database by an external id. For instance, an IMDB ID. This will search all objects (movies, TV shows and people) and return the results in a single response. TV season and TV episode searches will be supported shortly.

Usage

find_tmdb(api_key, id, external_source, language = NA)

Arguments

api_key	Your TMDb Consumer Key.
id	The supported external sources for each object are as follows: - Movies: imdb_id - People: imdb_id, freebase_mid, freebase_id, tvrage_id - Series: imdb_id, freebase_mid, freebase_id, tvdb_id, tvrage_id - TV Seasons: freebase_mid, freebase_id, tvdb_id, tvrage_id - TV Episodes: imdb_id, freebase_mid, freebase_id, tvdb_id, tvrage_id
external_source	An external ID, like an IMDB ID.
language	A ISO 639-1 code.

Value

A list with the following fields:

movie_results	The results in the movies department.
person_results	The results in the person department.
tv_results	The results in the tv department.
tv_episode_results	The results in the tv_episode department.
tv_season_results	The results in the tv_season department.

Author(s)

Andrea Capozio

References

https://developers.themoviedb.org/3/getting-started

Examples

## Not run: 
## An example of an authenticated request,
## where api_key is fictitious.
## You can obtain your own at https://www.themoviedb.org/documentation/api

api_key <- "key"

find_tmdb(api_key = api_key, id = "tt0266543", external_source = "imdb_id")

## End(Not run)    

TMDb documentation built on March 17, 2020, 1:06 a.m.