| 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)