get_shows: Get Spotify catalog information for multiple shows identified...

View source: R/shows.R

get_showsR Documentation

Get Spotify catalog information for multiple shows identified by their Spotify IDs.

Description

Get Spotify catalog information for multiple shows identified by their Spotify IDs.

Usage

get_shows(
  ids,
  market = NULL,
  authorization = get_spotify_authorization_code(),
  include_meta_info = FALSE
)

Arguments

ids

Required. A character vector of the Spotify IDs for the shows. Maximum: 20 IDs.

market

Optional.
An ISO 3166-1 alpha-2 country code or the string "from_token". If a country code is specified, only shows and episodes that are available in that market will be returned. If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.

authorization

Required. A valid access token from the Spotify Accounts service. See the Web API authorization Guide for more details. Defaults to spotifyr::get_spotify_authorization_code(). The access token must have been issued on behalf of the current user.
Reading the user’s resume points on episode objects requires the user-read-playback-position scope. See Using Scopes.

include_meta_info

Optional. Boolean indicating whether to include full result, with meta information such as "total", and "limit". Defaults to FALSE.

Value

Returns a data frame of results containing show data. See https://developer.spotify.com/documentation/web-api/reference/shows/get-several-shows/ for more information.


spotifyr documentation built on Oct. 30, 2024, 9:13 a.m.