find_tmdb {TMDb}R Documentation

Retrieve objects in TMDb database by an external id.

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)    

[Package TMDb version 1.1 Index]