search_tv {TMDb}R Documentation

Search for TV shows by title.

Description

Retrieve all the TV shows ID that match (entirely or partially) the query.

Usage

search_tv(api_key, query, page = 1, language = NA, first_air_date_year = NA,
search_type = "phrase")

Arguments

api_key

Your TMDb Consumer Key.

query

A CGI escaped string.

page

The number of the page to show. Minimum 1, maximum 1000.

language

A ISO 639-1 code.

first_air_date_year

Filter the results to only match shows that have a air date with with value.

search_type

By default, the search type is 'phrase'. This is almost guaranteed the option you will want. It's a great all purpose search type and by far the most tuned for every day querying. For those wanting more of an "autocomplete" type search, set this option to 'ngram'.

Value

A list with the following fields:

page

The current page for the results.

results

The TV shows that match the query.

total_pages

The number of pages for the results.

total_results

The number of results.

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"

search_tv(api_key = api_key, query = "Game of Thrones")

## End(Not run)

[Package TMDb version 1.1 Index]