trakt_get: Make an API call and receive parsed output

In jemus42/tRakt: Get Data from 'trakt.tv'

Make an API call and receive parsed output

Description

The most basic form of API interaction: Querying a specific URL and getting its parsed result. If the response is empty, the function returns an empty tibble(), and if there are date-time variables present in the response, they are converted to POSIXct via lubridate::ymd_hms() or to Date via lubridate::as_date() if the variable only contains date information.

Usage

trakt_get(url, client_id = Sys.getenv("trakt_client_id"), HEAD = FALSE)

Arguments

url	character(1): The API endpoint. Either a full URL like "https://api.trakt.tv/shows/breaking-bad" or just the endpoint like shows/breaking-bad.
client_id	character(1): API client ID. If no value is set, this defaults to the package's client ID. See trakt_credentials for further information.
HEAD	logical(1) [FALSE]: If TRUE, only a HTTP HEAD request is performed and its content returned. This is useful if you are only interested in status codes or other headers, and don't want to waste resources/bandwidth on the response body.

Details

See the official API reference for a detailed overview of available methods. Most methods of potential interest for data collection have dedicated functions in this package.

Value

The parsed (jsonlite::fromJSON()) content of the API response. An empty tibble() if the response is an empty JSON array.

Note

No OAuth2 methods are supported yet, meaning you don't have access to POST methods or user information of non-public profiles.

See Also

Other API-basics: trakt_credentials(), trakt_get_token()

Examples

# A simple request to a direct URL
trakt_get("https://api.trakt.tv/shows/breaking-bad")

# A HEAD-only request
# useful for validating a URL exists or the API is accessible
trakt_get("https://api.trakt.tv/users/jemus42", HEAD = TRUE)

# Optionally be lazy about URL specification by dropping the hostname:
trakt_get("shows/game-of-thrones")

jemus42/tRakt documentation built on March 5, 2025, 11:08 a.m.