Package 'hoopR'

Title: Access Men's Basketball Play by Play Data
Description: A utility to quickly obtain clean and tidy men's basketball play by play data. Provides functions to access live play by play and box score data from ESPN<https://www.espn.com> with shot locations when available. It is also a full NBA Stats API<https://www.nba.com/stats/> wrapper. It is also a scraping and aggregating interface for Ken Pomeroy's men's college basketball statistics website<https://kenpom.com>. It provides users with an active subscription the capability to scrape the website tables and analyze the data for themselves.
Authors: Saiem Gilani [aut, cre, cph] (ORCID: <https://orcid.org/0000-0002-7194-9067>), Jason Lee [ctb], Billy Fryer [ctb], Ross Drucker [ctb], Vladislav Shufinskiy [ctb]
Maintainer: Saiem Gilani <[email protected]>
License: MIT + file LICENSE
Version: 3.1.0
Built: 2026-06-09 07:49:02 UTC
Source: https://github.com/sportsdataverse/hoopr

Help Index

Build player roster lookup from boxscore data

Description

Build player roster lookup from boxscore data

Add players on court in NBA Stats API play-by-play

Description

Add players on court in NBA Stats API play-by-play

Add players on court in NBA Stats API V3 play-by-play

Description

Add players on court in NBA Stats API V3 play-by-play

Convert V3 PBP columns to V2-compatible format

Description

Convert V3 PBP columns to V2-compatible format

Check Status function

Description

Check Status function

Usage

check_status(res)

Arguments

res

Response from API (httr2 response object)

Clean KenPom Data Frame Team Names to match NCAA Team Names for easier merging

Description

Clean KenPom Data Frame Team Names to match NCAA Team Names for easier merging

Usage

clean_team_names_NCAA_merge(df)

Arguments

df

KenPom dataframe

Load .csv / .csv.gz file from a remote connection

Description

This is a thin wrapper on data.table::fread

Usage

csv_from_url(...)

Arguments

...

Arguments passed on to data.table::fread

input

A single character string. The value is inspected and deferred to either file= (if no \n present), text= (if at least one \n is present) or cmd= (if no \n is present, at least one space is present, and it isn't a file name). Exactly one of input=, file=, text=, or cmd= should be used in the same call.

file

File name in working directory, path to file (passed through path.expand for convenience), or a URL starting http://, file://, etc. Compressed files with extension ‘.gz’ and ‘.bz2’ are supported if the R.utils package is installed.

text

The input data itself as a character vector of one or more lines, for example as returned by readLines().

cmd

A shell command that pre-processes the file; e.g. fread(cmd=paste("grep",word,"filename")). See Details.

sep

The separator between columns. Defaults to the character in the set [,\t |;:] that separates the sample of rows into the most number of lines with the same number of fields. Use NULL or "" to specify no separator; i.e. each line a single character column like base::readLines does.

sep2

The separator within columns. A list column will be returned where each cell is a vector of values. This is much faster using less working memory than strsplit afterwards or similar techniques. For each column sep2 can be different and is the first character in the same set above [,\t |;], other than sep, that exists inside each field outside quoted regions in the sample. NB: sep2 is not yet implemented.

nrows

The maximum number of rows to read. Unlike read.table, you do not need to set this to an estimate of the number of rows in the file for better speed because that is already automatically determined by fread almost instantly using the large sample of lines. nrows=0 returns the column names and typed empty columns determined by the large sample; useful for a dry run of a large file or to quickly check format consistency of a set of files before starting to read any of them.

header

Does the first data line contain column names? Defaults according to whether every non-empty field on the first data line is type character. If so, or TRUE is supplied, any empty column names are given a default name.

na.strings

A character vector of strings which are to be interpreted as NA values. By default, ",," for columns of all types, including type character is read as NA for consistency. ,"", is unambiguous and read as an empty string. To read ,NA, as NA, set na.strings="NA". To read ,, as blank string "", set na.strings=NULL. When they occur in the file, the strings in na.strings should not appear quoted since that is how the string literal ,"NA", is distinguished from ,NA,, for example, when na.strings="NA".

stringsAsFactors

Convert all or some character columns to factors? Acceptable inputs are TRUE, FALSE, or a decimal value between 0.0 and 1.0. For stringsAsFactors = FALSE, all string columns are stored as character vs. all stored as factor when TRUE. When stringsAsFactors = p for 0 <= p <= 1, string columns col are stored as factor if uniqueN(col)/nrow < p.

verbose

Be chatty and report timings?

skip

If 0 (default) start on the first line and from there finds the first row with a consistent number of columns. This automatically avoids irregular header information before the column names row. skip>0 means ignore the first skip rows manually. skip="string" searches for "string" in the file (e.g. a substring of the column names row) and starts on that line (inspired by read.xls in package gdata).

select

A vector of column names or numbers to keep, drop the rest. select may specify types too in the same way as colClasses; i.e., a vector of colname=type pairs, or a list of type=col(s) pairs. In all forms of select, the order that the columns are specified determines the order of the columns in the result.

drop

Vector of column names or numbers to drop, keep the rest.

colClasses

As in utils::read.csv; i.e., an unnamed vector of types corresponding to the columns in the file, or a named vector specifying types for a subset of the columns by name. The default, NULL means types are inferred from the data in the file. Further, data.table supports a named list of vectors of column names or numbers where the list names are the class names; see examples. The list form makes it easier to set a batch of columns to be a particular class. When column numbers are used in the list form, they refer to the column number in the file not the column number after select or drop has been applied. If type coercion results in an error, introduces NAs, or would result in loss of accuracy, the coercion attempt is aborted for that column with warning and the column's type is left unchanged. If you really desire data loss (e.g. reading 3.14 as integer) you have to truncate such columns afterwards yourself explicitly so that this is clear to future readers of your code.

integer64

"integer64" (default) reads columns detected as containing integers larger than 2^31 as type bit64::integer64. Alternatively, "double"|"numeric" reads as utils::read.csv does; i.e., possibly with loss of precision and if so silently. Or, "character".

dec

The decimal separator as in utils::read.csv. When "auto" (the default), an attempt is made to decide whether "." or "," is more suitable for this input. See details.

col.names

A vector of optional names for the variables (columns). The default is to use the header column if present or detected, or if not "V" followed by the column number. This is applied after check.names and before key and index.

check.names

default is FALSE. If TRUE then the names of the variables in the data.table are checked to ensure that they are syntactically valid variable names. If necessary they are adjusted (by make.names) so that they are, and also to ensure that there are no duplicates.

encoding

default is "unknown". Other possible options are "UTF-8" and "Latin-1". Note: it is not used to re-encode the input, rather enables handling of encoded strings in their native encoding.

quote

By default ("\""), if a field starts with a double quote, fread handles embedded quotes robustly as explained under Details. If it fails, then another attempt is made to read the field as is, i.e., as if quotes are disabled. By setting quote="", the field is always read as if quotes are disabled. It is not expected to ever need to pass anything other than \"\" to quote; i.e., to turn it off.

strip.white

Logical, default TRUE, in which case leading and trailing whitespace is stripped from unquoted "character" fields. "numeric" fields are always stripped of leading and trailing whitespace.

fill

logical or integer (default is FALSE). If TRUE then in case the rows have unequal length, number of columns is estimated and blank fields are implicitly filled. If an integer is provided it is used as an upper bound for the number of columns. If fill=Inf then the whole file is read for detecting the number of columns.

blank.lines.skip

logical, default is FALSE. If TRUE blank lines in the input are ignored.

comment.char

Character vector of length one containing a single character of an empty string. Any text after the comment character in a line is ignored, including skipping comment-only lines. Use "" to turn off the interpretation of comments altogether.

key

Character vector of one or more column names which is passed to setkey. Only valid when argument data.table=TRUE. Where applicable, this should refer to column names given in col.names.

index

Character vector or list of character vectors of one or more column names which is passed to setindexv. As with key, comma-separated notation like index="x,y,z" is accepted for convenience. Only valid when argument data.table=TRUE. Where applicable, this should refer to column names given in col.names.

showProgress

TRUE displays progress on the console if the ETA is greater than 3 seconds. It is produced in fread's C code where the very nice (but R level) txtProgressBar and tkProgressBar are not easily available.

data.table

TRUE returns a data.table. FALSE returns a data.frame. The default for this argument can be changed with options(datatable.fread.datatable=FALSE).

nThread

The number of threads to use. Experiment to see what works best for your data on your hardware.

logical01

If TRUE a column containing only 0s and 1s will be read as logical, otherwise as integer.

logicalYN

If TRUE a column containing only Ys and Ns will be read as logical, otherwise as character.

keepLeadingZeros

If TRUE a column containing numeric data with leading zeros will be read as character, otherwise leading zeros will be removed and converted to numeric.

yaml

If TRUE, fread will attempt to parse (using yaml.load) the top of the input as YAML, and further to glean parameters relevant to improving the performance of fread on the data itself. The entire YAML section is returned as parsed into a list in the yaml_metadata attribute. See Details.

tmpdir

Directory to use as the tmpdir argument for any tempfile calls, e.g. when the input is a URL or a shell command. The default is tempdir() which can be controlled by setting TMPDIR before starting the R session; see base::tempdir.

tz

Relevant to datetime values which have no Z or UTC-offset at the end, i.e. unmarked datetime, as written by utils::write.csv. The default tz="UTC" reads unmarked datetime as UTC POSIXct efficiently. tz="" reads unmarked datetime as type character (slowly) so that as.POSIXct can interpret (slowly) the character datetimes in local timezone; e.g. by using "POSIXct" in colClasses=. Note that fwrite() by default writes datetime in UTC including the final Z and therefore fwrite's output will be read by fread consistently and quickly without needing to use tz= or colClasses=. If the TZ environment variable is set to "UTC" (or "" on non-Windows where unset vs "" is significant) then the R session's timezone is already UTC and tz="" will result in unmarked datetimes being read as UTC POSIXct. For more information, please see the news items from v1.13.0 and v1.14.0.

Value

a dataframe as created by data.table::fread()

ESPN Basketball Endpoint Overview (NBA + MBB)

Description

Wrappers around ESPN's basketball endpoints. Two parallel families share a common set of internal helpers in R/espn_basketball_*.R:

  • ⁠espn_nba_*()⁠ — ESPN NBA wrappers

  • ⁠espn_mbb_*()⁠ — ESPN men's college basketball wrappers

Each public wrapper is a thin shim over an internal helper that takes a league argument ("nba" or "mens-college-basketball"); the helper does the actual HTTP call + parsing.

Details

Play-by-play, scoreboard, schedule

NBA function MBB function
espn_nba_pbp() espn_mbb_pbp()
espn_nba_scoreboard() espn_mbb_scoreboard()
espn_nba_game_all() espn_mbb_game_all()
espn_nba_game_rosters() espn_mbb_game_rosters()
espn_nba_player_box() espn_mbb_player_box()
espn_nba_team_box() espn_mbb_team_box()
espn_nba_wp() espn_mbb_wp()

Reference data

NBA function MBB function
espn_nba_teams() espn_mbb_teams()
espn_nba_standings() espn_mbb_standings()
espn_nba_player_stats() espn_mbb_player_stats()
espn_nba_team_stats() espn_mbb_team_stats()
espn_nba_betting() espn_mbb_betting()
espn_mbb_conferences()
espn_mbb_rankings()

HTTP layer

ESPN wrappers call .retry_request() directly without ..., so per-call proxy overrides aren't supported. Use options(hoopR.proxy = ...) or the http_proxy / https_proxy env vars for proxy routing.

Get ESPN Women's College Basketball Athletes Index

Description

Get ESPN Women's College Basketball Athletes Index

Get ESPN Women's College Basketball Athletes Index

Usage

espn_mbb_athletes_index(
  season = most_recent_mbb_season(),
  active = TRUE,
  limit = 25000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MBB season.
active

logical. When TRUE (default) only active athletes are returned. Set to FALSE for the full historical roster.
limit

integer. Maximum number of rows to return. Default 25000. MBB can return 6,000-12,000 athletes per season; increase if needed. Pass a small value (e.g. limit = 50) in tests to keep execution fast.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per athlete.

col_name types description
athlete_id character Unique athlete identifier (ESPN).
full_name character Player's full name.
jersey character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
team_id character Unique team identifier.
headshot character Headshot image URL.
status character Status label.
link character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_athletes_index(season = 2025, limit = 50)

Get ESPN MBB Season Award Detail

Description

Returns the name, description, and winners of one MBB season award.

Usage

espn_mbb_award(award_id, season = most_recent_mbb_season(), ...)

Arguments

award_id

ESPN award identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A tibble with one row per winner.

col_name types description
league character League slug.
season integer Season year.
award_id character ESPN award identifier.
name character Award name.
description character Award description.
athlete_id character ESPN athlete id of winner.
team_id character ESPN team id.
athlete_ref character ⁠$ref⁠ to winner's per-season athlete resource.
team_ref character ⁠$ref⁠ to winner's per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_award(award_id = 344, season = 2024)

Get ESPN MBB's Betting information

Description

Get ESPN MBB's Betting information

Usage

espn_mbb_betting(game_id)

Arguments

game_id

Game ID

Value

Returns a named list of data frames: pickcenter, againstTheSpread, predictor

pickcenter

col_name types description
details character Details.
over_under numeric Over under.
spread numeric Spread.
provider_id integer Unique identifier for provider.
provider_name character Provider name.
provider_priority integer Provider priority.
away_team_odds_favorite logical Away team's team odds favorite.
away_team_odds_underdog logical Away team's team odds underdog.
away_team_odds_money_line integer Away team's team odds money line.
away_team_odds_spread_odds numeric Away team's team odds spread odds.
away_team_odds_team_id integer Unique identifier for away team odds team.
away_team_odds_win_percentage numeric Away team odds win percentage (0-1 decimal).
away_team_odds_average_score numeric Away team's team odds average score.
away_team_odds_money_line_odds numeric Away team's team odds money line odds.
away_team_odds_spread_return numeric Away team's team odds spread return.
away_team_odds_spread_record_wins integer Away team's team odds spread record wins.
away_team_odds_spread_record_losses integer Away team's team odds spread record losses.
away_team_odds_spread_record_pushes integer Away team's team odds spread record pushes.
away_team_odds_spread_record_summary character Away team's team odds spread record summary.
home_team_odds_favorite logical Home team's team odds favorite.
home_team_odds_underdog logical Home team's team odds underdog.
home_team_odds_money_line integer Home team's team odds money line.
home_team_odds_spread_odds numeric Home team's team odds spread odds.
home_team_odds_team_id integer Unique identifier for home team odds team.
home_team_odds_win_percentage numeric Home team odds win percentage (0-1 decimal).
home_team_odds_average_score numeric Home team's team odds average score.
home_team_odds_money_line_odds numeric Home team's team odds money line odds.
home_team_odds_spread_return numeric Home team's team odds spread return.
home_team_odds_spread_record_wins integer Home team's team odds spread record wins.
home_team_odds_spread_record_losses integer Home team's team odds spread record losses.
home_team_odds_spread_record_pushes integer Home team's team odds spread record pushes.
home_team_odds_spread_record_summary character Home team's team odds spread record summary.
game_id integer Unique game identifier.

againstTheSpread

col_name types description
id integer Id.
uid character ESPN UID string (universal identifier).
display_name character Display name.
abbreviation character Short abbreviation.
logo character Team or league logo URL.
logos list Logos.
records list Records.
game_id integer Unique game identifier.
team_id integer Unique team identifier.

predictor

col_name types description
game_id integer Unique game identifier.
home_team_id integer Unique identifier for the home team.
away_team_id integer Unique identifier for the away team.
away_team_game_projection numeric Away team's team game projection.
away_team_chance_loss numeric Away team's team chance loss.

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_betting(game_id = 401256760))

Get ESPN MBB Calendar

Description

Get ESPN MBB Calendar

Get ESPN Women's College Basketball Calendar

Usage

espn_mbb_calendar(season = most_recent_mbb_season())

Arguments

season

integer or character. Four-digit season year (e.g. 2025). Defaults to most_recent_mbb_season().

Details

Retrieve the ESPN women's college basketball schedule calendar for a given season. The underlying scoreboard response contains a leagues[[1]]$calendar block with season-type entries (pre-season, regular, post). Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of calendar entries.

col_name types description
season character Season identifier (4-digit year or 'YYYY-YY' string).
season_type character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_type_label character
season_start_date character Date in YYYY-MM-DD format.
season_end_date character Date in YYYY-MM-DD format.
label character
alternate_label character
detail character
value character Numeric or string value field.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_calendar(season = 2025)

Get ESPN MBB Single-Coach Detail

Description

Returns biography, current team / college refs, and counts of career record entries + per-season coaching entries for one MBB head coach.

Usage

espn_mbb_coach(coach_id, ...)

Arguments

coach_id

ESPN coach identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble. See espn_nba_coach() for column schema.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_coach(coach_id = 32116)

Get ESPN MBB Coach Career Record (Long Format)

Description

Returns a coach's career record by type in long format (one row per stat in the record's stats[] array). record_type codes commonly populated: 0 = Total, 1 = Pre Season, 2 = Regular Season, 3 = Post Season. Use espn_mbb_coaches() to discover coach_ids for a season.

Usage

espn_mbb_coach_record(coach_id, record_type = 0L, ...)

Arguments

coach_id

ESPN coach identifier (use espn_mbb_coaches() to find).
record_type

Integer record type: 0 = Total (default), 1 = Pre Season, 2 = Regular Season, 3 = Post Season.
...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_coach_record(coach_id = 32116, record_type = 2)

Get ESPN MBB Coach-in-Season Detail

Description

Per-season coach detail (name, birth info, ⁠$ref⁠s to team/college/ person). ESPN's coverage of this endpoint is sparse; many (coach × season) combinations return 404.

Usage

espn_mbb_coach_season(coach_id, season = most_recent_mbb_season(), ...)

Arguments

coach_id

ESPN coach identifier.
season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Coach-in-Season Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
coach_id character ESPN coach id.
uid character ESPN UID string.
first_name character First name.
last_name character Last name.
date_of_birth character Date of birth.
birth_city character Birth city.
birth_state character Birth state / region.
n_records integer Count of records entries.
person_ref character ⁠$ref⁠ to person resource.
college_ref character ⁠$ref⁠ to college.
team_ref character ⁠$ref⁠ to team-in-season.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_coach_season(coach_id = 32116, season = 2025)

Get ESPN Women's College Basketball Coaches

Description

Get ESPN Women's College Basketball Coaches

Get ESPN Women's College Basketball Coaches

Usage

espn_mbb_coaches(season = most_recent_mbb_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MBB season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per coach.

col_name types description
coach_id character
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
experience integer Years of professional experience.
team_id character Unique team identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_coaches(season = 2025)

Get ESPN conference names and IDs

Description

Get ESPN conference names and IDs

Usage

espn_mbb_conferences()

Value

A conferences data frame

col_name types description
group_id integer Group identifier (e.g. conference group_id).
conference_short_name character Conference short name (e.g. 'ACC').
conference_uid character ESPN universal conference identifier.
conference_name character Full conference name.
conference_logo character Logo image URL for conference.
parent_group_id integer Unique identifier for parent group.
conference_id integer Conference identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_conferences())

Get ESPN MBB Franchise Detail

Description

Returns franchise-level metadata for a men's college basketball program. Franchise IDs are stable across program reorganization or rebrands.

Usage

espn_mbb_franchise(franchise_id, ...)

Arguments

franchise_id

ESPN franchise identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
id character ESPN franchise identifier.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Franchise location.
name character Franchise name.
nickname character Common nickname.
abbreviation character Short abbreviation.
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
is_active logical Whether franchise is currently active.
league character League slug.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
venue_ref character ⁠$ref⁠ to franchise's primary venue.
team_ref character ⁠$ref⁠ to the current team for franchise.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_franchise(franchise_id = 150)

Get ESPN MBB Franchises Index

Description

Returns the full MBB franchises index from sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/franchises. Each row is one franchise with its ID and the canonical ⁠$ref⁠ URL — pass an ID to espn_mbb_franchise() for full franchise detail.

Usage

espn_mbb_franchises(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per franchise.

col_name types description
franchise_id character ESPN franchise identifier.
ref character Full ⁠$ref⁠ URL for franchise detail.
league character League slug ("mens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_franchises()

Get ESPN MBB Season Futures (Long Format)

Description

Returns the full futures-betting board for a men's college basketball season, in long format: one row per (market x team). Markets typically cover the NCAA tournament champion and conference winners. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/seasons/{season}/futures.

Usage

espn_mbb_futures(season = most_recent_mbb_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A long-format tibble.

col_name types description
season integer Season year.
league character League slug.
market_id character ESPN futures-market identifier.
market_name character Internal market name.
market_type character Market type code.
market_display character Human-readable market name.
provider_id character Sportsbook provider identifier.
provider_name character Sportsbook provider name.
team_id character ESPN team id.
odds_value character American odds for the team.
team_ref character ⁠$ref⁠ to the per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_futures(season = 2025)

Get ESPN men's college basketball data (Pbp, Team and Player Box)

Description

Get ESPN men's college basketball data (Pbp, Team and Player Box)

Usage

espn_mbb_game_all(game_id)

Arguments

game_id

Game ID

Value

A named list of data frames: Plays, Team, Player

Plays

col_name types description
id character Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
type_id integer Type identifier (numeric).
type_text character Display text for the type field.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
team_id integer Unique team identifier.
coordinate_x_raw numeric X coordinate as returned by the API before any adjustment.
coordinate_y_raw numeric Y coordinate as returned by the API before any adjustment.
coordinate_x numeric X coordinate on the court (half-court layout).
coordinate_y numeric Y coordinate on the court (half-court layout).
play_id character Unique play identifier within a game.
athlete_id_1 integer Primary athlete identifier (e.g. shooter).
athlete_id_2 integer Secondary athlete identifier (e.g. assister / fouler).
home_team_id integer Unique identifier for the home team.
home_team_mascot character Home team mascot.
home_team_name character Home team name.
home_team_abbrev character Home team three-letter abbreviation.
home_team_logo character Home team logo URL.
home_team_logo_dark character Home team logo URL for dark backgrounds.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_team_alternate_color character Home team alternate color (hex).
home_team_score integer Home team's score.
home_team_winner logical TRUE if the home team won this game.
home_team_record character Home team's win-loss record.
away_team_id integer Unique identifier for the away team.
away_team_mascot character Away team mascot.
away_team_name character Away team name.
away_team_abbrev character Away team three-letter abbreviation.
away_team_logo character Away team logo URL.
away_team_logo_dark character Away team logo URL for dark backgrounds.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_team_alternate_color character Away team alternate color (hex).
away_team_score integer Away team's score.
away_team_winner logical TRUE if the away team won this game.
away_team_record character Away team's win-loss record.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).

Team

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
team_home_away character Team home away.
team_score integer Team's score / final score.
team_winner logical TRUE if the team won this game.
assists integer Total assists.
blocks integer Total blocks.
defensive_rebounds integer Defensive rebounds.
field_goal_pct numeric Field goal percentage (0-1).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
flagrant_fouls integer Total flagrant fouls.
fouls integer Personal fouls.
free_throw_pct numeric Free throw percentage (0-1).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
largest_lead character Largest lead during the game.
offensive_rebounds integer Offensive rebounds.
steals integer Total steals.
team_turnovers integer Team turnovers (turnovers credited to the team rather than a player).
technical_fouls integer Total technical fouls.
three_point_field_goal_pct numeric Three-point field goal percentage (0-1).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
total_rebounds integer Total rebounds.
total_technical_fouls integer Total technical fouls (player + team).
total_turnovers integer Total turnovers (player + team).
turnovers integer Total turnovers.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_uid character Opponent team uid.
opponent_team_slug character Opponent team slug.
opponent_team_location character Opponent team city / location.
opponent_team_name character Opponent team display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_display_name character Opponent team full display name.
opponent_team_short_display_name character Opponent team short display name.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_logo character Opponent team logo URL.
opponent_team_score integer Opponent team's score.

Player

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_game_all(game_id = 401479672))

Get ESPN Women's College Basketball Event Broadcasts

Description

Get ESPN Women's College Basketball Event Broadcasts

Get ESPN Women's College Basketball Event Broadcasts

Usage

espn_mbb_game_broadcasts(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per broadcast outlet for the game.

col_name types description
event_id character Unique event / game identifier (ESPN).
broadcast_id character
type_id character Type identifier (numeric).
type_short_name character
type_long_name character
market_id character
market_type character
names character
lang character
region character Region label.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_broadcasts(event_id = "401256760")

Get ESPN Women's College Basketball Event Odds

Description

Get ESPN Women's College Basketball Event Odds

Get ESPN Women's College Basketball Event Odds

Usage

espn_mbb_game_odds(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A tibble with one row per odds provider (typically empty for MBB because ESPN does not carry NCAA basketball betting lines).

col_name types description
event_id character Unique event / game identifier (ESPN).
provider_id character Unique identifier for provider.
provider_name character Provider name.
details character Details.
over_under numeric Over under.
spread numeric Spread.
home_money_line integer
away_money_line integer
home_team_odds_open numeric
home_team_odds_close numeric
away_team_odds_open numeric
away_team_odds_close numeric

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_odds(event_id = "401256760")

Get ESPN MBB Event Official Detail (Single Official)

Description

Returns a single-row tibble for one referee assigned to one MBB event, with their name, position (Referee / Crew Chief / Umpire), and crew order. Pair with espn_mbb_game_officials() to enumerate the crew.

Usage

espn_mbb_game_official_detail(event_id, order, ...)

Arguments

event_id

ESPN event identifier.
order

Crew order index (1 = first official). Pair with the order column from event_officials().
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_official_detail(event_id = 401256760, order = 1)

Get ESPN Women's College Basketball Event Officials

Description

Get ESPN Women's College Basketball Event Officials

Get ESPN Women's College Basketball Event Officials

Usage

espn_mbb_game_officials(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per official assigned to the game.

col_name types description
event_id character Unique event / game identifier (ESPN).
official_id character Unique official / referee identifier.
full_name character Player's full name.
display_name character Display name.
position_id character Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_type character
order integer Display order within the result set.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_officials(event_id = "401256760")

Get ESPN MBB Event Play Detail (Single Play)

Description

Returns the rich detail block for a single MBB play: sequence, period, clock, text, scoring/shooting flags, current home/away score, team ⁠$ref⁠, and shot coordinates if applicable. Complements the bulk espn_mbb_pbp() output by exposing the canonical core-v2 play record.

Usage

espn_mbb_game_play(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.
play_id

ESPN play identifier (visible in pbp() output as play_id or extractable from ⁠plays[].$ref⁠).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_play(event_id = 401256760, play_id = 401256760101805901)

Get ESPN MBB Event Play Personnel (On-Court Lineup at Play)

Description

Returns the players on court at a specific MBB play in long format (one row per athlete entry across both competitors). Foundation for lineup analysis. ESPN coverage is sparse — many plays return zero rows; the wrapper returns a typed empty tibble in that case.

Usage

espn_mbb_game_play_personnel(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.
play_id

ESPN play identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per on-court athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_play_personnel(event_id = 401256760, play_id = 401256760101805901)

Get ESPN MBB Event Player Box Score (Long Format)

Description

Returns the long-format per-game box score for a single athlete in one MBB event. One row per (category x stat). Same shape as espn_mbb_game_team_statistics() but scoped to a single athlete-in-event instead of the full team. stat_type defaults to 0 (regular-season aggregate as ESPN tags it for finished events).

Usage

espn_mbb_game_player_box(event_id, team_id, athlete_id, stat_type = 0L, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier (the competitor the athlete played for).
athlete_id

ESPN athlete identifier.
stat_type

Integer stat-type segment. Defaults to 0 (the only type commonly populated for finished events).
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_player_box(event_id = 401256760, team_id = 52,
                               athlete_id = 4593919)

Get ESPN MBB Event Power Index Index

Description

Returns the per-team power-index ⁠$ref⁠ URLs for one MBB event. Coverage is sparse — many events return zero items.

Usage

espn_mbb_game_powerindex(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Event Power Index Index

Value

A tibble with one row per team-game power-index entry.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_powerindex(event_id = 401256760)

Get ESPN MBB Event Predictor (Pre-game)

Description

Returns pre-game predictor statistics for one MBB event in long format: one row per (team × statistic). Typical stats include matchup quality, predicted score, win probability, and team strength metrics. Returns empty for events without predictor data (often the case for already-played games).

Usage

espn_mbb_game_predictor(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Event Predictor (Pre-game)

Value

A long tibble with rows for both home and away teams.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_predictor(event_id = 401256760)

Get ESPN Women's College Basketball Event Win Probabilities

Description

Get ESPN Women's College Basketball Event Win Probabilities

Get ESPN Women's College Basketball Event Win Probabilities

Usage

espn_mbb_game_probabilities(event_id, limit = 200, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
limit

integer. Maximum number of probability rows to return. Defaults to 200. Pagination is handled internally.
...

Additional arguments; currently unused.

Value

A tibble with one row per play-level win-probability entry.

col_name types description
event_id character Unique event / game identifier (ESPN).
sequence_number character Sequence number representing a shot-possession (V3 PBP).
play_id character Unique play identifier within a game.
period integer Period of the game (1-4 quarters; 5+ for OT).
clock character Game clock value.
home_win_percentage numeric Home win percentage (0-1 decimal).
away_win_percentage numeric Away win percentage (0-1 decimal).
tie_percentage numeric Tie percentage (0-1 decimal).
secs_to_end_of_period numeric
secs_to_end_of_game numeric

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_probabilities(event_id = "401256760", limit = 50)

Get ESPN MBB Event Prop Bets (Long Format)

Description

Returns prop-bet markets for one MBB event + provider in long format: one row per (athlete × prop type). Each row has american / decimal / fraction odds plus the current target (e.g. over/under line). Hits the core-v2 competitions/{id}/odds/{provider_id}/propBets endpoint and auto-paginates.

Usage

espn_mbb_game_propbets(event_id, provider_id, ...)

Arguments

event_id

ESPN event identifier.
provider_id

Sportsbook provider id (e.g. 58 = ESPN BET, 100 = Caesars). Look up via espn_mbb_game_odds().
...

Additional arguments; currently unused.

Details

Get ESPN MBB Event Prop Bets (Long Format)

Value

A long tibble with one row per (athlete × prop type).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_propbets(event_id = 401256760, provider_id = 58)

Get ESPN men's college basketball game rosters

Description

Get ESPN men's college basketball game rosters

Usage

espn_mbb_game_rosters(game_id)

Arguments

game_id

Game ID

Value

A game rosters data frame

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
athlete_display_name character Athlete display name (full).
short_name character Short display name.
weight integer Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height integer Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
hand_type character Hand type.
hand_abbreviation character Hand abbreviation.
hand_display_value character Hand display value.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
experience_years integer Experience years.
experience_display_value character Experience display value.
experience_abbreviation character Experience abbreviation.
active logical TRUE if the row represents an active record (player / team / season).
draft_display_text character Draft display text.
draft_round integer Round of the draft selection.
draft_year integer Draft year (4-digit).
draft_selection integer Draft selection.
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
valid logical Valid.
did_not_play logical TRUE if the player did not appear in the game.
display_name character Display name.
ejected logical TRUE if the player was ejected from the game.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
is_active logical Is active.
is_all_star logical Is all star.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
game_id integer Unique game identifier.
order integer Display order within the result set.
home_away character Game venue label ('home' or 'away').
winner logical Winner.
roster_href character URL for roster.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_game_rosters(game_id = 401256760))

Get ESPN MBB Event Situation (Live)

Description

Returns the live game situation for one MBB event: timeouts remaining, team fouls, fouls to give, bonus state, and a ⁠$ref⁠ to the last play. During a live game this reflects current state; after the game ends the values are frozen.

Usage

espn_mbb_game_situation(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble with timeouts + fouls for both teams.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_situation(event_id = 401256760)

Get ESPN MBB Event Competitor Leaders (Top Performers)

Description

Returns the per-team statistical leaders for one MBB event in long format: one row per (category x athlete rank). Categories typically include points, rebounds, assists, and rating.

Usage

espn_mbb_game_team_leaders(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x rank).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_leaders(event_id = 401256760, team_id = 52)

Get ESPN MBB Event Competitor Linescores (Per-Quarter)

Description

Returns the per-quarter scoring breakdown for one team in one NBA event. One row per period (regulation quarters + any overtime periods).

Usage

espn_mbb_game_team_linescores(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier (the competitor whose linescore to fetch).
...

Additional arguments; currently unused.

Value

A tibble with one row per period.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_linescores(event_id = 401256760, team_id = 52)

Get ESPN MBB Event Competitor Records (At-Game Breakdown)

Description

Returns team records as of the given MBB event: overall, home, away, conference, and division breakdowns where available. One row per record type.

Usage

espn_mbb_game_team_records(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per record type.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_records(event_id = 401256760, team_id = 52)

Get ESPN MBB Event Competitor Roster (Game-Day)

Description

Returns the game-day roster index for one team in one MBB event. Each row carries the athlete id and the core-v2 ⁠$ref⁠ URL — use the ref to dereference athlete-game splits or biographical data.

Usage

espn_mbb_game_team_roster(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per active athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_roster(event_id = 401256760, team_id = 52)

Get ESPN MBB Event Competitor Roster Entry (Per-Athlete Game-Day Row)

Description

Returns a single-row tibble describing one athlete's game-day roster entry for one MBB event. Carries the starter flag, didNotPlay flag with reason, ejection flag, and the substitution slot if the athlete came in for another player. Pair with espn_mbb_game_team_roster() to enumerate the roster.

Usage

espn_mbb_game_team_roster_entry(event_id, team_id, athlete_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
athlete_id

ESPN athlete identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_roster_entry(event_id = 401256760,
                                            team_id = 150,
                                            athlete_id = 4593919)

Get ESPN MBB Event Competitor Score (Single Row)

Description

Returns a one-row tibble with one team's final score for one MBB event: numeric value, display string, winner flag, and source metadata. Quick-lookup wrapper — use espn_mbb_game_team_linescores() for per-period detail.

Usage

espn_mbb_game_team_score(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_score(event_id = 401256760, team_id = 52)

Get ESPN MBB Event Competitor Team Statistics (Long Format)

Description

Returns full team-game statistics for one team in one MBB event in long format: one row per (category x stat). Covers offensive, defensive, and general categories with both raw values and display strings.

Usage

espn_mbb_game_team_statistics(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_game_team_statistics(event_id = 401256760, team_id = 52)

Get ESPN Women's College Basketball Injuries

Description

Get ESPN Women's College Basketball Injuries

Get ESPN Women's College Basketball Injuries

Usage

espn_mbb_injuries(season = most_recent_mbb_season(), ...)

Arguments

season

Numeric or character season year (e.g. 2025). The ESPN injury endpoint does not filter by season server-side; the value is attached as a constant column on the returned tibble for downstream joins. Defaults to most_recent_mbb_season().
...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of league-wide MBB injury records. ESPN's MBB injury data is typically sparse; the function returns an empty tibble (zero rows) when no injuries are reported.

Injuries

col_name types description
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
status character Status label.
date character Date in YYYY-MM-DD format.
type character Record type / category.
side character Side label (e.g. 'home', 'away', or 'overUnder').
returns_at character
short_comment character
long_comment character Long-form play / event comment.
season integer Season identifier (4-digit year or 'YYYY-YY' string).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_injuries()

Get ESPN Women's College Basketball League Leaders

Description

Get ESPN Women's College Basketball League Leaders

Get ESPN Women's College Basketball League Leaders

Usage

espn_mbb_leaders(season = most_recent_mbb_season(), season_type = 2, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MBB season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per category-athlete pair.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
category character Category label.
abbreviation character Short abbreviation.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
team_id character Unique team identifier.
team_abbrev character
value numeric Numeric or string value field.
rank integer Rank.
display_value character Human-readable display value.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_leaders(season = 2025, season_type = 2)

Get ESPN MBB News

Description

Get ESPN MBB News

Get ESPN Women's College Basketball News

Usage

espn_mbb_news(limit = 50)

Arguments

limit

integer. Maximum number of articles to return. Default 50.

Details

Retrieve ESPN women's college basketball news. Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of news articles.

col_name types description
id character Id.
type character Record type / category.
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).
premium logical
byline character News article byline / author.
link_web character Web link / URL.
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_news(limit = 5)

Get ESPN men's college basketball PBP data

Description

Get ESPN men's college basketball PBP data

Usage

espn_mbb_pbp(game_id)

Arguments

game_id

Game ID

Value

A play-by-play data frame.

Plays

col_name types description
id character Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
type_id integer Type identifier (numeric).
type_text character Display text for the type field.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
team_id integer Unique team identifier.
coordinate_x_raw numeric X coordinate as returned by the API before any adjustment.
coordinate_y_raw numeric Y coordinate as returned by the API before any adjustment.
coordinate_x numeric X coordinate on the court (half-court layout).
coordinate_y numeric Y coordinate on the court (half-court layout).
play_id character Unique play identifier within a game.
athlete_id_1 integer Primary athlete identifier (e.g. shooter).
athlete_id_2 integer Secondary athlete identifier (e.g. assister / fouler).
home_team_id integer Unique identifier for the home team.
home_team_mascot character Home team mascot.
home_team_name character Home team name.
home_team_abbrev character Home team three-letter abbreviation.
home_team_logo character Home team logo URL.
home_team_logo_dark character Home team logo URL for dark backgrounds.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_team_alternate_color character Home team alternate color (hex).
home_team_score integer Home team's score.
home_team_winner logical TRUE if the home team won this game.
home_team_record character Home team's win-loss record.
away_team_id integer Unique identifier for the away team.
away_team_mascot character Away team mascot.
away_team_name character Away team name.
away_team_abbrev character Away team three-letter abbreviation.
away_team_logo character Away team logo URL.
away_team_logo_dark character Away team logo URL for dark backgrounds.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_team_alternate_color character Away team alternate color (hex).
away_team_score integer Away team's score.
away_team_winner logical TRUE if the away team won this game.
away_team_record character Away team's win-loss record.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_pbp(game_id = 401479672))

Get ESPN Women's College Basketball Athlete Awards

Description

Get ESPN Women's College Basketball Athlete Awards

Get ESPN Women's College Basketball Athlete Awards

Usage

espn_mbb_player_awards(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single tibble. This endpoint is sparse; many athletes have no award data, in which case an empty tibble with canonical columns is returned.

col_name types description
season character Season identifier (4-digit year or 'YYYY-YY' string).
award_id character
name character Display name.
description character Long-form description text.
date character Date in YYYY-MM-DD format.
type character Record type / category.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_awards(athlete_id = "4593919")

Get ESPN men's college basketball player box scores

Description

Get ESPN men's college basketball player box scores

Usage

espn_mbb_player_box(game_id)

Arguments

game_id

Game ID

Value

A player boxscore data frame

Player

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_player_box(game_id = 401479672))

Get ESPN MBB Athlete Career Stats (Long Format)

Description

Returns career stats for an MBB athlete in long format. Default stat_type = 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to attempt multiple types and bind them via a stat_type_id column; variants that 404 for that athlete are silently skipped. Stat types: 0 = regular season (default endpoint), 1 = postseason, 2 = career aggregate. Coverage of types 1 and 2 is sparse — many athletes only have type 0 populated.

Usage

espn_mbb_player_career_stats(athlete_id, stat_type = 0L, ...)

Arguments

athlete_id

ESPN athlete identifier.
stat_type

Integer or integer vector of stat-type codes. Default 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to bind multiple types via a stat_type_id column; non-existent variants are silently skipped.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Athlete Career Stats (Long Format)

Value

A long tibble (one row per stat_type × split × category × stat).

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
stat_type_id character Stat-type code (0 = reg, 1 = post, 2 = career).
split_id character Split id.
split_name character Split name (typically "All Splits").
split_type character Split type code.
category_name character Category key (e.g. "defensive").
category_display character Category display name.
category_short character Category short display.
category_abbrev character Category abbreviation.
stat_name character Stat key.
stat_abbrev character Stat abbreviation.
stat_display character Stat display name.
stat_short character Stat short display.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

# LeBron James — regular + postseason combined
  espn_mbb_player_career_stats(athlete_id = 4593919)
  # Just career aggregate
  espn_mbb_player_career_stats(athlete_id = 4593919, stat_type = 2L)

Get ESPN Women's College Basketball Athlete Eventlog

Description

Get ESPN Women's College Basketball Athlete Eventlog

Get ESPN Women's College Basketball Athlete Eventlog

Usage

espn_mbb_player_eventlog(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single tibble. Per-event statistics.$ref URLs from the ESPN core-v2 API are returned as the character column statistics_ref and are NOT resolved. Similarly, event_ref, competition_ref, and team_ref are returned as character columns.

col_name types description
event_ref character Reference link to the originating event.
competition_ref character
team_ref character
statistics_ref character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_eventlog(athlete_id = "4593919", season = 2025)

Get ESPN MBB Athlete Per-Season Event Log (core-v2)

Description

Returns one row per (event x team) for an MBB athlete's appearances in a given season. Distinct from espn_mbb_player_eventlog() which wraps the web-common-v3 endpoint; this core-v2 variant is era-correct.

Usage

espn_mbb_player_eventlog_v2(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier.
season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Value

A tibble with one row per event appearance.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_eventlog_v2(athlete_id = 4683735, season = 2025)

Get ESPN Women's College Basketball Athlete Gamelog

Description

Get ESPN Women's College Basketball Athlete Gamelog

Get ESPN Women's College Basketball Athlete Gamelog

Usage

espn_mbb_player_gamelog(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single tibble with one row per game. Column names reflect the stat labels returned by ESPN and will vary by season and player.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_gamelog(athlete_id = "4593919", season = 2025)

Get ESPN Women's College Basketball Athlete Info

Description

Get ESPN Women's College Basketball Athlete Info

Get ESPN Women's College Basketball Athlete Info

Usage

espn_mbb_player_info(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of data frames: Bio, Team, Position, Status, College, Draft.

Bio

col_name types description
id character Id.
full_name character Player's full name.
display_name character Display name.
jersey character Jersey number worn by the player.
age character Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
headshot_href character Headshot image URL.

Team

col_name types description
id character Id.
abbreviation character Short abbreviation.
display_name character Display name.

Position

col_name types description
id character Id.
name character Display name.
abbreviation character Short abbreviation.

Status

col_name types description
id character Id.
name character Display name.
type character Record type / category.

College

col_name types description
id character Id.
name character Display name.
mascot character Team mascot.

Draft

col_name types description
year character 4-digit year.
round character Tournament / playoff round.
selection character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_info(athlete_id = "4593919")

Get ESPN Women's College Basketball Athlete Overview

Description

Get ESPN Women's College Basketball Athlete Overview

Get ESPN Women's College Basketball Athlete Overview

Usage

espn_mbb_player_overview(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A named list of data frames: Statistics, NextGame, Last5Games, Headlines, FantasyOutlook.

Statistics

col_name types description
(varies) character

NextGame

col_name types description
id character Id.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.

Last5Games

col_name types description
(varies) character

Headlines

col_name types description
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).

FantasyOutlook

col_name types description
(varies) character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_overview(athlete_id = "4593919", season = 2025)

Get ESPN MBB Athlete Career Seasons

Description

Returns the list of seasons an MBB athlete appeared in. Useful for bounding follow-up calls to per-season endpoints.

Usage

espn_mbb_player_seasons(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per career season.

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
season integer Season year.
ref character ⁠$ref⁠ URL to the season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

# LeBron James (1966): 23 career seasons
  espn_mbb_player_seasons(athlete_id = 4593919)

Get ESPN Women's College Basketball Athlete Splits

Description

Get ESPN Women's College Basketball Athlete Splits

Get ESPN Women's College Basketball Athlete Splits

Usage

espn_mbb_player_splits(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single long-format tibble. When data are present, columns include at minimum category and split_name, plus per-stat columns driven by ESPN labels.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_splits(athlete_id = "4593919", season = 2025)

Get ESPN Women's College Basketball Athlete Statisticslog

Description

Get ESPN Women's College Basketball Athlete Statisticslog

Get ESPN Women's College Basketball Athlete Statisticslog

Usage

espn_mbb_player_statisticslog(
  athlete_id,
  season = most_recent_mbb_season(),
  ...
)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single tibble. When resolved, each row corresponds to one statistical entry in the core-v2 statistics log, with event_ref and statistics_ref character columns pointing to resolvable ESPN endpoints.

col_name types description
event_ref character Reference link to the originating event.
statistics_ref character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_statisticslog(athlete_id = "4593919", season = 2025)

Get ESPN men's college basketball player stats data

Description

Get ESPN men's college basketball player stats data

Usage

espn_mbb_player_stats(athlete_id, year, season_type = "regular", total = FALSE)

Arguments

athlete_id

Athlete ID
year

Year
season_type

(character, default: regular): Season type - regular or postseason
total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the player stats data

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
display_name character Display name.
short_name character Short display name.
weight numeric Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height numeric Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
experience_years integer Experience years.
experience_display_value character Experience display value.
experience_abbreviation character Experience abbreviation.
active logical TRUE if the row represents an active record (player / team / season).
draft_display_text character Draft display text.
draft_round integer Round of the draft selection.
draft_year integer Draft year (4-digit).
draft_selection integer Draft selection.
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_points numeric The amount of points resulting from the possession following a turnover.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_per numeric A numerical value for each of a player's accomplishments per-minute and is pace-adjusted for the team they play on. The league average in PER to 15.00 every season.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_fast_break_points numeric The number of points scored on fast breaks.
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr integer ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
is_active logical Is active.
is_all_star logical Is all star.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_player_stats(athlete_id = 4593919, year = 2021))

Get ESPN Women's College Basketball Athlete Stats

Description

Get ESPN Women's College Basketball Athlete Stats

Get ESPN Women's College Basketball Athlete Stats

Usage

espn_mbb_player_stats_v3(athlete_id, season = most_recent_mbb_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A named list of per-category tibbles. Default category names are General, Offensive, Defensive, Rebounding, Shooting, Misc. Actual names are driven by the ESPN response; additional categories may appear. Each tibble has columns depending on the category returned by ESPN.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_player_stats_v3(athlete_id = "4593919", season = 2025)

Get ESPN MBB Position Detail

Description

Returns metadata for a single MBB position. Useful for dereferencing position ⁠$ref⁠ URLs embedded in athlete records, and for navigating parent/leaf relationships in the position taxonomy.

Usage

espn_mbb_position(position_id, ...)

Arguments

position_id

ESPN position identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_position(position_id = 1)

Get ESPN MBB Positions Index

Description

Returns the MBB position dictionary index. One row per position with its id and the canonical ⁠$ref⁠ URL — pass an id to espn_mbb_position() for full details (display name, abbreviation, leaf flag, parent link).

Usage

espn_mbb_positions(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per position.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_positions()

Get ESPN MBB Season Power Index (Long Format)

Description

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one MBB season, in long format: one row per (team x stat). Auto-paginates through all teams.

Usage

espn_mbb_powerindex(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year (numeric). Defaults to the most recent MBB season.
season_type

Integer (1=preseason, 2=regular (default), 3=postseason).
...

Additional arguments; currently unused.

Value

A long tibble with one row per (team x stat).

col_name types description
league character League slug.
season integer Season year.
season_type integer 1=preseason, 2=regular, 3=postseason.
team_id character ESPN team id.
stat_name character Internal stat key.
abbreviation character Short stat abbreviation.
display_name character Human-readable stat name.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.
last_updated character Last-updated timestamp.
team_ref character ⁠$ref⁠ to the team-in-season resource.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_powerindex(season = 2025)

Get men's college basketball AP and Coaches Poll rankings from ESPN

Description

Get men's college basketball AP and Coaches Poll rankings from ESPN

Usage

espn_mbb_rankings()

Value

Returns a tibble

col_name types description
id integer Id.
name character Display name.
short_name character Short display name.
type character Record type / category.
headline character News headline.
short_headline character Short news headline.
current integer Current.
previous integer Previous.
points numeric Points scored.
first_place_votes integer First place votes.
trend character Trend.
date character Date in YYYY-MM-DD format.
last_updated character Last updated.
record_summary character Win-loss record summary string.
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_logo character Team logo image URL.
occurrence_number integer Occurrence number.
occurrence_type character Occurrence type.
occurrence_last logical Occurrence last.
occurrence_value character Occurrence value.
occurrence_display_value character Occurrence display value.
season_year integer Season year string ('YYYY-YY' format).
season_start_date character Date in YYYY-MM-DD format.
season_end_date character Date in YYYY-MM-DD format.
season_display_name character Season display label.
season_type_type integer Season type type.
season_type_name character Season type name.
season_type_abbreviation character Season type abbreviation.
season_futures_ref character Season futures ref.
first_occurrence_type character First occurrence type.
first_occurrence_value character First occurrence value.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

# Get current AP and Coaches Poll rankings

try(espn_mbb_rankings())

Get ESPN men's college basketball schedule for a specific year

Description

Get ESPN men's college basketball schedule for a specific year

Usage

espn_mbb_scoreboard(season)

Arguments

season

Either numeric or character

Value

Returns a tibble

col_name types description
matchup character Matchup.
matchup_short character Matchup short.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_slug character Season slug.
game_id integer Unique game identifier.
game_uid character Game uid.
game_date Date Game date (YYYY-MM-DD).
attendance integer Reported attendance.
status_name character Status label.
broadcast_market character Broadcast market label (e.g. 'national', 'home').
broadcast_name character Broadcast name.
start_date character Start date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
home_team_name character Home team name.
home_team_logo character Home team logo URL.
home_team_abb character Home team's team abb.
home_team_id integer Unique identifier for the home team.
home_team_location character Home team's team location.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_score integer Home team score at the time of the play.
home_win integer Home team's win.
home_record character Home win-loss record.
away_team_name character Away team name.
away_team_logo character Away team logo URL.
away_team_abb character Away team's team abb.
away_team_id integer Unique identifier for the away team.
away_team_location character Away team's team location.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_score integer Away team score at the time of the play.
away_win integer Away team's win.
away_record character Away win-loss record.

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

# Get schedule from date 2022-11-17

try(espn_mbb_scoreboard(season = "20221117"))

Get ESPN MBB Season Awards Index

Description

Returns the list of award IDs given out in an MBB season from sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/seasons/{season}/awards. The index only contains IDs and ⁠$ref⁠ URLs — pass an ID to espn_mbb_award() for the award name, description, and winners.

Usage

espn_mbb_season_awards(season = most_recent_mbb_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A tibble with one row per award.

col_name types description
season integer Season year.
award_id character ESPN award identifier.
ref character Full ⁠$ref⁠ URL for the award detail.
league character League slug ("mens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_awards(season = 2024)

Get ESPN MBB Season Group Detail

Description

Returns metadata for one group (conference or division) in one (MBB season x season-type), plus ⁠$ref⁠ URLs to its parent group, children groups, member teams, and standings.

Usage

espn_mbb_season_group(
  group_id,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Group Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
uid character ESPN UID string.
name character Full name (e.g. "Eastern Conference").
abbreviation character Short code (e.g. "EAST").
short_name character Short name.
midsize_name character Mid-size display name.
is_conference logical Whether this group is a conference.
slug character URL slug.
parent_ref character ⁠$ref⁠ to parent group (if any).
children_ref character ⁠$ref⁠ to child-groups endpoint.
teams_ref character ⁠$ref⁠ to teams-in-group endpoint.
standings_ref character ⁠$ref⁠ to standings endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_group(group_id = 5, season = 2025)

Get ESPN MBB Season Group Children Index

Description

Returns the list of child groups (e.g. divisions within a conference) for one (MBB season x season-type x parent-group).

Usage

espn_mbb_season_group_children(
  group_id,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

Parent group identifier.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Group Children Index

Value

A tibble with one row per child group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
parent_group_id character Parent group id (queried).
child_group_id character Child group id.
ref character ⁠$ref⁠ to child group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_group_children(group_id = 5, season = 2025)

Get ESPN MBB Season Group Teams Index

Description

Returns the list of team IDs that belong to one group (conference or division) for one (MBB season x season-type).

Usage

espn_mbb_season_group_teams(
  group_id,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Group Teams Index

Value

A tibble with one row per team in the group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
team_id character ESPN team id.
ref character ⁠$ref⁠ URL to the team-in-season entry.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_group_teams(group_id = 5, season = 2025)

Get ESPN MBB Season Groups Index

Description

Returns the list of group IDs (conferences / divisions) for one (MBB season x season-type) via core-v2 ⁠/seasons/{season}/types/{season_type}/groups⁠.

Usage

espn_mbb_season_groups(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Value

A tibble with one row per group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
ref character ⁠$ref⁠ URL for the group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_groups(season = 2025)

Get ESPN Women's College Basketball Season Info

Description

Get ESPN Women's College Basketball Season Info

Get ESPN Women's College Basketball Season Info

Usage

espn_mbb_season_info(season = most_recent_mbb_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MBB season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of hoopR_data tibbles: Info, Types, Athletes, Coaches, Teams, Awards. ⁠$ref⁠ URL components are returned as character columns and are NOT auto-resolved – use targeted endpoint functions for details.

Info

col_name types description
year integer 4-digit year.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
type_id character Type identifier (numeric).
type_name character

Types / Athletes / Coaches / Teams / Awards

col_name types description
count integer Count of count.
ref character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_info(season = 2025)

Get ESPN MBB Season Leaders (Long Format)

Description

Returns the per-category leaderboard for one (MBB season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Usage

espn_mbb_season_leaders(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default), 3 = postseason).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Leaders (Long Format)

Value

A long tibble with one row per (category x leader).

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
category_name character Internal category key (e.g. "pointsPerGame").
category_display character Human-readable category name.
category_short character Short display name.
category_abbrev character Stat abbreviation (e.g. "PTS").
rank integer Rank within the category (1 = best).
athlete_id character ESPN athlete id.
team_id character ESPN team id.
display_value character Display-formatted value.
value numeric Numeric leader value.
rel character Comma-joined rel tags from ESPN.
athlete_ref character ⁠$ref⁠ URL to the leader's athlete.
team_ref character ⁠$ref⁠ URL to the leader's team.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_leaders(season = 2025)

Get ESPN MBB Season Ranking Detail

Description

Returns the per-week snapshot index for one ranking source (e.g. AP Top 25). Each row is one weekly snapshot; the ref URL resolves to the actual ranked teams for that (season-type x week) and will be wrapped by a forthcoming espn_LOWERMBB_week_ranking().

Usage

espn_mbb_season_ranking(ranking_id, season = most_recent_mbb_season(), ...)

Arguments

ranking_id

ESPN ranking identifier (character or numeric).
season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Ranking Detail

Value

A tibble with one row per weekly snapshot.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
name character Ranking name (e.g. "AP Top 25").
short_name character Short name (e.g. "AP Poll").
type character Ranking type code (e.g. "ap").
season_type integer Season-type id of this snapshot.
week integer Week number of this snapshot.
ref character ⁠$ref⁠ URL for the per-week ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_ranking(ranking_id = 1, season = 2025)

Get ESPN MBB Season Rankings Index

Description

Returns the index of season-level rankings recorded for one MBB season. Typical sources: AP Top 25 (id 1), Coaches Poll (id 2). Pass an ranking_id to espn_mbb_season_ranking() for the ranked teams.

Usage

espn_mbb_season_rankings(season = most_recent_mbb_season(), ...)

Arguments

season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_rankings(season = 2025)

Get ESPN MBB Season-Type Detail

Description

Returns metadata for one season-type within an MBB season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Usage

espn_mbb_season_type(season_type = 2L, season = most_recent_mbb_season(), ...)

Arguments

season_type

Season-type id (1 = preseason, 2 = regular (default), 3 = postseason, 4 = off-season).
season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season-Type Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
type integer Numeric type code.
name character Display name (e.g. "Regular Season").
abbreviation character Short code (e.g. "reg").
year integer Year stamp.
start_date character ISO 8601 start date.
end_date character ISO 8601 end date.
has_groups logical Whether groups exist for this type.
has_standings logical Whether standings exist.
has_legs logical Whether playoff legs exist.
slug character URL slug.
groups_ref character ⁠$ref⁠ to the groups endpoint.
weeks_ref character ⁠$ref⁠ to the weeks endpoint.
leaders_ref character ⁠$ref⁠ to the leaders endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_type(season_type = 2, season = 2025)

Get ESPN MBB Season Types Index

Description

Returns the index of season-type IDs that exist for one MBB season (typically 1 = preseason, 2 = regular, 3 = postseason, 4 = off-season). Pass an ID to espn_mbb_season_type() for the start/end dates and whether that type carries groups, standings, or legs.

Usage

espn_mbb_season_types(season = most_recent_mbb_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A tibble with one row per season type.

col_name types description
league character League slug ("mens-college-basketball").
season integer Season year.
season_type integer Season-type id (1/2/3/4).
ref character ⁠$ref⁠ URL for the type detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_types(season = 2025)

Get ESPN MBB Season-Week Detail

Description

Returns metadata for one week (number, start / end dates, text label, and ⁠$ref⁠ to the per-week rankings endpoint).

Usage

espn_mbb_season_week(
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Season-Week Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
text character Display label (e.g. "Week 5").
start_date character ISO 8601 week start.
end_date character ISO 8601 week end.
rankings_ref character ⁠$ref⁠ to the per-week rankings endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_week(week = 5, season = 2025)

Get ESPN MBB Season Weeks Index

Description

Returns the list of week IDs for one (MBB season x season-type). MBB uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Usage

espn_mbb_season_weeks(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default), 3 = postseason).
...

Additional arguments; currently unused.

Value

A tibble with one row per week.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number (1-based).
ref character ⁠$ref⁠ URL for the week detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_season_weeks(season = 2025)

Get ESPN Women's College Basketball Seasons

Description

Get ESPN Women's College Basketball Seasons

Get ESPN Women's College Basketball Seasons

Usage

espn_mbb_seasons(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per season.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
season_type_count integer

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_seasons()

Get ESPN men's college basketball standings

Description

Get ESPN men's college basketball standings

Usage

espn_mbb_standings(year = most_recent_mbb_season())

Arguments

year

Either numeric or character (YYYY)

Value

A standings data frame

col_name types description
team_id integer Unique team identifier.
team character Team-side label or team identifier.
avgpointsagainst numeric Avgpointsagainst.
avgpointsfor numeric Avgpointsfor.
gamesbehind numeric Gamesbehind.
leaguewinpercent numeric Leaguewinpercent.
losses numeric Total losses.
playoffseed numeric Playoffseed.
pointsagainst numeric Pointsagainst.
pointsfor numeric Pointsfor.
streak numeric Current streak (e.g. 'W3' for three-game win streak).
winpercent numeric Winpercent.
wins numeric Total wins.
total character Total.
home_avgpointsagainst numeric Home team's avgpointsagainst.
home_avgpointsfor numeric Home team's avgpointsfor.
home_gamesbehind numeric Home team's gamesbehind.
home_leaguewinpercent numeric Home team's leaguewinpercent.
home_losses numeric Home team's losses.
home_playoffseed numeric Home team's playoffseed.
home_pointsagainst numeric Home team's pointsagainst.
home_pointsfor numeric Home team's pointsfor.
home_streak numeric Home team's streak.
home_winpercent numeric Home team's winpercent.
home_wins numeric Home team's wins.
home character Home.
road_avgpointsagainst numeric Road avgpointsagainst.
road_avgpointsfor numeric Road avgpointsfor.
road_gamesbehind numeric Road gamesbehind.
road_leaguewinpercent numeric Road leaguewinpercent.
road_losses numeric Road losses.
road_playoffseed numeric Road playoffseed.
road_pointsagainst numeric Road pointsagainst.
road_pointsfor numeric Road pointsfor.
road_streak numeric Road streak.
road_winpercent numeric Road winpercent.
road_wins numeric Road wins.
road character Road.
vsaprankedteams_avgpointsagainst numeric Vsaprankedteams avgpointsagainst.
vsaprankedteams_avgpointsfor numeric Vsaprankedteams avgpointsfor.
vsaprankedteams_gamesbehind numeric Vsaprankedteams gamesbehind.
vsaprankedteams_leaguewinpercent numeric Vsaprankedteams leaguewinpercent.
vsaprankedteams_losses numeric Vsaprankedteams losses.
vsaprankedteams_playoffseed numeric Vsaprankedteams playoffseed.
vsaprankedteams_pointsagainst numeric Vsaprankedteams pointsagainst.
vsaprankedteams_pointsfor numeric Vsaprankedteams pointsfor.
vsaprankedteams_streak numeric Vsaprankedteams streak.
vsaprankedteams_winpercent numeric Vsaprankedteams winpercent.
vsaprankedteams_wins numeric Vsaprankedteams wins.
vsaprankedteams character Vsaprankedteams.
vsusarankedteams_avgpointsagainst numeric Vsusarankedteams avgpointsagainst.
vsusarankedteams_avgpointsfor numeric Vsusarankedteams avgpointsfor.
vsusarankedteams_gamesbehind numeric Vsusarankedteams gamesbehind.
vsusarankedteams_leaguewinpercent numeric Vsusarankedteams leaguewinpercent.
vsusarankedteams_losses numeric Vsusarankedteams losses.
vsusarankedteams_playoffseed numeric Vsusarankedteams playoffseed.
vsusarankedteams_pointsagainst numeric Vsusarankedteams pointsagainst.
vsusarankedteams_pointsfor numeric Vsusarankedteams pointsfor.
vsusarankedteams_streak numeric Vsusarankedteams streak.
vsusarankedteams_winpercent numeric Vsusarankedteams winpercent.
vsusarankedteams_wins numeric Vsusarankedteams wins.
vsusarankedteams character Vsusarankedteams.
vsconf_avgpointsagainst numeric Vsconf avgpointsagainst.
vsconf_avgpointsfor numeric Vsconf avgpointsfor.
vsconf_gamesbehind numeric Vsconf gamesbehind.
vsconf_leaguewinpercent numeric Vsconf leaguewinpercent.
vsconf_losses numeric Vsconf losses.
vsconf_playoffseed numeric Vsconf playoffseed.
vsconf_pointsagainst numeric Vsconf pointsagainst.
vsconf_pointsfor numeric Vsconf pointsfor.
vsconf_streak numeric Vsconf streak.
vsconf_winpercent numeric Vsconf winpercent.
vsconf_wins numeric Vsconf wins.
vsconf character Vsconf.

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_standings(2021))

Get ESPN Women's College Basketball Team Detail

Description

Get ESPN Women's College Basketball Team Detail

Get ESPN Women's College Basketball Team Detail

Usage

espn_mbb_team(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric, e.g. 2025). Defaults to the most recent MBB season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of data frames: Info, Record, NextEvent, StandingSummary, Coaches.

Info

col_name types description
id character Id.
uid character ESPN UID string (universal identifier).
slug character URL-safe identifier.
abbreviation character Short abbreviation.
display_name character Display name.
short_display_name character Short display name.
name character Display name.
nickname character Team or athlete nickname.
location character Location.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.

Record

col_name types description
type character Record type / category.
summary character
stats list

NextEvent

col_name types description
id character Id.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.

StandingSummary

col_name types description
standing_summary character

Coaches

col_name types description
id character Id.
first_name character Player's first name.
last_name character Player's last name.
experience integer Years of professional experience.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team(team_id = "150", season = 2025)

Get ESPN men's college basketball team box scores

Description

Get ESPN men's college basketball team box scores

Usage

espn_mbb_team_box(game_id)

Arguments

game_id

Game ID

Value

A team boxscore data frame

Team

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
team_home_away character Team home away.
team_score integer Team's score / final score.
team_winner logical TRUE if the team won this game.
assists integer Total assists.
blocks integer Total blocks.
defensive_rebounds integer Defensive rebounds.
field_goal_pct numeric Field goal percentage (0-1).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
flagrant_fouls integer Total flagrant fouls.
fouls integer Personal fouls.
free_throw_pct numeric Free throw percentage (0-1).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
largest_lead character Largest lead during the game.
offensive_rebounds integer Offensive rebounds.
steals integer Total steals.
team_turnovers integer Team turnovers (turnovers credited to the team rather than a player).
technical_fouls integer Total technical fouls.
three_point_field_goal_pct numeric Three-point field goal percentage (0-1).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
total_rebounds integer Total rebounds.
total_technical_fouls integer Total technical fouls (player + team).
total_turnovers integer Total turnovers (player + team).
turnovers integer Total turnovers.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_uid character Opponent team uid.
opponent_team_slug character Opponent team slug.
opponent_team_location character Opponent team city / location.
opponent_team_name character Opponent team display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_display_name character Opponent team full display name.
opponent_team_short_display_name character Opponent team short display name.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_logo character Opponent team logo URL.
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_team_box(game_id = 401479672))

Get ESPN men's college basketball current team roster

Description

Get ESPN men's college basketball current team roster

Usage

espn_mbb_team_current_roster(team_id)

Arguments

team_id

Either numeric or character (YYYY)

Value

A teams data frame

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_team_current_roster(team_id = 150))

Get ESPN Women's College Basketball Team Injuries

Description

Get ESPN Women's College Basketball Team Injuries

Get ESPN Women's College Basketball Team Injuries

Usage

espn_mbb_team_injuries(team_id, ...)

Arguments

team_id

ESPN team identifier (character or numeric; passed as-is). Use espn_mbb_teams() to look up team IDs. Example: "2509" (UConn).
...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of injury records for the specified MBB team. Returns an empty tibble (zero rows) when the team has no reported injuries.

Injuries

col_name types description
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
status character Status label.
date character Date in YYYY-MM-DD format.
type character Record type / category.
side character Side label (e.g. 'home', 'away', or 'overUnder').
returns_at character
short_comment character
long_comment character Long-form play / event comment.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_injuries(team_id = "150")

Get ESPN Women's College Basketball Team Leaders

Description

Get ESPN Women's College Basketball Team Leaders

Get ESPN Women's College Basketball Team Leaders

Usage

espn_mbb_team_leaders(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single long-format tibble (one row per category-rank-athlete).

col_name types description
team_id character Unique team identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
category character Category label.
display_name character Display name.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
value numeric Numeric or string value field.
rank integer Rank.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_leaders(team_id = "150", season = 2025)

Get ESPN MBB Team News

Description

Get ESPN MBB Team News

Get ESPN Women's College Basketball Team News

Usage

espn_mbb_team_news(team_id, limit = 25)

Arguments

team_id

character or integer. ESPN team ID (e.g. 2509 for UConn).
limit

integer. Maximum number of articles to return. Default 25.

Details

Retrieve ESPN women's college basketball news for a specific team. Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of team news articles.

col_name types description
id character Id.
type character Record type / category.
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).
premium logical
byline character News article byline / author.
link_web character Web link / URL.
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_news(team_id = "150", limit = 5)

Get ESPN MBB Team Odds-Records (Long Format)

Description

Returns the long-format odds-records breakdown for a team in one season. Each row is one (category × stat) — typical categories include Money Line Overall, Money Line Home, Money Line Road, Against The Spread Overall, Over/Under, etc. ESPN's coverage of this endpoint is sparse; many (team × season-type) combinations return 404, in which case the wrapper returns an empty tibble.

Usage

espn_mbb_team_odds_records(
  team_id,
  season = most_recent_mbb_season(),
  season_type = 0L,
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id. ESPN populates odds-records mostly under season_type = 0 (all-types aggregate), so that is the default.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category × stat).

col_name types description
league character League slug.
team_id character ESPN team identifier.
season integer Season year.
season_type integer Season-type id.
category_type character Category type code (e.g. "moneyLineOverall").
category_abbrev character Category abbreviation (e.g. "ML").
category_short character Short display.
category_display character Full category name.
stat_type character Stat type code (e.g. "win", "loss").
stat_abbrev character Stat abbreviation (e.g. "W", "L").
stat_display character Stat display name.
value numeric Numeric stat value.
display_value character Display-formatted value.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_odds_records(team_id = 150, season = 2026)

Get ESPN MBB Team Record (Per Season Type)

Description

Returns the long-format record breakdown for an MBB team in one season and season-type. Each row is one record category.

Usage

espn_mbb_team_record(
  team_id,
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent MBB season.
season_type

Integer (2 = regular season default).
...

Additional arguments; currently unused.

Value

A tibble with one row per record category. See espn_nba_team_record() for the full column schema.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_record(team_id = 150, season = 2025)

Get ESPN MBB Team Record Detail (Long Format)

Description

Returns one team's record detail in long format: one row per stat in the record's stats[] array. Use espn_mbb_team_record() to enumerate available record_id values per team-season (overall / home / away / conference + per-opponent breakdowns).

Usage

espn_mbb_team_record_detail(team_id, season, record_id, season_type = 2L, ...)

Arguments

team_id

ESPN team identifier.
season

Season year (numeric).
record_id

Record identifier (from espn_mbb_team_record() index).
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_record_detail(team_id = 150, season = 2024, record_id = 0)

Get ESPN Women's College Basketball Team Roster

Description

Get ESPN Women's College Basketball Team Roster

Get ESPN Women's College Basketball Team Roster

Usage

espn_mbb_team_roster(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single tibble with one row per athlete.

col_name types description
athlete_id character Unique athlete identifier (ESPN).
full_name character Player's full name.
jersey character Jersey number worn by the player.
position_abbrev character
position_name character Listed roster position ('Guard', 'Forward', 'Center').
height character Player height (string e.g. '6-2' or inches).
weight character Player weight in pounds.
age character Player age (in years).
birth_date character Date of birth (YYYY-MM-DD).
birth_place character Place of birth.
headshot character Headshot image URL.
link_web character Web link / URL.
status character Status label.
team_id character Unique team identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_roster(team_id = "150", season = 2025)

Get ESPN Women's College Basketball Team Schedule

Description

Get ESPN Women's College Basketball Team Schedule

Get ESPN Women's College Basketball Team Schedule

Usage

espn_mbb_team_schedule(
  team_id,
  season = most_recent_mbb_season(),
  season_type = 2,
  ...
)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A single tibble with one row per event.

col_name types description
event_id character Unique event / game identifier (ESPN).
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
week integer Week number within the season.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.
opponent_id character Unique identifier for opponent.
opponent_abbrev character Abbreviation for opponent.
home_away character Game venue label ('home' or 'away').
neutral_site logical Neutral site.
conference_competition logical Conference competition.
venue_id character Unique venue identifier.
venue_name character Venue name.
venue_city character Venue city.
venue_state character Venue state / region.
broadcast character Broadcast information string.
result character Result.
team_score character Team's score / final score.
opponent_score character Opponent score.
winner logical Winner.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_schedule(team_id = "150", season = 2025)

Get ESPN MBB Team-in-Season Profile

Description

Era-correct team identity for a men's college basketball program in a specific season, plus the available ⁠$ref⁠ URLs for deeper resources (record, statistics, leaders, athletes/roster, coaches, college, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1939 at ESPN. Older seasons return fewer ⁠$ref⁠ keys; missing refs become NA.

Usage

espn_mbb_team_season_profile(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent MBB season.
...

Additional arguments; currently unused.

Value

A single-row tibble with team identity scalars and ⁠_ref⁠ URL columns. Selected columns:

col_name types description
id character ESPN team identifier.
guid character Stable cross-league team GUID.
uid character ESPN UID string.
slug character URL-safe identifier.
location character School/program location (e.g. "Duke").
name character Team name (e.g. "Blue Devils").
nickname character Common nickname (often same as location).
abbreviation character Short abbreviation (e.g. "DUKE").
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
alternate_color character Alternate color (hex, no leading '#').
is_active logical Whether the team was active in this season.
season integer Season year.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
record_ref character ⁠$ref⁠ to team record resource.
statistics_ref character ⁠$ref⁠ to team statistics resource.
athletes_ref character ⁠$ref⁠ to team roster resource (college-only).
college_ref character ⁠$ref⁠ to college (institution) resource.
coaches_ref character ⁠$ref⁠ to team coaches resource.
franchise_ref character ⁠$ref⁠ to franchise resource.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_season_profile(team_id = "150", season = 2025)

Get ESPN MBB Team Roster (Per-Season, core-v2)

Description

Returns the per-season team roster as a tibble of athlete IDs from seasons/{y}/teams/{id}/athletes. Distinct from espn_mbb_team_roster() which targets a site-v2 endpoint optimized for the current season; this core-v2 variant is era-correct and available back to ESPN's earliest season for each league.

Usage

espn_mbb_team_season_roster(team_id, season = most_recent_mbb_season(), ...)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent MBB season.
...

Additional arguments; currently unused.

Details

Get ESPN MBB Team Roster (Per-Season, core-v2)

Value

A tibble with one row per athlete on the season roster.

col_name types description
league character League slug.
team_id character ESPN team id.
season integer Season year.
athlete_id character ESPN athlete id.
ref character ⁠$ref⁠ URL to athlete-in-season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_season_roster(team_id = 150, season = 2025)

Get ESPN MBB Team Season Statistics (Long Format with Rank)

Description

Returns the full team-season-type statistics sheet for one MBB team in long format: one row per (category x stat). Each row carries the team's league rank for that stat where ESPN provides it (rank + rank_display_value). Complements espn_mbb_team_record() (W-L only) with the full stat package.

Usage

espn_mbb_team_season_statistics(
  team_id,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year (numeric). Defaults to the most recent MBB season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_team_season_statistics(team_id = 150, season = 2024)

Get ESPN men's college basketball team stats data

Description

Get ESPN men's college basketball team stats data

Usage

espn_mbb_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID
year

Year
season_type

(character, default: regular): Season type - regular or postseason
total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the team stats data

col_name types description
team_id character Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdr character ESPN team SDR identifier.
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_nickname character Team nickname.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
is_active logical Is active.
is_all_star logical Is all star.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_points numeric The amount of points resulting from the possession following a turnover.
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_team_rebounds numeric The total number of rebounds for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_team_turnovers numeric The number of turnovers for the team.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_fast_break_points numeric The number of points scored on fast breaks.
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_team_stats(team_id = 150, year = 2020))

Get ESPN men's college basketball team names and IDs

Description

Get ESPN men's college basketball team names and IDs

Usage

espn_mbb_teams(year = most_recent_mbb_season())

Arguments

year

Either numeric or character (YYYY)

Value

A teams data frame

col_name types description
team_id integer Unique team identifier.
abbreviation character Short abbreviation.
display_name character Display name.
short_name character Short display name.
mascot character Team mascot.
nickname character Team or athlete nickname.
team character Team-side label or team identifier.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.
href character Link / page URL.
conference_url character URL for conference.
group_id integer Group identifier (e.g. conference group_id).
conference_short_name character Conference short name (e.g. 'ACC').
conference_uid character ESPN universal conference identifier.
conference_name character Full conference name.
conference_logo character Logo image URL for conference.
parent_group_id integer Unique identifier for parent group.
conference_id integer Conference identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

try(espn_mbb_teams())

Get ESPN MBB Tournament Detail

Description

Returns metadata for a single MBB tournament plus the ⁠$ref⁠ URL for the tournament's seasons list. Tournament IDs of interest include the NCAA Tournament and NIT (resolve via espn_mbb_tournaments()).

Usage

espn_mbb_tournament(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
tournament_id character ESPN tournament identifier.
display_name character Human-readable tournament name.
seasons_ref character ⁠$ref⁠ to the seasons-list endpoint.
league character League slug.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_tournament(tournament_id = 3)

Get ESPN MBB Tournament Season Detail

Description

Returns single-row detail for one (tournament, season) pair: id, display name, number of rounds, and ⁠$ref⁠s to the season + bracketology resources. Use espn_mbb_tournament_seasons() to enumerate valid (tournament_id, season) pairs.

Usage

espn_mbb_tournament_season(tournament_id, season, ...)

Arguments

tournament_id

ESPN tournament identifier.
season

Season year (numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_tournament_season(tournament_id = 3, season = 2024)

Get ESPN MBB Tournament Seasons List

Description

Returns the seasons in which a given MBB tournament was held.

Usage

espn_mbb_tournament_seasons(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per season.

col_name types description
league character League slug.
tournament_id character ESPN tournament identifier.
season integer Season year.
ref character Full ⁠$ref⁠ URL for that season.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_tournament_seasons(tournament_id = 3)

Get ESPN MBB Tournaments Index

Description

Returns the index of men's college basketball tournaments tracked by ESPN — including the NCAA Tournament, NIT, conference tournaments, and other in-season events. Pass an ID to espn_mbb_tournament() for the human-readable name and seasons-list ref.

Usage

espn_mbb_tournaments(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per tournament.

col_name types description
tournament_id character ESPN tournament identifier.
ref character Full ⁠$ref⁠ URL for the detail.
league character League slug ("mens-college-basketball").

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_tournaments()

Get ESPN Women's College Basketball Venues

Description

Get ESPN Women's College Basketball Venues

Get ESPN Women's College Basketball Venues

Usage

espn_mbb_venues(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per venue.

col_name types description
venue_id character Unique venue identifier.
name character Display name.
full_name character Player's full name.
address_city character
address_state character
capacity integer
indoor logical
grass logical
images_url character

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_venues()

Get ESPN MBB Per-Week Ranking Detail

Description

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). Typically 25 rows for MBB (AP Top 25).

Usage

espn_mbb_week_ranking(
  ranking_id,
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

ranking_id

Ranking source id (1 = AP, 2 = Coaches, etc.).
week

Week number.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Per-Week Ranking Detail

Value

A tibble with one row per ranked team (typically 25).

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
name character Ranking name (e.g. "AP Top 25").
short_name character Short name.
type character Ranking type code.
headline character Full headline.
date character Date of the ranking.
current integer Current rank.
previous integer Previous-week rank.
points numeric Voting points.
first_place_votes integer First-place vote count.
trend character Trend indicator (e.g. "+3", "-2", "-").
record_summary character Team's record at time of poll (e.g. "20-2").
team_id character ESPN team id.
team_ref character ⁠$ref⁠ to the team-in-season resource.
last_updated character Last-updated timestamp.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_rankings(), espn_mbb_wp()

Examples

espn_mbb_week_ranking(ranking_id = 1, week = 5, season = 2025)

Get ESPN MBB Per-Week Rankings Index

Description

Returns the index of ranking sources available for one (MBB season x season-type x week). Typical sources: AP Top 25 (id 1), Coaches Poll (id 2). Pass an id to espn_mbb_week_ranking() for the ranked teams.

Usage

espn_mbb_week_rankings(
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.
season

Season year. Defaults to most recent MBB season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN MBB Per-Week Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranked-teams detail.

Author(s)

Saiem Gilani

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_wp()

Examples

espn_mbb_week_rankings(week = 5, season = 2025)

Men's College Basketball win probability chart data from ESPN

Description

Men's College Basketball win probability chart data from ESPN

Usage

espn_mbb_wp(game_id)

Arguments

game_id

(Integer required): Game ID filter for querying a single game

Value

espn_mbb_wp() - A data frame with 9 variables:

col_name type description
game_id character Referencing game ID (should be same as game_id from other functions).
play_id character Referencing play ID.
period integer Clock (time) left in the game.
time_left character Clock (time) left in the game.
period_seconds_left integer Seconds left in the period.
game_seconds_left integer Seconds left in the game.
home_win_percentage double The probability of the home team winning the game.
away_win_percentage double The probability of the away team winning the game (calculated as 1 - home_win_percentage - tie_percentage).
tie_percentage double The probability of the game ending the final period in a tie.

See Also

Other ESPN MBB Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_broadcasts(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_officials(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_powerindex(), espn_mbb_game_predictor(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_rosters(), espn_mbb_game_situation(), espn_mbb_game_team_leaders(), espn_mbb_game_team_linescores(), espn_mbb_game_team_records(), espn_mbb_game_team_roster(), espn_mbb_game_team_roster_entry(), espn_mbb_game_team_score(), espn_mbb_game_team_statistics(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_awards(), espn_mbb_player_box(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog(), espn_mbb_player_eventlog_v2(), espn_mbb_player_gamelog(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_splits(), espn_mbb_player_statisticslog(), espn_mbb_player_stats(), espn_mbb_player_stats_v3(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings()

Examples

espn_mbb_wp(game_id = 401256760)

Get ESPN NBA Athletes Index

Description

Get ESPN NBA Athletes Index

Get ESPN NBA Athletes Index

Usage

espn_nba_athletes_index(
  season = most_recent_nba_season(),
  active = TRUE,
  limit = 5000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
active

logical. When TRUE (default) only active athletes are returned. Set to FALSE for the full historical roster.
limit

integer. Maximum number of rows to return. Default 5000. Pass a small value (e.g. limit = 50) in tests to keep execution fast.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per athlete.

col_name types description
athlete_id character Unique athlete identifier (ESPN).
full_name character Player's full name.
jersey character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
team_id character Unique team identifier.
headshot character Headshot image URL.
status character Status label.
link character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_athletes_index(season = 2025, limit = 50)

Get ESPN NBA Season Award Detail

Description

Returns the name, description, and winners of one NBA season award. Most awards have a single winner; multi-recipient awards (e.g. All-NBA First Team) return one row per winner.

Usage

espn_nba_award(award_id, season = most_recent_nba_season(), ...)

Arguments

award_id

ESPN award identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A tibble with one row per winner.

col_name types description
league character League slug ("nba").
season integer Season year.
award_id character ESPN award identifier.
name character Award name (e.g. "MVP").
description character Award description.
athlete_id character ESPN athlete id of winner (parsed from athlete_ref).
team_id character ESPN team id (parsed from team_ref).
athlete_ref character ⁠$ref⁠ to winner's per-season athlete resource.
team_ref character ⁠$ref⁠ to winner's per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# MVP award id = 33
  espn_nba_award(award_id = 33, season = 2024)

Get ESPN NBA's Betting information

Description

Get ESPN NBA's Betting information

Usage

espn_nba_betting(game_id)

Arguments

game_id

Game ID

Value

Returns a named list of data frames: pickcenter, againstTheSpread, predictor

pickcenter

col_name types description
details character Details.
over_under numeric Over under.
spread numeric Spread.
provider_id integer Unique identifier for provider.
provider_name character Provider name.
provider_priority integer Provider priority.
away_team_odds_favorite logical Away team's team odds favorite.
away_team_odds_underdog logical Away team's team odds underdog.
away_team_odds_money_line integer Away team's team odds money line.
away_team_odds_spread_odds numeric Away team's team odds spread odds.
away_team_odds_team_id integer Unique identifier for away team odds team.
away_team_odds_win_percentage numeric Away team odds win percentage (0-1 decimal).
away_team_odds_average_score numeric Away team's team odds average score.
away_team_odds_money_line_odds numeric Away team's team odds money line odds.
away_team_odds_spread_return numeric Away team's team odds spread return.
away_team_odds_spread_record_wins integer Away team's team odds spread record wins.
away_team_odds_spread_record_losses integer Away team's team odds spread record losses.
away_team_odds_spread_record_pushes integer Away team's team odds spread record pushes.
away_team_odds_spread_record_summary character Away team's team odds spread record summary.
home_team_odds_favorite logical Home team's team odds favorite.
home_team_odds_underdog logical Home team's team odds underdog.
home_team_odds_money_line integer Home team's team odds money line.
home_team_odds_spread_odds numeric Home team's team odds spread odds.
home_team_odds_team_id integer Unique identifier for home team odds team.
home_team_odds_win_percentage numeric Home team odds win percentage (0-1 decimal).
home_team_odds_average_score numeric Home team's team odds average score.
home_team_odds_money_line_odds numeric Home team's team odds money line odds.
home_team_odds_spread_return numeric Home team's team odds spread return.
home_team_odds_spread_record_wins integer Home team's team odds spread record wins.
home_team_odds_spread_record_losses integer Home team's team odds spread record losses.
home_team_odds_spread_record_pushes integer Home team's team odds spread record pushes.
home_team_odds_spread_record_summary character Home team's team odds spread record summary.
game_id integer Unique game identifier.

againstTheSpread

col_name types description
id integer Id.
uid character ESPN UID string (universal identifier).
display_name character Display name.
abbreviation character Short abbreviation.
logo character Team or league logo URL.
logos list Logos.
records list Records.
game_id integer Unique game identifier.
team_id integer Unique team identifier.

predictor

col_name types description
game_id integer Unique game identifier.
home_team_id integer Unique identifier for the home team.
away_team_id integer Unique identifier for the away team.
away_team_game_projection numeric Away team's team game projection.
away_team_chance_loss numeric Away team's team chance loss.

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_betting(game_id = 401283399))

Get ESPN NBA Calendar

Description

Get ESPN NBA Calendar

Get ESPN NBA Calendar

Usage

espn_nba_calendar(season = most_recent_nba_season())

Arguments

season

integer or character. Four-digit season year (e.g. 2025). Defaults to most_recent_nba_season().

Details

Retrieve the ESPN NBA schedule calendar for a given season. The underlying scoreboard response contains a leagues[[1]]$calendar block with season-type entries (pre-season, regular, post). Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of calendar entries.

col_name types description
season character Season identifier (4-digit year or 'YYYY-YY' string).
season_type character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_type_label character
season_start_date character Date in YYYY-MM-DD format.
season_end_date character Date in YYYY-MM-DD format.
label character
alternate_label character
detail character
value character Numeric or string value field.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_calendar(season = 2025)

Get ESPN NBA Single-Coach Detail

Description

Returns biography, current team / college refs, and counts of career record entries + per-season coaching entries for one NBA coach. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/coaches/{coach_id}.

Usage

espn_nba_coach(coach_id, ...)

Arguments

coach_id

ESPN coach identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
coach_id character ESPN coach identifier.
uid character ESPN UID string.
first_name character First name.
last_name character Last name.
date_of_birth character Date of birth (ISO 8601).
birth_city character Birth city.
birth_state character Birth state / region.
n_career_records integer Count of career-records entries.
n_coach_seasons integer Count of seasons coached.
college_ref character ⁠$ref⁠ to the coach's college.
team_ref character ⁠$ref⁠ to the coach's current team.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_coach(coach_id = 52120)

Get ESPN NBA Coach Career Record (Long Format)

Description

Returns a coach's career record by type in long format (one row per stat in the record's stats[] array). record_type codes commonly populated: 0 = Total, 1 = Pre Season, 2 = Regular Season, 3 = Post Season. Use espn_nba_coaches() to discover coach_ids for a season.

Usage

espn_nba_coach_record(coach_id, record_type = 0L, ...)

Arguments

coach_id

ESPN coach identifier (use espn_nba_coaches() to find).
record_type

Integer record type: 0 = Total (default), 1 = Pre Season, 2 = Regular Season, 3 = Post Season.
...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_coach_record(coach_id = 52120, record_type = 2)

Get ESPN NBA Coach-in-Season Detail

Description

Per-season coach detail (name, birth info, ⁠$ref⁠s to team/college/ person). ESPN's coverage of this endpoint is sparse; many (coach × season) combinations return 404.

Usage

espn_nba_coach_season(coach_id, season = most_recent_nba_season(), ...)

Arguments

coach_id

ESPN coach identifier.
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Coach-in-Season Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
coach_id character ESPN coach id.
uid character ESPN UID string.
first_name character First name.
last_name character Last name.
date_of_birth character Date of birth.
birth_city character Birth city.
birth_state character Birth state / region.
n_records integer Count of records entries.
person_ref character ⁠$ref⁠ to person resource.
college_ref character ⁠$ref⁠ to college.
team_ref character ⁠$ref⁠ to team-in-season.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_coach_season(coach_id = 52120, season = 2025)

Get ESPN NBA Coaches

Description

Get ESPN NBA Coaches

Get ESPN NBA Coaches

Usage

espn_nba_coaches(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per coach.

col_name types description
coach_id character
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
experience integer Years of professional experience.
team_id character Unique team identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_coaches(season = 2025)

Get ESPN NBA Conferences

Description

Get ESPN NBA Conferences

Get ESPN NBA Conferences

Usage

espn_nba_conferences()

Value

A hoopR_data tibble with one row per conference:

col_name types description
group_id integer Group identifier (e.g. conference group_id).
conference_short_name character Conference short name (e.g. 'ACC').
conference_uid character ESPN universal conference identifier.
conference_name character Full conference name.
conference_logo character Logo image URL for conference.
parent_group_id integer Unique identifier for parent group.
conference_id integer Conference identifier.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_conferences())

Get ESPN NBA Draft Picks

Description

Get ESPN NBA Draft Picks

Get ESPN NBA Draft Picks

Usage

espn_nba_draft(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).

Details

Calls the ESPN core-v2 endpoint ⁠https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{year}/draft/rounds⁠, which returns each round of the draft with its picks inlined as ⁠picks: [...]⁠. For historical seasons with no ESPN draft data the function returns an empty tibble rather than erroring.

Value

A hoopR_data tibble with one row per draft pick:

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
round integer Tournament / playoff round.
pick integer
overall integer Overall.
traded logical
trade_note character
status character Status label.
athlete_id character Unique athlete identifier (ESPN).
athlete_ref character
team_id character Unique team identifier.
team_ref character

Athlete and team details (name, position, college, abbreviation) are not inlined in the draft response; resolve them via espn_nba_player_info() or espn_nba_team() using the returned IDs.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft(season = 2024)

Get ESPN NBA Draft Athlete Detail (Single Drafted Player)

Description

Returns rich single-row detail for one drafted athlete in one NBA draft year: name, height, weight, position, pick (overall/round/team), and a ⁠$ref⁠ to the athlete's core-v2 profile. Use espn_nba_draft_athletes() to enumerate draftees for a year.

Usage

espn_nba_draft_athlete_detail(
  season = most_recent_nba_season(),
  athlete_id,
  ...
)

Arguments

season

Draft year (numeric). Defaults to the most recent NBA season.
athlete_id

ESPN draftee identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft_athlete_detail(season = 2024, athlete_id = 1966)

Get ESPN NBA Draft Athletes Index

Description

Returns one row per drafted athlete in a given NBA draft year.

Usage

espn_nba_draft_athletes(season = most_recent_nba_season(), ...)

Arguments

season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Draft Athletes Index

Value

A tibble of athlete IDs + ⁠$ref⁠ URLs.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft_athletes(season = 2024)

Get ESPN NBA Draft Pick Detail

Description

Returns a single NBA draft pick. Defaults to the most recent NBA season's #1 overall pick. For a full draft, use espn_nba_draft().

Usage

espn_nba_draft_pick(
  season = most_recent_nba_season(),
  round = 1L,
  pick = 1L,
  ...
)

Arguments

season

Season year. Defaults to most recent NBA season.
round

Draft round (default 1).
pick

Pick number within the round (default 1).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Draft Pick Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year of the draft.
round integer Round number.
pick integer Pick within the round.
overall integer Overall pick number.
traded logical Whether the pick was traded.
trade_note character Trade note (if any).
status character Pick status name.
athlete_id character Drafted athlete's ESPN id.
team_id character Drafting team's ESPN id.
athlete_ref character ⁠$ref⁠ to athlete.
team_ref character ⁠$ref⁠ to team.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft_pick(season = 2024, round = 1, pick = 1)

Get ESPN NBA Draft Rounds Summary

Description

Returns one row per round of the NBA draft (typically 2 rounds: 1st with 30 picks, 2nd with ~28 picks).

Usage

espn_nba_draft_rounds(season = most_recent_nba_season(), ...)

Arguments

season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Draft Rounds Summary

Value

A tibble with one row per round.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft_rounds(season = 2024)

Get ESPN NBA Draft Status

Description

Returns the current status of one NBA draft year (round, state, description). Live during the draft; static afterward.

Usage

espn_nba_draft_status(season = most_recent_nba_season(), ...)

Arguments

season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Draft Status

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_draft_status(season = 2024)

Get ESPN NBA Franchise Detail

Description

Returns franchise-level metadata for an NBA franchise. Franchise IDs are stable across relocations and rebrands — useful for tracking franchise history independent of current team identity.

Usage

espn_nba_franchise(franchise_id, ...)

Arguments

franchise_id

ESPN franchise identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
id character ESPN franchise identifier.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Franchise location.
name character Franchise name.
nickname character Common nickname (often same as name).
abbreviation character Short abbreviation.
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
is_active logical Whether franchise is currently active.
league character League slug ("nba").
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
venue_ref character ⁠$ref⁠ to franchise's primary venue.
team_ref character ⁠$ref⁠ to the current team for franchise.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_franchise(franchise_id = 13)

Get ESPN NBA Franchises Index

Description

Returns the full NBA franchises index from sports.core.api.espn.com/v2/sports/basketball/leagues/nba/franchises. Each row is one franchise with its ID and the canonical ⁠$ref⁠ URL — pass an ID to espn_nba_franchise() for full franchise detail.

Usage

espn_nba_franchises(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per franchise.

col_name types description
franchise_id character ESPN franchise identifier.
ref character Full ⁠$ref⁠ URL for franchise detail.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_franchises()

Get ESPN NBA Free Agents

Description

Get ESPN NBA Free Agents

Get ESPN NBA Free Agents

Usage

espn_nba_freeagents(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).

Details

Calls the ESPN core-v2 endpoint ⁠https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{year}/freeagents⁠. As of 2026-05, this endpoint returns HTTP 500 for every season tested and there is no documented replacement; the function consequently returns an empty tibble and emits a CLI error message. It is retained so that downstream code does not break if ESPN restores the endpoint, but should not be relied on in the meantime.

Value

A hoopR_data tibble with one row per free agent:

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
prior_team_id character
status character Status label.
signed_team_id character
signed_date character
contract_value character
contract_term_years character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_freeagents(season = 2025)

Get ESPN NBA Season Futures (Long Format)

Description

Returns the full futures-betting board for an NBA season, in long format: one row per (market x team). Markets include championship winner, conference winner, division winner, MVP odds, etc. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/futures.

Usage

espn_nba_futures(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A long-format tibble.

col_name types description
season integer Season year.
league character League slug ("nba").
market_id character ESPN futures-market identifier.
market_name character Internal market name (e.g. "NBA - Winner").
market_type character Market type code (winLeague, winConference, winDivision, ...).
market_display character Human-readable name (e.g. "NBA Championship Winner").
provider_id character Sportsbook provider identifier.
provider_name character Sportsbook provider name (e.g. "ESPN BET").
team_id character ESPN team id (parsed from team_ref).
odds_value character American odds for the team (e.g. "-250", "+800").
team_ref character ⁠$ref⁠ to the per-season team resource.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_futures(season = 2025)

Get ESPN NBA game data (Pbp, Team and Player Box)

Description

Get ESPN NBA game data (Pbp, Team and Player Box)

Usage

espn_nba_game_all(game_id)

Arguments

game_id

Game ID

Value

A named list of data frames: Plays, Team, Player

Plays

col_name types description
id character Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
type_id integer Type identifier (numeric).
type_text character Display text for the type field.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
team_id integer Unique team identifier.
coordinate_x_raw numeric X coordinate as returned by the API before any adjustment.
coordinate_y_raw numeric Y coordinate as returned by the API before any adjustment.
coordinate_x numeric X coordinate on the court (half-court layout).
coordinate_y numeric Y coordinate on the court (half-court layout).
play_id character Unique play identifier within a game.
athlete_id_1 integer Primary athlete identifier (e.g. shooter).
athlete_id_2 integer Secondary athlete identifier (e.g. assister / fouler).
athlete_id_3 integer Athlete id 3.
home_team_id integer Unique identifier for the home team.
home_team_mascot character Home team mascot.
home_team_name character Home team name.
home_team_abbrev character Home team three-letter abbreviation.
home_team_logo character Home team logo URL.
home_team_logo_dark character Home team logo URL for dark backgrounds.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_team_alternate_color character Home team alternate color (hex).
home_team_score integer Home team's score.
home_team_winner logical TRUE if the home team won this game.
home_team_record character Home team's win-loss record.
away_team_id integer Unique identifier for the away team.
away_team_mascot character Away team mascot.
away_team_name character Away team name.
away_team_abbrev character Away team three-letter abbreviation.
away_team_logo character Away team logo URL.
away_team_logo_dark character Away team logo URL for dark backgrounds.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_team_alternate_color character Away team alternate color (hex).
away_team_score integer Away team's score.
away_team_winner logical TRUE if the away team won this game.
away_team_record character Away team's win-loss record.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).

Team

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
team_home_away character Team home away.
team_score integer Team's score / final score.
team_winner logical TRUE if the team won this game.
assists integer Total assists.
blocks integer Total blocks.
defensive_rebounds integer Defensive rebounds.
fast_break_points character Fast-break points scored.
field_goal_pct numeric Field goal percentage (0-1).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
flagrant_fouls integer Total flagrant fouls.
fouls integer Personal fouls.
free_throw_pct numeric Free throw percentage (0-1).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
largest_lead character Largest lead during the game.
offensive_rebounds integer Offensive rebounds.
points_in_paint character Points scored in the paint.
steals integer Total steals.
team_turnovers integer Team turnovers (turnovers credited to the team rather than a player).
technical_fouls integer Total technical fouls.
three_point_field_goal_pct numeric Three-point field goal percentage (0-1).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
total_rebounds integer Total rebounds.
total_technical_fouls integer Total technical fouls (player + team).
total_turnovers integer Total turnovers (player + team).
turnover_points character Turnover points.
turnovers integer Total turnovers.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_uid character Opponent team uid.
opponent_team_slug character Opponent team slug.
opponent_team_location character Opponent team city / location.
opponent_team_name character Opponent team display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_display_name character Opponent team full display name.
opponent_team_short_display_name character Opponent team short display name.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_logo character Opponent team logo URL.
opponent_team_score integer Opponent team's score.

Player

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
plus_minus character Plus/minus point differential while on court.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
reason character Reason.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_game_all(game_id = 401283399))

Get ESPN NBA Event Broadcasts

Description

Get ESPN NBA Event Broadcasts

Get ESPN NBA Event Broadcasts

Usage

espn_nba_game_broadcasts(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per broadcast outlet for the game.

col_name types description
event_id character Unique event / game identifier (ESPN).
broadcast_id character
type_id character Type identifier (numeric).
type_short_name character
type_long_name character
market_id character
market_type character
names character
lang character
region character Region label.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_broadcasts(event_id = "401283399")

Get ESPN NBA Event Odds

Description

Get ESPN NBA Event Odds

Get ESPN NBA Event Odds

Usage

espn_nba_game_odds(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A tibble with one row per odds provider.

col_name types description
event_id character Unique event / game identifier (ESPN).
provider_id character Unique identifier for provider.
provider_name character Provider name.
details character Details.
over_under numeric Over under.
spread numeric Spread.
home_money_line integer
away_money_line integer
home_team_odds_open numeric
home_team_odds_close numeric
away_team_odds_open numeric
away_team_odds_close numeric

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_odds(event_id = "401283399")

Get ESPN NBA Event Official Detail (Single Official)

Description

Returns a single-row tibble for one referee assigned to one NBA event, with their name, position (Referee / Crew Chief / Umpire), and crew order. Pair with espn_nba_game_officials() to enumerate the crew.

Usage

espn_nba_game_official_detail(event_id, order, ...)

Arguments

event_id

ESPN event identifier.
order

Crew order index (1 = first official). Pair with the order column from event_officials().
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_official_detail(event_id = 401283399, order = 1)

Get ESPN NBA Event Officials

Description

Get ESPN NBA Event Officials

Get ESPN NBA Event Officials

Usage

espn_nba_game_officials(event_id, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per official assigned to the game.

col_name types description
event_id character Unique event / game identifier (ESPN).
official_id character Unique official / referee identifier.
full_name character Player's full name.
display_name character Display name.
position_id character Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_type character
order integer Display order within the result set.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_officials(event_id = "401283399")

Get ESPN NBA Event Play Detail (Single Play)

Description

Returns the rich detail block for a single NBA play: sequence, period, clock, text, scoring/shooting flags, current home/away score, team ⁠$ref⁠, and shot coordinates if applicable. Complements the bulk espn_nba_pbp() output by exposing the canonical core-v2 play record.

Usage

espn_nba_game_play(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.
play_id

ESPN play identifier (visible in pbp() output as play_id or extractable from ⁠plays[].$ref⁠).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_play(event_id = 401283399, play_id = 4012833994)

Get ESPN NBA Event Play Personnel (On-Court Lineup at Play)

Description

Returns the players on court at a specific NBA play in long format (one row per athlete entry across both competitors). Foundation for lineup analysis. ESPN coverage is sparse — many plays return zero rows; the wrapper returns a typed empty tibble in that case.

Usage

espn_nba_game_play_personnel(event_id, play_id, ...)

Arguments

event_id

ESPN event identifier.
play_id

ESPN play identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per on-court athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_play_personnel(event_id = 401283399, play_id = 4012833994)

Get ESPN NBA Event Player Box Score (Long Format)

Description

Returns the long-format per-game box score for a single athlete in one NBA event. One row per (category x stat). Same shape as espn_nba_game_team_statistics() but scoped to a single athlete-in-event instead of the full team. stat_type defaults to 0 (regular-season aggregate as ESPN tags it for finished events).

Usage

espn_nba_game_player_box(event_id, team_id, athlete_id, stat_type = 0L, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier (the competitor the athlete played for).
athlete_id

ESPN athlete identifier.
stat_type

Integer stat-type segment. Defaults to 0 (the only type commonly populated for finished events).
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_player_box(event_id = 401283399, team_id = 29,
                               athlete_id = 1966)

Get ESPN NBA Event Power Index Index

Description

Returns the per-team power-index ⁠$ref⁠ URLs for one NBA event. Coverage is sparse — many events return zero items.

Usage

espn_nba_game_powerindex(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Event Power Index Index

Value

A tibble with one row per team-game power-index entry.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_powerindex(event_id = 401283399)

Get ESPN NBA Event Predictor (Pre-game)

Description

Returns pre-game predictor statistics for one NBA event in long format: one row per (team × statistic). Typical stats include matchup quality, predicted score, win probability, and team strength metrics. Returns empty for events without predictor data (often the case for already-played games).

Usage

espn_nba_game_predictor(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Event Predictor (Pre-game)

Value

A long tibble with rows for both home and away teams.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_predictor(event_id = 401283399)

Get ESPN NBA Event Win Probabilities

Description

Get ESPN NBA Event Win Probabilities

Get ESPN NBA Event Win Probabilities

Usage

espn_nba_game_probabilities(event_id, limit = 200, ...)

Arguments

event_id

ESPN event/game identifier (character or numeric).
limit

integer. Maximum number of probability rows to return. Defaults to 200. Pagination is handled internally.
...

Additional arguments; currently unused.

Value

A tibble with one row per play-level win-probability entry.

col_name types description
event_id character Unique event / game identifier (ESPN).
sequence_number character Sequence number representing a shot-possession (V3 PBP).
play_id character Unique play identifier within a game.
period integer Period of the game (1-4 quarters; 5+ for OT).
clock character Game clock value.
home_win_percentage numeric Home win percentage (0-1 decimal).
away_win_percentage numeric Away win percentage (0-1 decimal).
tie_percentage numeric Tie percentage (0-1 decimal).
secs_to_end_of_period numeric
secs_to_end_of_game numeric

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_probabilities(event_id = "401283399", limit = 50)

Get ESPN NBA Event Prop Bets (Long Format)

Description

Returns prop-bet markets for one NBA event + provider in long format: one row per (athlete × prop type). Each row has american / decimal / fraction odds plus the current target (e.g. over/under line). Hits the core-v2 competitions/{id}/odds/{provider_id}/propBets endpoint and auto-paginates.

Usage

espn_nba_game_propbets(event_id, provider_id, ...)

Arguments

event_id

ESPN event identifier.
provider_id

Sportsbook provider id (e.g. 58 = ESPN BET, 100 = Caesars). Look up via espn_nba_game_odds().
...

Additional arguments; currently unused.

Details

Get ESPN NBA Event Prop Bets (Long Format)

Value

A long tibble with one row per (athlete × prop type).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_propbets(event_id = 401283399, provider_id = 58)

Get ESPN NBA game rosters

Description

Get ESPN NBA game rosters

Usage

espn_nba_game_rosters(game_id)

Arguments

game_id

Game ID

Value

A game rosters data frame

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
athlete_display_name character Athlete display name (full).
short_name character Short display name.
weight integer Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height integer Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
debut_year integer Year of professional debut.
birth_place_city character Birth place city.
birth_place_state character Birth place state.
birth_place_country character Birth place country.
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
years integer Years.
active logical TRUE if the row represents an active record (player / team / season).
contract_bird_status integer Contract bird status.
contract_active logical Contract active.
contract_active_1 logical Contract active 1.
contract_incoming_trade_value integer Contract incoming trade value.
contract_outgoing_trade_value integer Contract outgoing trade value.
contract_minimum_salary_exception logical Contract minimum salary exception.
contract_option_type integer Contract option type.
contract_salary integer Contract salary.
contract_salary_remaining integer Contract salary remaining.
contract_years_remaining integer Contract years remaining.
contract_trade_kicker_active logical Contract trade kicker active.
contract_trade_kicker_percentage integer Contract trade kicker percentage (0-1 decimal).
contract_trade_kicker_value integer Contract trade kicker value.
contract_trade_kicker_trade_value integer Contract trade kicker trade value.
contract_trade_restriction logical Contract trade restriction.
contract_unsigned_foreign_pick logical Contract unsigned foreign pick.
contract_active_2 logical Contract active 2.
draft_display_text character Draft display text.
draft_round integer Round of the draft selection.
draft_year integer Draft year (4-digit).
draft_selection integer Draft selection.
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
valid logical Valid.
did_not_play logical TRUE if the player did not appear in the game.
display_name character Display name.
reason character Reason.
ejected logical TRUE if the player was ejected from the game.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
logos_href_2 character Logos href 2.
logos_href_3 character Logos href 3.
game_id integer Unique game identifier.
order integer Display order within the result set.
home_away character Game venue label ('home' or 'away').
winner logical Winner.
citizenship character Citizenship.
contract_base_year_compensation_active logical Contract base year compensation active.
contract_base_year_compensation_expiration character Contract base year compensation expiration.
hand_type character Hand type.
hand_abbreviation character Hand abbreviation.
hand_display_value character Hand display value.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_game_rosters(game_id = 401283399))

Get ESPN NBA Event Situation (Live)

Description

Returns the live game situation for one NBA event: timeouts remaining, team fouls, fouls to give, bonus state, and a ⁠$ref⁠ to the last play. During a live game this reflects current state; after the game ends the values are frozen.

Usage

espn_nba_game_situation(event_id, ...)

Arguments

event_id

ESPN event identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble with timeouts + fouls for both teams.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_situation(event_id = 401283399)

Get ESPN NBA Event Competitor Leaders (Top Performers)

Description

Returns the per-team statistical leaders for one NBA event in long format: one row per (category x athlete rank). Categories typically include points, rebounds, assists, and rating.

Usage

espn_nba_game_team_leaders(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x rank).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_leaders(event_id = 401283399, team_id = 29)

Get ESPN NBA Event Competitor Linescores (Per-Quarter)

Description

Returns the per-quarter scoring breakdown for one team in one NBA event. One row per period (regulation quarters + any overtime periods).

Usage

espn_nba_game_team_linescores(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier (the competitor whose linescore to fetch).
...

Additional arguments; currently unused.

Value

A tibble with one row per period.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_linescores(event_id = 401283399, team_id = 29)

Get ESPN NBA Event Competitor Records (At-Game Breakdown)

Description

Returns team records as of the given NBA event: overall, home, away, conference, and division breakdowns where available. One row per record type.

Usage

espn_nba_game_team_records(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per record type.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_records(event_id = 401283399, team_id = 29)

Get ESPN NBA Event Competitor Roster (Game-Day)

Description

Returns the game-day roster index for one team in one NBA event. Each row carries the athlete id and the core-v2 ⁠$ref⁠ URL — use the ref to dereference athlete-game splits or biographical data.

Usage

espn_nba_game_team_roster(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per active athlete.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_roster(event_id = 401283399, team_id = 29)

Get ESPN NBA Event Competitor Roster Entry (Per-Athlete Game-Day Row)

Description

Returns a single-row tibble describing one athlete's game-day roster entry for one NBA event. Carries the starter flag, didNotPlay flag with reason, ejection flag, and the substitution slot if the athlete came in for another player. Pair with espn_nba_game_team_roster() to enumerate the roster.

Usage

espn_nba_game_team_roster_entry(event_id, team_id, athlete_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
athlete_id

ESPN athlete identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_roster_entry(event_id = 401283399,
                                            team_id = 13,
                                            athlete_id = 1966)

Get ESPN NBA Event Competitor Score (Single Row)

Description

Returns a one-row tibble with one team's final score for one NBA event: numeric value, display string, winner flag, and source metadata. Quick-lookup wrapper — use espn_nba_game_team_linescores() for per-period detail.

Usage

espn_nba_game_team_score(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_score(event_id = 401283399, team_id = 29)

Get ESPN NBA Event Competitor Team Statistics (Long Format)

Description

Returns full team-game statistics for one team in one NBA event in long format: one row per (category x stat). Covers offensive, defensive, and general categories with both raw values and display strings.

Usage

espn_nba_game_team_statistics(event_id, team_id, ...)

Arguments

event_id

ESPN event identifier.
team_id

ESPN team identifier.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_game_team_statistics(event_id = 401283399, team_id = 29)

Get ESPN NBA Injuries

Description

Get ESPN NBA Injuries

Get ESPN NBA Injuries

Usage

espn_nba_injuries(season = most_recent_nba_season(), ...)

Arguments

season

Numeric or character season year (e.g. 2025). The ESPN injury endpoint does not filter by season server-side; the value is attached as a constant column on the returned tibble for downstream joins. Defaults to most_recent_nba_season().
...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of league-wide NBA injury records. Returns an empty tibble (zero rows) when no injuries are reported.

Injuries

col_name types description
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
status character Status label.
date character Date in YYYY-MM-DD format.
type character Record type / category.
side character Side label (e.g. 'home', 'away', or 'overUnder').
returns_at character
short_comment character
long_comment character Long-form play / event comment.
season integer Season identifier (4-digit year or 'YYYY-YY' string).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_injuries()

Get ESPN NBA League Leaders

Description

Get ESPN NBA League Leaders

Get ESPN NBA League Leaders

Usage

espn_nba_leaders(season = most_recent_nba_season(), season_type = 2, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per category-athlete pair.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
category character Category label.
abbreviation character Short abbreviation.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
team_id character Unique team identifier.
team_abbrev character
value numeric Numeric or string value field.
rank integer Rank.
display_value character Human-readable display value.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_leaders(season = 2024, season_type = 2)

Get ESPN NBA News

Description

Get ESPN NBA News

Get ESPN NBA News

Usage

espn_nba_news(limit = 50)

Arguments

limit

integer. Maximum number of articles to return. Default 50.

Details

Retrieve ESPN NBA news. Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of news articles.

col_name types description
id character Id.
type character Record type / category.
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).
premium logical
byline character News article byline / author.
link_web character Web link / URL.
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_news(limit = 5)

Get ESPN NBA PBP data

Description

Get ESPN NBA PBP data

Usage

espn_nba_pbp(game_id)

Arguments

game_id

Game ID

Value

A play-by-play data frame.

Plays

col_name types description
id character Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
type_id integer Type identifier (numeric).
type_text character Display text for the type field.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
team_id integer Unique team identifier.
coordinate_x_raw numeric X coordinate as returned by the API before any adjustment.
coordinate_y_raw numeric Y coordinate as returned by the API before any adjustment.
coordinate_x numeric X coordinate on the court (half-court layout).
coordinate_y numeric Y coordinate on the court (half-court layout).
play_id character Unique play identifier within a game.
athlete_id_1 integer Primary athlete identifier (e.g. shooter).
athlete_id_2 integer Secondary athlete identifier (e.g. assister / fouler).
athlete_id_3 integer Athlete id 3.
home_team_id integer Unique identifier for the home team.
home_team_mascot character Home team mascot.
home_team_name character Home team name.
home_team_abbrev character Home team three-letter abbreviation.
home_team_logo character Home team logo URL.
home_team_logo_dark character Home team logo URL for dark backgrounds.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_team_alternate_color character Home team alternate color (hex).
home_team_score integer Home team's score.
home_team_winner logical TRUE if the home team won this game.
home_team_record character Home team's win-loss record.
away_team_id integer Unique identifier for the away team.
away_team_mascot character Away team mascot.
away_team_name character Away team name.
away_team_abbrev character Away team three-letter abbreviation.
away_team_logo character Away team logo URL.
away_team_logo_dark character Away team logo URL for dark backgrounds.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_team_alternate_color character Away team alternate color (hex).
away_team_score integer Away team's score.
away_team_winner logical TRUE if the away team won this game.
away_team_record character Away team's win-loss record.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_pbp(game_id = 401071880))

Get ESPN NBA Athlete Awards

Description

Get ESPN NBA Athlete Awards

Get ESPN NBA Athlete Awards

Usage

espn_nba_player_awards(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single tibble. This endpoint is sparse; many athletes have no award data, in which case an empty tibble with canonical columns is returned.

col_name types description
season character Season identifier (4-digit year or 'YYYY-YY' string).
award_id character
name character Display name.
description character Long-form description text.
date character Date in YYYY-MM-DD format.
type character Record type / category.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_awards(athlete_id = "1966")

Get ESPN NBA player box scores

Description

Get ESPN NBA player box scores

Usage

espn_nba_player_box(game_id)

Arguments

game_id

Game ID

Value

A player boxscore data frame

Player

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
plus_minus character Plus/minus point differential while on court.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
reason character Reason.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_player_box(game_id = 401071880))

Get ESPN NBA Athlete Career Stats (Long Format)

Description

Returns career stats for an NBA athlete in long format. Default stat_type = 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to attempt multiple types and bind them via a stat_type_id column; variants that 404 for that athlete are silently skipped. Stat types: 0 = regular season (default endpoint), 1 = postseason, 2 = career aggregate. Coverage of types 1 and 2 is sparse — many athletes only have type 0 populated.

Usage

espn_nba_player_career_stats(athlete_id, stat_type = 0L, ...)

Arguments

athlete_id

ESPN athlete identifier.
stat_type

Integer or integer vector of stat-type codes. Default 0L fetches the standard "All Splits" / regular-season view. Pass a vector like c(0L, 1L, 2L) to bind multiple types via a stat_type_id column; non-existent variants are silently skipped.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Athlete Career Stats (Long Format)

Value

A long tibble (one row per stat_type × split × category × stat).

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
stat_type_id character Stat-type code (0 = reg, 1 = post, 2 = career).
split_id character Split id.
split_name character Split name (typically "All Splits").
split_type character Split type code.
category_name character Category key (e.g. "defensive").
category_display character Category display name.
category_short character Category short display.
category_abbrev character Category abbreviation.
stat_name character Stat key.
stat_abbrev character Stat abbreviation.
stat_display character Stat display name.
stat_short character Stat short display.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# LeBron James — regular + postseason combined
  espn_nba_player_career_stats(athlete_id = 1966)
  # Just career aggregate
  espn_nba_player_career_stats(athlete_id = 1966, stat_type = 2L)

Get ESPN NBA Athlete Contract (Single Season)

Description

Returns the full contract record for one NBA athlete in one season, including salary, cap-rule flags, option type, Bird status, and trade protections. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/athletes/{athlete_id}/contracts/{season}.

Usage

espn_nba_player_contract(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
athlete_id character ESPN athlete identifier.
season integer Contract season year.
bird_status integer Bird-rights tier (0 = Non, 1 = Early, 2 = Full).
salary numeric Total cap-counting salary for the season ($).
salary_remaining numeric Remaining salary owed.
years_remaining integer Years left on the contract.
incoming_trade_value numeric Trade value if receiving this contract ($).
outgoing_trade_value numeric Trade value if sending out this contract ($).
option_type integer Option type code (e.g. team / player option).
minimum_salary_exception logical Signed under the minimum-salary exception.
trade_restriction logical Whether a trade restriction is active.
unsigned_foreign_pick logical Unsigned-foreign-pick flag.
active logical Whether the contract is currently active.
base_year_compensation_active logical Base-year-compensation rule active.
poison_pill_provision_active logical Poison-pill provision active.
trade_kicker_active logical Trade kicker active.
trade_kicker_percentage numeric Trade kicker percentage of salary.
trade_kicker_value numeric Trade kicker dollar value.
trade_kicker_trade_value numeric Trade kicker post-trade dollar value.
season_ref character ⁠$ref⁠ to the season resource.
team_ref character ⁠$ref⁠ to the team-in-season resource.
team_id character ESPN team id parsed from team_ref.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# LeBron James 2025 contract
  espn_nba_player_contract(athlete_id = 1966, season = 2025)

Get ESPN NBA Athlete Contracts Index

Description

Returns the index of contract seasons recorded for an NBA athlete from sports.core.api.espn.com/v2/sports/basketball/leagues/nba/athletes/{athlete_id}/contracts. Each row is one contract year — pass the season to espn_nba_player_contract() for the full contract record.

Usage

espn_nba_player_contracts(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per contract year.

col_name types description
athlete_id character ESPN athlete identifier.
season integer Contract season year.
ref character Full ⁠$ref⁠ URL for the contract detail.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# LeBron James — athlete id 1966
  espn_nba_player_contracts(athlete_id = 1966)

Get ESPN NBA Athlete Eventlog

Description

Get ESPN NBA Athlete Eventlog

Get ESPN NBA Athlete Eventlog

Usage

espn_nba_player_eventlog(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single tibble. Per-event statistics.$ref URLs from the ESPN core-v2 API are returned as the character column statistics_ref and are NOT resolved. Similarly, event_ref, competition_ref, and team_ref are returned as character columns.

col_name types description
event_ref character Reference link to the originating event.
competition_ref character
team_ref character
statistics_ref character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_eventlog(athlete_id = "1966", season = 2024)

Get ESPN NBA Athlete Per-Season Event Log (core-v2)

Description

Returns one row per (event x team) for an NBA athlete's appearances in a given season. Distinct from espn_nba_player_eventlog() which wraps the web-common-v3 gamelog endpoint returning stats per game; this core-v2 variant returns refs + played flag and is era-correct.

Usage

espn_nba_player_eventlog_v2(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier.
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Value

A tibble with one row per event appearance. See package source for column schema.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_eventlog_v2(athlete_id = 1966, season = 2025)

Get ESPN NBA Athlete Gamelog

Description

Get ESPN NBA Athlete Gamelog

Get ESPN NBA Athlete Gamelog

Usage

espn_nba_player_gamelog(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single tibble with one row per game. Column names reflect the stat labels returned by ESPN and will vary by season and player.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_gamelog(athlete_id = "1966", season = 2024)

Get ESPN NBA Athlete Info

Description

Get ESPN NBA Athlete Info

Get ESPN NBA Athlete Info

Usage

espn_nba_player_info(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of data frames: Bio, Team, Position, Status, College, Draft.

Bio

col_name types description
id character Id.
full_name character Player's full name.
display_name character Display name.
jersey character Jersey number worn by the player.
age character Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
headshot_href character Headshot image URL.

Team

col_name types description
id character Id.
abbreviation character Short abbreviation.
display_name character Display name.

Position

col_name types description
id character Id.
name character Display name.
abbreviation character Short abbreviation.

Status

col_name types description
id character Id.
name character Display name.
type character Record type / category.

College

col_name types description
id character Id.
name character Display name.
mascot character Team mascot.

Draft

col_name types description
year character 4-digit year.
round character Tournament / playoff round.
selection character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_info(athlete_id = "1966")

Get ESPN NBA Athlete Overview

Description

Get ESPN NBA Athlete Overview

Get ESPN NBA Athlete Overview

Usage

espn_nba_player_overview(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A named list of data frames: Statistics, NextGame, Last5Games, Headlines, FantasyOutlook.

Statistics

col_name types description
(varies) character

NextGame

col_name types description
id character Id.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.

Last5Games

col_name types description
(varies) character

Headlines

col_name types description
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).

FantasyOutlook

col_name types description
(varies) character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_overview(athlete_id = "1966", season = 2024)

Get ESPN NBA Athlete Career Seasons

Description

Returns the list of seasons an NBA athlete appeared in. Useful for bounding follow-up calls to per-season endpoints.

Usage

espn_nba_player_seasons(athlete_id, ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A tibble with one row per career season.

col_name types description
league character League slug.
athlete_id character ESPN athlete id.
season integer Season year.
ref character ⁠$ref⁠ URL to the season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# LeBron James (1966): 23 career seasons
  espn_nba_player_seasons(athlete_id = 1966)

Get ESPN NBA Athlete Splits

Description

Get ESPN NBA Athlete Splits

Get ESPN NBA Athlete Splits

Usage

espn_nba_player_splits(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single long-format tibble. When data are present, columns include at minimum category and split_name, plus per-stat columns driven by ESPN labels.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_splits(athlete_id = "1966", season = 2024)

Get ESPN NBA Athlete Statisticslog

Description

Get ESPN NBA Athlete Statisticslog

Get ESPN NBA Athlete Statisticslog

Usage

espn_nba_player_statisticslog(
  athlete_id,
  season = most_recent_nba_season(),
  ...
)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single tibble. When resolved, each row corresponds to one statistical entry in the core-v2 statistics log, with event_ref and statistics_ref character columns pointing to resolvable ESPN endpoints.

col_name types description
event_ref character Reference link to the originating event.
statistics_ref character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_statisticslog(athlete_id = "1966", season = 2024)

Get ESPN NBA player stats data

Description

Get ESPN NBA player stats data

Usage

espn_nba_player_stats(athlete_id, year, season_type = "regular", total = FALSE)

Arguments

athlete_id

Athlete ID
year

Year
season_type

(character, default: regular): Season type - regular or postseason
total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the player stats data

col_name types description
athlete_id integer Unique athlete identifier (ESPN).
athlete_uid character ESPN athlete UID (universal identifier).
athlete_guid character ESPN athlete GUID.
athlete_type character Athlete type / class.
sdr integer Sdr.
first_name character Player's first name.
last_name character Player's last name.
full_name character Player's full name.
display_name character Display name.
short_name character Short display name.
weight numeric Player weight in pounds.
display_weight character Player weight in display format (e.g. '180 lbs').
height numeric Player height (string e.g. '6-2' or inches).
display_height character Player height in display format (e.g. '6-2').
age integer Player age (in years).
date_of_birth character Date of birth (YYYY-MM-DD).
slug character URL-safe identifier.
headshot_href character Headshot image URL.
headshot_alt character Alternative-text label for the headshot.
jersey character Jersey number worn by the player.
position_id integer Unique position identifier.
position_name character Listed roster position ('Guard', 'Forward', 'Center').
position_display_name character Position display name.
position_abbreviation character Position abbreviation ('G' / 'F' / 'C').
position_leaf logical Position leaf.
linked logical TRUE if the record is linked to a related entity.
years integer Years.
active logical TRUE if the row represents an active record (player / team / season).
contract_x_ref character Contract x ref.
contract_bird_status integer Contract bird status.
contract_active logical Contract active.
contract_active_1 logical Contract active 1.
contract_incoming_trade_value integer Contract incoming trade value.
contract_outgoing_trade_value integer Contract outgoing trade value.
contract_minimum_salary_exception logical Contract minimum salary exception.
contract_option_type integer Contract option type.
contract_salary integer Contract salary.
contract_salary_remaining integer Contract salary remaining.
contract_years_remaining integer Contract years remaining.
contract_x_ref_1 character Contract x ref 1.
contract_x_ref_2 character Contract x ref 2.
contract_trade_kicker_active logical Contract trade kicker active.
contract_trade_kicker_percentage numeric Contract trade kicker percentage (0-1 decimal).
contract_trade_kicker_value integer Contract trade kicker value.
contract_trade_kicker_trade_value integer Contract trade kicker trade value.
contract_trade_restriction logical Contract trade restriction.
contract_unsigned_foreign_pick logical Contract unsigned foreign pick.
contract_active_2 logical Contract active 2.
draft_display_text character Draft display text.
draft_round integer Round of the draft selection.
draft_year integer Draft year (4-digit).
draft_selection integer Draft selection.
draft_x_ref character Draft x ref.
draft_x_ref_1 character Draft x ref 1.
status_id integer Status identifier.
status_name character Status label.
status_type character Status type.
status_abbreviation character Status abbreviation.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_def_rebound_rate numeric The percentage of missed shots that a team rebounds defensively. Rebound Rate = (Defensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Defensive Rebounds + Opponent Defensive Rebounds)).
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
defensive_avg48defensive_rebounds numeric The average number of defensive rebounds per 48 minutes.
defensive_avg48blocks numeric The average number of blocks per 48 minutes.
defensive_avg48steals numeric The average number of steals per 48 minutes.
defensive_drpm numeric Defensive Real Plus-Minus.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_per numeric A numerical value for each of a player's accomplishments per-minute and is pace-adjusted for the team they play on. The league average in PER to 15.00 every season.
general_rebound_rate numeric The percentage of missed shots that a team rebounds. Rebound Rate = (Rebounds x Team Minutes) divided by (Player Minutes x (Team Rebounds + Opponent Rebounds)).
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_vorp numeric Value Over Replacement Player.
general_warp numeric Wins Above Replacement Player.
general_rpm numeric Real Plus-Minus.
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_nba_rating numeric General nba rating.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_avg48rebounds numeric The average number of rebounds per 48 minutes.
general_avg48fouls numeric The average number of fouls committed per 48 minutes.
general_avg48flagrant_fouls numeric The average number of flagrant fouls committed per 48 minutes.
general_avg48technical_fouls numeric The average number of technical fouls committed per 48 minutes.
general_avg48ejections numeric The average number of ejections per 48 minutes.
general_avg48disqualifications numeric The average number of disqualifications per 48 minutes.
general_r40 numeric Rebounds Per 40 Minutes.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_effective_fg_pct numeric Offensive effective field goals percentage (0-1 decimal).
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_true_shooting_pct numeric What a team's shooting percentage would be if we accounted for free throws and 3-pointers. True Shooting Percentage = (Total points x 50) divided by ((FGA + (FTA x 0.44)).
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_assist_ratio numeric The percentage of a team's possessions that ends in an assist. Assist Ratio = (Assists x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_off_rebound_rate numeric The percentage of missed shots that a team rebounds offensively. Offensive Rebound Rate = (Offensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Offensive Rebounds + Opponent Defensive Rebounds)).
offensive_turnover_ratio numeric The percentage of a team's possessions that end in a turnover. Turnover Ratio = (Turnover x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_brick_index numeric How many points a player costs his team with his shooting compared with the league average on a per-40-minute basis. ((52.8 - TS%) x (FGA + (FTA x 0.44))) / (Min/40) .
offensive_usage_rate numeric the number of possessions a player uses per 40 minutes. Usage Rate = ((FGA + (FT Att. x 0.44) + (Ast x 0.33) + TO) x 40 x League Pace) divided by (Minutes x Team Pace).
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
offensive_avg48field_goals_made numeric The average number of fieldgoals made per 48 minutes.
offensive_avg48field_goals_attempted numeric The average number of fieldgoals attempted per 48 minutes.
offensive_avg48three_point_field_goals_made numeric The average per number of 3-Pointers made per 48 minutes.
offensive_avg48three_point_field_goals_attempted numeric The average number of 3-pointers attempted per 48 minutes.
offensive_avg48free_throws_made numeric The average number of Free Throws made per 48 minutes.
offensive_avg48free_throws_attempted numeric The average number of free throws attempted per 48 minutes.
offensive_avg48points numeric The average number of points scored per 48 minutes.
offensive_avg48offensive_rebounds numeric The average number of offenseive rebounds per 48 minutes.
offensive_avg48assists numeric The average number of assists per 48 minutes.
offensive_avg48turnovers numeric The average number of turnovers per 48 minutes.
offensive_p40 numeric Points Per 40 Minutes.
offensive_a40 numeric Assists Per 40 Minutes.
offensive_orpm numeric Offensive Real Plus-Minus.
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
logos_href_2 character Logos href 2.
logos_href_3 character Logos href 3.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_player_stats(athlete_id = 1966, year = 2022))

Get ESPN NBA Athlete Stats

Description

Get ESPN NBA Athlete Stats

Get ESPN NBA Athlete Stats

Usage

espn_nba_player_stats_v3(athlete_id, season = most_recent_nba_season(), ...)

Arguments

athlete_id

ESPN athlete identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A named list of per-category tibbles. Default category names are General, Offensive, Defensive, Rebounding, Shooting, Misc. Actual names are driven by the ESPN response; additional categories may appear. Each tibble has columns depending on the category returned by ESPN.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_player_stats_v3(athlete_id = "1966", season = 2024)

Get ESPN NBA Position Detail

Description

Returns metadata for a single NBA position. Useful for dereferencing position ⁠$ref⁠ URLs embedded in athlete records, and for navigating parent/leaf relationships in the position taxonomy.

Usage

espn_nba_position(position_id, ...)

Arguments

position_id

ESPN position identifier (character or numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_position(position_id = 1)

Get ESPN NBA Positions Index

Description

Returns the NBA position dictionary index. One row per position with its id and the canonical ⁠$ref⁠ URL — pass an id to espn_nba_position() for full details (display name, abbreviation, leaf flag, parent link).

Usage

espn_nba_positions(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per position.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_positions()

Get ESPN NBA Season Power Index (Long Format)

Description

Returns ESPN's Basketball Power Index (BPI) and related per-team metrics for one NBA season, in long format: one row per (team x stat). Auto-paginates through all teams. Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/powerindex.

Usage

espn_nba_powerindex(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.
season_type

Integer (1=preseason, 2=regular (default), 3=postseason).
...

Additional arguments; currently unused.

Value

A long tibble with one row per (team x stat).

col_name types description
league character League slug ("nba").
season integer Season year.
season_type integer 1=preseason, 2=regular, 3=postseason.
team_id character ESPN team id (parsed from team_ref).
stat_name character Internal stat key (e.g. "bpi").
abbreviation character Short stat abbreviation.
display_name character Human-readable stat name.
description character Stat description.
value numeric Stat value.
display_value character Display-formatted value.
last_updated character Last-updated timestamp.
team_ref character ⁠$ref⁠ to the team-in-season resource.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_powerindex(season = 2025)

Get ESPN NBA schedule for a specific year

Description

Get ESPN NBA schedule for a specific year

Usage

espn_nba_scoreboard(season)

Arguments

season

Either numeric or character (YYYYMMDD)

Value

Returns a tibble with scoreboard data

col_name types description
matchup character Matchup.
matchup_short character Matchup short.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_slug character Season slug.
game_id integer Unique game identifier.
game_uid character Game uid.
game_date Date Game date (YYYY-MM-DD).
attendance integer Reported attendance.
notes logical Free-form notes attached to the record.
status_name character Status label.
broadcasts logical JSON array of broadcast records.
start_date character Start date (YYYY-MM-DD).
geo_broadcasts logical Geo broadcasts.
game_date_time POSIXct Game start date/time (ISO 8601).
home_team_name character Home team name.
home_team_logo character Home team logo URL.
home_team_abb character Home team's team abb.
home_team_id integer Unique identifier for the home team.
home_team_location character Home team's team location.
home_team_full_name character Full home team name (e.g. 'Las Vegas Aces').
home_team_color character Home team primary color (hex).
home_score integer Home team score at the time of the play.
home_win integer Home team's win.
home_record character Home win-loss record.
away_team_name character Away team name.
away_team_logo character Away team logo URL.
away_team_abb character Away team's team abb.
away_team_id integer Unique identifier for the away team.
away_team_location character Away team's team location.
away_team_full_name character Full away team name (e.g. 'Las Vegas Aces').
away_team_color character Away team primary color (hex).
away_score integer Away team score at the time of the play.
away_win integer Away team's win.
away_record character Away win-loss record.

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

# Get schedule from date 2022-11-17 (returns 1000 results, max allowable.)

try(espn_nba_scoreboard(season = 20230423))

Get ESPN NBA Season Awards Index

Description

Returns the list of award IDs given out in an NBA season from sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/awards. The index only contains IDs and ⁠$ref⁠ URLs — pass an ID to espn_nba_award() for the award name, description, and winners.

Usage

espn_nba_season_awards(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A tibble with one row per award.

col_name types description
season integer Season year.
award_id character ESPN award identifier.
ref character Full ⁠$ref⁠ URL for the award detail.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_awards(season = 2024)

Get ESPN NBA Season Draft (Top-Level Metadata)

Description

Returns a single-row tibble with top-level draft-year metadata: year, number of rounds, display name, plus ⁠$ref⁠s for the deeper sub-resources (status, athletes, rounds) already wrapped by espn_nba_draft_status(), espn_nba_draft_athletes(), and espn_nba_draft_rounds().

Usage

espn_nba_season_draft(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_draft(season = 2024)

Get ESPN NBA Season Group Detail

Description

Returns metadata for one group (conference or division) in one (NBA season x season-type), plus ⁠$ref⁠ URLs to its parent group, children groups, member teams, and standings.

Usage

espn_nba_season_group(
  group_id,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Group Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
uid character ESPN UID string.
name character Full name (e.g. "Eastern Conference").
abbreviation character Short code (e.g. "EAST").
short_name character Short name.
midsize_name character Mid-size display name.
is_conference logical Whether this group is a conference.
slug character URL slug.
parent_ref character ⁠$ref⁠ to parent group (if any).
children_ref character ⁠$ref⁠ to child-groups endpoint.
teams_ref character ⁠$ref⁠ to teams-in-group endpoint.
standings_ref character ⁠$ref⁠ to standings endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_group(group_id = 5, season = 2025)

Get ESPN NBA Season Group Children Index

Description

Returns the list of child groups (e.g. divisions within a conference) for one (NBA season x season-type x parent-group).

Usage

espn_nba_season_group_children(
  group_id,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

Parent group identifier.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Group Children Index

Value

A tibble with one row per child group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
parent_group_id character Parent group id (queried).
child_group_id character Child group id.
ref character ⁠$ref⁠ to child group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_group_children(group_id = 5, season = 2025)

Get ESPN NBA Season Group Teams Index

Description

Returns the list of team IDs that belong to one group (conference or division) for one (NBA season x season-type).

Usage

espn_nba_season_group_teams(
  group_id,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

group_id

ESPN group identifier.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Group Teams Index

Value

A tibble with one row per team in the group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
team_id character ESPN team id.
ref character ⁠$ref⁠ URL to the team-in-season entry.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_group_teams(group_id = 5, season = 2025)

Get ESPN NBA Season Groups Index

Description

Returns the list of group IDs (conferences / divisions) for one (NBA season x season-type) via core-v2 ⁠/seasons/{season}/types/{season_type}/groups⁠.

Usage

espn_nba_season_groups(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Value

A tibble with one row per group.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
group_id character ESPN group id.
ref character ⁠$ref⁠ URL for the group detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_groups(season = 2025)

Get ESPN NBA Season Info

Description

Get ESPN NBA Season Info

Get ESPN NBA Season Info

Usage

espn_nba_season_info(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of hoopR_data tibbles: Info, Types, Athletes, Coaches, Teams, Awards. ⁠$ref⁠ URL components are returned as character columns and are NOT auto-resolved – use targeted endpoint functions for details.

Info

col_name types description
year integer 4-digit year.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
type_id character Type identifier (numeric).
type_name character

Types / Athletes / Coaches / Teams / Awards

col_name types description
count integer Count of count.
ref character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_info(season = 2025)

Get ESPN NBA Season Leaders (Long Format)

Description

Returns the per-category leaderboard for one (NBA season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".

Usage

espn_nba_season_leaders(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default), 3 = postseason).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Leaders (Long Format)

Value

A long tibble with one row per (category x leader).

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
category_name character Internal category key (e.g. "pointsPerGame").
category_display character Human-readable category name.
category_short character Short display name.
category_abbrev character Stat abbreviation (e.g. "PTS").
rank integer Rank within the category (1 = best).
athlete_id character ESPN athlete id.
team_id character ESPN team id.
display_value character Display-formatted value.
value numeric Numeric leader value.
rel character Comma-joined rel tags from ESPN.
athlete_ref character ⁠$ref⁠ URL to the leader's athlete.
team_ref character ⁠$ref⁠ URL to the leader's team.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_leaders(season = 2025)

Get ESPN NBA Season Ranking Detail

Description

Returns the per-week snapshot index for one ranking source (e.g. AP Top 25). Each row is one weekly snapshot; the ref URL resolves to the actual ranked teams for that (season-type x week) and will be wrapped by a forthcoming espn_nba_week_ranking().

Usage

espn_nba_season_ranking(ranking_id, season = most_recent_nba_season(), ...)

Arguments

ranking_id

ESPN ranking identifier (character or numeric).
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Ranking Detail

Value

A tibble with one row per weekly snapshot.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
name character Ranking name (e.g. "AP Top 25").
short_name character Short name (e.g. "AP Poll").
type character Ranking type code (e.g. "ap").
season_type integer Season-type id of this snapshot.
week integer Week number of this snapshot.
ref character ⁠$ref⁠ URL for the per-week ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_ranking(ranking_id = 1, season = 2025)

Get ESPN NBA Season Rankings Index

Description

Returns the index of season-level rankings recorded for one NBA season. NBA + WNBA typically return zero rankings (ranking polls are a college concept); the wrapper is provided for symmetry across leagues. For MBB / WBB use the matching espn_mbb_season_rankings() / espn_wbb_season_rankings().

Usage

espn_nba_season_rankings(season = most_recent_nba_season(), ...)

Arguments

season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranking detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_rankings(season = 2025)

Get ESPN NBA Season-Type Detail

Description

Returns metadata for one season-type within an NBA season: name, abbreviation, start / end dates, and whether it carries groups, standings, or playoff legs.

Usage

espn_nba_season_type(season_type = 2L, season = most_recent_nba_season(), ...)

Arguments

season_type

Season-type id (1 = preseason, 2 = regular (default), 3 = postseason, 4 = off-season).
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season-Type Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
type integer Numeric type code.
name character Display name (e.g. "Regular Season").
abbreviation character Short code (e.g. "reg").
year integer Year stamp.
start_date character ISO 8601 start date.
end_date character ISO 8601 end date.
has_groups logical Whether groups exist for this type.
has_standings logical Whether standings exist.
has_legs logical Whether playoff legs exist.
slug character URL slug.
groups_ref character ⁠$ref⁠ to the groups endpoint.
weeks_ref character ⁠$ref⁠ to the weeks endpoint.
leaders_ref character ⁠$ref⁠ to the leaders endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_type(season_type = 2, season = 2025)

Get ESPN NBA Season Types Index

Description

Returns the index of season-type IDs that exist for one NBA season (typically 1 = preseason, 2 = regular, 3 = postseason, 4 = off-season). Pass an ID to espn_nba_season_type() for the start/end dates and whether that type carries groups, standings, or legs.

Usage

espn_nba_season_types(season = most_recent_nba_season(), ...)

Arguments

season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A tibble with one row per season type.

col_name types description
league character League slug ("nba").
season integer Season year.
season_type integer Season-type id (1/2/3/4).
ref character ⁠$ref⁠ URL for the type detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_types(season = 2025)

Get ESPN NBA Season-Week Detail

Description

Returns metadata for one week (number, start / end dates, text label, and ⁠$ref⁠ to the per-week rankings endpoint).

Usage

espn_nba_season_week(
  week,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Season-Week Detail

Value

A single-row tibble.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
text character Display label (e.g. "Week 5").
start_date character ISO 8601 week start.
end_date character ISO 8601 week end.
rankings_ref character ⁠$ref⁠ to the per-week rankings endpoint.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_week(week = 5, season = 2025)

Get ESPN NBA Season Weeks Index

Description

Returns the list of week IDs for one (NBA season x season-type). NBA uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).

Usage

espn_nba_season_weeks(
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default), 3 = postseason).
...

Additional arguments; currently unused.

Value

A tibble with one row per week.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number (1-based).
ref character ⁠$ref⁠ URL for the week detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_season_weeks(season = 2025)

Get ESPN NBA Seasons

Description

Get ESPN NBA Seasons

Get ESPN NBA Seasons

Usage

espn_nba_seasons(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per season.

col_name types description
season integer Season identifier (4-digit year or 'YYYY-YY' string).
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).
display_name character Display name.
season_type_count integer

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_seasons()

Get ESPN NBA's Standings

Description

Get ESPN NBA's Standings

Usage

espn_nba_standings(year)

Arguments

year

Either numeric or character (YYYY)

Value

A standings data frame

col_name types description
team_id integer Unique team identifier.
team character Team-side label or team identifier.
avgpointsagainst numeric Avgpointsagainst.
avgpointsfor numeric Avgpointsfor.
clincher numeric Clincher.
differential numeric Differential.
divisionwinpercent numeric Divisionwinpercent.
gamesbehind numeric Gamesbehind.
leaguewinpercent numeric Leaguewinpercent.
losses numeric Total losses.
playoffseed numeric Playoffseed.
streak numeric Current streak (e.g. 'W3' for three-game win streak).
winpercent numeric Winpercent.
wins numeric Total wins.
leaguestandings character Leaguestandings.
home character Home.
road character Road.
vsdiv character Vsdiv.
vsconf character Vsconf.
lasttengames character Lasttengames.

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_standings(year = 2021))

Get ESPN NBA Team Detail

Description

Get ESPN NBA Team Detail

Get ESPN NBA Team Detail

Usage

espn_nba_team(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A named list of data frames: Info, Record, NextEvent, StandingSummary, Coaches.

Info

col_name types description
id character Id.
uid character ESPN UID string (universal identifier).
slug character URL-safe identifier.
abbreviation character Short abbreviation.
display_name character Display name.
short_display_name character Short display name.
name character Display name.
nickname character Team or athlete nickname.
location character Location.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.

Record

col_name types description
type character Record type / category.
summary character
stats list

NextEvent

col_name types description
id character Id.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.

StandingSummary

col_name types description
standing_summary character

Coaches

col_name types description
id character Id.
first_name character Player's first name.
last_name character Player's last name.
experience integer Years of professional experience.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team(team_id = "13", season = 2025)

Get ESPN NBA team box scores

Description

Get ESPN NBA team box scores

Usage

espn_nba_team_box(game_id)

Arguments

game_id

Game ID

Value

A team boxscore data frame

Team

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
team_home_away character Team home away.
team_score integer Team's score / final score.
team_winner logical TRUE if the team won this game.
assists integer Total assists.
blocks integer Total blocks.
defensive_rebounds integer Defensive rebounds.
fast_break_points character Fast-break points scored.
field_goal_pct numeric Field goal percentage (0-1).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
flagrant_fouls integer Total flagrant fouls.
fouls integer Personal fouls.
free_throw_pct numeric Free throw percentage (0-1).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
largest_lead character Largest lead during the game.
offensive_rebounds integer Offensive rebounds.
points_in_paint character Points scored in the paint.
steals integer Total steals.
team_turnovers integer Team turnovers (turnovers credited to the team rather than a player).
technical_fouls integer Total technical fouls.
three_point_field_goal_pct numeric Three-point field goal percentage (0-1).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
total_rebounds integer Total rebounds.
total_technical_fouls integer Total technical fouls (player + team).
total_turnovers integer Total turnovers (player + team).
turnover_points character Turnover points.
turnovers integer Total turnovers.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_uid character Opponent team uid.
opponent_team_slug character Opponent team slug.
opponent_team_location character Opponent team city / location.
opponent_team_name character Opponent team display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_display_name character Opponent team full display name.
opponent_team_short_display_name character Opponent team short display name.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_logo character Opponent team logo URL.
opponent_team_score integer Opponent team's score.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_team_box(game_id = 401071880))

Get ESPN NBA current team roster

Description

Get ESPN NBA current team roster

Usage

espn_nba_team_current_roster(team_id)

Arguments

team_id

Either numeric or character (YYYY)

Value

A teams data frame

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_team_current_roster(team_id = 13))

Get ESPN NBA Team Depth Chart (Long Format)

Description

Returns the team's depth chart in long format, one row per (position × rank × athlete). NBA-only at ESPN's core-v2.

Usage

espn_nba_team_depthchart(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Team Depth Chart (Long Format)

Value

A long tibble with one row per athlete depth entry.

col_name types description
league character League slug.
team_id character ESPN team id.
season integer Season year.
depthchart_id character Depth chart id (typically "1").
depthchart_name character Depth chart name.
position character Position code (pg/sg/sf/pf/c).
rank integer Depth rank (1 = starter).
athlete_id character ESPN athlete id.
athlete_ref character ⁠$ref⁠ URL to athlete-in-season.
position_ref character ⁠$ref⁠ URL to position resource.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_depthchart(team_id = 13, season = 2025)

Get ESPN NBA Team Injuries

Description

Get ESPN NBA Team Injuries

Get ESPN NBA Team Injuries

Usage

espn_nba_team_injuries(team_id, ...)

Arguments

team_id

ESPN team identifier (character or numeric; passed as-is). Use espn_nba_teams() to look up team IDs. Example: "17" (Las Vegas Aces).
...

Currently unused; reserved for future argument threading.

Value

Returns a tibble of injury records for the specified NBA team. Returns an empty tibble (zero rows) when the team has no reported injuries.

Injuries

col_name types description
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
position character Listed roster position (G, F, C, etc.).
status character Status label.
date character Date in YYYY-MM-DD format.
type character Record type / category.
side character Side label (e.g. 'home', 'away', or 'overUnder').
returns_at character
short_comment character
long_comment character Long-form play / event comment.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_injuries(team_id = "13")

Get ESPN NBA Team Leaders

Description

Get ESPN NBA Team Leaders

Get ESPN NBA Team Leaders

Usage

espn_nba_team_leaders(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single long-format tibble (one row per category-rank-athlete).

col_name types description
team_id character Unique team identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
category character Category label.
display_name character Display name.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
value numeric Numeric or string value field.
rank integer Rank.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_leaders(team_id = "13", season = 2025)

Get ESPN NBA Team News

Description

Get ESPN NBA Team News

Get ESPN NBA Team News

Usage

espn_nba_team_news(team_id, limit = 25)

Arguments

team_id

character or integer. ESPN team ID (e.g. 17 for Las Vegas Aces).
limit

integer. Maximum number of articles to return. Default 25.

Details

Retrieve ESPN NBA news for a specific team. Uses getOption("hoopR.proxy") or http_proxy/https_proxy environment variables for proxy configuration (per-call proxy override is not supported for ESPN wrappers).

Value

Returns a tibble of team news articles.

col_name types description
id character Id.
type character Record type / category.
headline character News headline.
description character Long-form description text.
published character Publication timestamp (ISO 8601).
premium logical
byline character News article byline / author.
link_web character Web link / URL.
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_news(team_id = "13", limit = 5)

Get ESPN NBA Team Odds-Records (Long Format)

Description

Returns the long-format odds-records breakdown for a team in one season. Each row is one (category × stat) — typical categories include Money Line Overall, Money Line Home, Money Line Road, Against The Spread Overall, Over/Under, etc. ESPN's coverage of this endpoint is sparse; many (team × season-type) combinations return 404, in which case the wrapper returns an empty tibble.

Usage

espn_nba_team_odds_records(
  team_id,
  season = most_recent_nba_season(),
  season_type = 0L,
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id. ESPN populates odds-records mostly under season_type = 0 (all-types aggregate), so that is the default.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category × stat).

col_name types description
league character League slug.
team_id character ESPN team identifier.
season integer Season year.
season_type integer Season-type id.
category_type character Category type code (e.g. "moneyLineOverall").
category_abbrev character Category abbreviation (e.g. "ML").
category_short character Short display.
category_display character Full category name.
stat_type character Stat type code (e.g. "win", "loss").
stat_abbrev character Stat abbreviation (e.g. "W", "L").
stat_display character Stat display name.
value numeric Numeric stat value.
display_value character Display-formatted value.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_odds_records(team_id = 13, season = 2026)

Get ESPN NBA Team Record (Per Season Type)

Description

Returns the long-format record breakdown for an NBA team in one season and season-type. Each row is one record type (Overall, Home, Road, vs Conference, vs Division, etc.). Backed by sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/types/{season_type}/teams/{team_id}/record.

Usage

espn_nba_team_record(
  team_id,
  season = most_recent_nba_season(),
  season_type = c(2L, 3L),
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year (numeric). Defaults to most recent NBA season.
season_type

Integer (2 = regular season default; 3 = postseason).
...

Additional arguments; currently unused.

Value

A tibble with one row per record category.

col_name types description
league character League slug ("nba").
team_id character ESPN team identifier.
season integer Season year.
season_type integer Season type (1/2/3).
record_id character Record sub-id.
name character Internal record name (e.g. "overall").
abbreviation character Abbreviation (e.g. "Total").
display_name character Display name (e.g. "Overall").
short_display_name character Short display (e.g. "OVER").
description character Description (e.g. "Overall Record").
type character Record type code (total, home, ...).
summary character W-L summary (e.g. "50-32").
display_value character Same as summary in most cases.
value numeric Win percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_record(team_id = 13, season = 2025)

Get ESPN NBA Team Record Detail (Long Format)

Description

Returns one team's record detail in long format: one row per stat in the record's stats[] array. Use espn_nba_team_record() to enumerate available record_id values per team-season (overall / home / away / conference + per-opponent breakdowns).

Usage

espn_nba_team_record_detail(team_id, season, record_id, season_type = 2L, ...)

Arguments

team_id

ESPN team identifier.
season

Season year (numeric).
record_id

Record identifier (from espn_nba_team_record() index).
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A long tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_record_detail(team_id = 13, season = 2024, record_id = 0)

Get ESPN NBA Team Roster

Description

Get ESPN NBA Team Roster

Get ESPN NBA Team Roster

Usage

espn_nba_team_roster(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single tibble with one row per athlete.

col_name types description
athlete_id character Unique athlete identifier (ESPN).
full_name character Player's full name.
jersey character Jersey number worn by the player.
position_abbrev character
position_name character Listed roster position ('Guard', 'Forward', 'Center').
height character Player height (string e.g. '6-2' or inches).
weight character Player weight in pounds.
age character Player age (in years).
birth_date character Date of birth (YYYY-MM-DD).
birth_place character Place of birth.
headshot character Headshot image URL.
link_web character Web link / URL.
status character Status label.
team_id character Unique team identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_roster(team_id = "13", season = 2025)

Get ESPN NBA Team Schedule

Description

Get ESPN NBA Team Schedule

Get ESPN NBA Team Schedule

Usage

espn_nba_team_schedule(
  team_id,
  season = most_recent_nba_season(),
  season_type = 2,
  ...
)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A single tibble with one row per event.

col_name types description
event_id character Unique event / game identifier (ESPN).
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
week integer Week number within the season.
date character Date in YYYY-MM-DD format.
name character Display name.
short_name character Short display name.
opponent_id character Unique identifier for opponent.
opponent_abbrev character Abbreviation for opponent.
home_away character Game venue label ('home' or 'away').
neutral_site logical Neutral site.
conference_competition logical Conference competition.
venue_id character Unique venue identifier.
venue_name character Venue name.
venue_city character Venue city.
venue_state character Venue state / region.
broadcast character Broadcast information string.
result character Result.
team_score character Team's score / final score.
opponent_score character Opponent score.
winner logical Winner.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_schedule(team_id = "13", season = 2025)

Get ESPN NBA Team-in-Season Profile

Description

Era-correct team identity for an NBA franchise in a specific season, plus the available ⁠$ref⁠ URLs for deeper resources (record, statistics, leaders, coaches, etc.). Backed by the core-v2 endpoint sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{season}/teams/{team_id}.

Historical depth goes back to 1947 (NBA founding). Older seasons return fewer ⁠$ref⁠ keys; missing refs become NA.

Usage

espn_nba_team_season_profile(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).
season

Season year (numeric). Defaults to the most recent NBA season.
...

Additional arguments; currently unused.

Value

A single-row tibble with team identity scalars and ⁠_ref⁠ URL columns. Selected columns:

col_name types description
id character ESPN team identifier.
guid character Stable cross-league team GUID.
uid character ESPN UID string.
slug character URL-safe identifier.
location character Team city/region (e.g. "Los Angeles").
name character Team name (e.g. "Lakers").
abbreviation character Short abbreviation (e.g. "LAL").
display_name character Full display name.
short_display_name character Short display name.
color character Primary color (hex, no leading '#').
alternate_color character Alternate color (hex, no leading '#').
is_active logical Whether the team was active in this season.
season integer Season year.
logo character Primary logo URL.
logo_dark character Dark-mode logo URL.
record_ref character ⁠$ref⁠ to team record resource (if present).
statistics_ref character ⁠$ref⁠ to team statistics resource (if present).
leaders_ref character ⁠$ref⁠ to team leaders resource (if present).
coaches_ref character ⁠$ref⁠ to team coaches resource (if present).
depth_charts_ref character ⁠$ref⁠ to depth chart resource (NBA-only).
events_ref character ⁠$ref⁠ to team events resource (if present).
transactions_ref character ⁠$ref⁠ to team transactions resource (if present).
franchise_ref character ⁠$ref⁠ to franchise resource.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_season_profile(team_id = "13", season = 2025)

Get ESPN NBA Team Roster (Per-Season, core-v2)

Description

Returns the per-season team roster as a tibble of athlete IDs from seasons/{y}/teams/{id}/athletes. Distinct from espn_nba_team_roster() which targets a site-v2 endpoint optimized for the current season; this core-v2 variant is era-correct and available back to ESPN's earliest season for each league.

Usage

espn_nba_team_season_roster(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier.
season

Season year. Defaults to most recent NBA season.
...

Additional arguments; currently unused.

Details

Get ESPN NBA Team Roster (Per-Season, core-v2)

Value

A tibble with one row per athlete on the season roster.

col_name types description
league character League slug.
team_id character ESPN team id.
season integer Season year.
athlete_id character ESPN athlete id.
ref character ⁠$ref⁠ URL to athlete-in-season detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_season_roster(team_id = 13, season = 2025)

Get ESPN NBA Team Season Statistics (Long Format with Rank)

Description

Returns the full team-season-type statistics sheet for one NBA team in long format: one row per (category x stat). Each row carries the team's league rank for that stat where ESPN provides it (rank + rank_display_value). Complements espn_nba_team_record() (W-L only) with the full stat package.

Usage

espn_nba_team_season_statistics(
  team_id,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

team_id

ESPN team identifier.
season

Season year (numeric). Defaults to the most recent NBA season.
season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.
...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_team_season_statistics(team_id = 13, season = 2024)

Get ESPN NBA team stats data

Description

Get ESPN NBA team stats data

Usage

espn_nba_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID
year

Year
season_type

(character, default: regular): Season type - regular or postseason
total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the team stats data

col_name types description
team_id integer Unique team identifier.
team_guid character ESPN team GUID.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_is_active logical TRUE if the team is currently active.
team_is_all_star logical TRUE if the row represents an All-Star team.
logo_href character Team or league logo URL.
logo_dark_href character Logo URL for dark backgrounds.
logos_href_2 character Logos href 2.
logos_href_3 character Logos href 3.
defensive_blocks numeric Short for blocked shot, number of times when a defensive player legally deflects a field goal attempt from an offensive player.
defensive_defensive_rebounds numeric The number of times when the defense obtains the possession of the ball after a missed shot by the offense.
defensive_steals numeric The number of times a defensive player forced a turnover by intercepting or deflecting a pass or a dribble of an offensive player.
defensive_turnover_points numeric The amount of points resulting from the possession following a turnover.
defensive_def_rebound_rate numeric The percentage of missed shots that a team rebounds defensively. Rebound Rate = (Defensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Defensive Rebounds + Opponent Defensive Rebounds)).
defensive_avg_defensive_rebounds numeric The average defensive rebounds per game.
defensive_avg_blocks numeric The average blocks per game.
defensive_avg_steals numeric The average steals per game.
defensive_avg48defensive_rebounds numeric The average number of defensive rebounds per 48 minutes.
defensive_avg48blocks numeric The average number of blocks per 48 minutes.
defensive_avg48steals numeric The average number of steals per 48 minutes.
general_disqualifications numeric The number of times a player reached the foul limit.
general_flagrant_fouls numeric The number of fouls that the officials thought were unnecessary or excessive.
general_fouls numeric The number of times a player had illegal contact with the opponent.
general_rebound_rate numeric The percentage of missed shots that a team rebounds. Rebound Rate = (Rebounds x Team Minutes) divided by (Player Minutes x (Team Rebounds + Opponent Rebounds)).
general_ejections numeric The number of times a player or coach is removed from the game as a result of a serious offense.
general_technical_fouls numeric The number of times an player or coach was called for a technical foul (unsportsmanlike conduct or violations).
general_rebounds numeric The total number of rebounds (offensive and defensive).
general_minutes numeric The total number of minutes played.
general_avg_minutes numeric The average number of minutes per game.
general_fantasy_rating numeric The Fantasy Rating of a player.
general_nba_rating numeric General nba rating.
general_plus_minus numeric A player's estimated on-court impact on team performance measured in point differential per 100 possessions.
general_avg_rebounds numeric The average rebounds per game.
general_avg_fouls numeric The average fouls committed per game.
general_avg_flagrant_fouls numeric The average number of flagrant fouls per game.
general_avg_technical_fouls numeric The average number of technical fouls per game.
general_avg_ejections numeric The average ejections per game.
general_avg_disqualifications numeric The average number of disqualifications per game.
general_assist_turnover_ratio numeric The average number of assists a player or team records per turnover.
general_steal_foul_ratio numeric The average number of steals a player or team records per foul committed.
general_block_foul_ratio numeric The average number of blocks a player or record per foul committed.
general_avg_team_rebounds numeric The average number of rebounds for a team per game.
general_total_rebounds numeric The total number of rebounds for a team or player.
general_total_technical_fouls numeric The total number of technical fouls for a team or player.
general_team_assist_turnover_ratio numeric The number of assists per turnover for a team.
general_team_rebounds numeric The total number of rebounds for a team.
general_steal_turnover_ratio numeric The number of steals per turnover.
general_avg48rebounds numeric The average number of rebounds per 48 minutes.
general_avg48fouls numeric The average number of fouls committed per 48 minutes.
general_avg48flagrant_fouls numeric The average number of flagrant fouls committed per 48 minutes.
general_avg48technical_fouls numeric The average number of technical fouls committed per 48 minutes.
general_avg48ejections numeric The average number of ejections per 48 minutes.
general_avg48disqualifications numeric The average number of disqualifications per 48 minutes.
general_r40 numeric Rebounds Per 40 Minutes.
general_games_played numeric Games Played.
general_games_started numeric The number of games started by an athlete.
general_double_double numeric The number of times double digit values were accumulated in 2 of the following categories: points, rebounds, assists, steals, and blocked shots.
general_triple_double numeric The number of times double digit values were accumulated in 3 of the following categories: points, rebounds, assists, steals, and blocked shots.
offensive_assists numeric The number of times a player who passes the ball to a teammate in a way that leads to a score by field goal, meaning that he or she was "assisting" in the basket. There is some judgment involved in deciding whether a passer should be credited with an assist.
offensive_effective_fg_pct numeric Offensive effective field goals percentage (0-1 decimal).
offensive_field_goals numeric Field Goal makes and attempts.
offensive_field_goals_attempted numeric The number of times a 2pt field goal was attempted.
offensive_field_goals_made numeric The number of times a 2pt field goal was made.
offensive_field_goal_pct numeric The ratio of field goals made to field goals attempted: FGM / FGA.
offensive_free_throws numeric Free Throw makes and attempts.
offensive_free_throw_pct numeric The ratio of free throws made to free throws attempted: FTM / FTA.
offensive_free_throws_attempted numeric The number of times a free throw was attempted.
offensive_free_throws_made numeric The number of times a free throw was made.
offensive_offensive_rebounds numeric The number of times when the offense obtains the possession of the ball after a missed shot.
offensive_points numeric The number of points scored.
offensive_turnovers numeric The number of times a player loses possession to the other team.
offensive_three_point_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_three_point_field_goals_attempted numeric The number of times a 3pt field goal was attempted.
offensive_three_point_field_goals_made numeric The number of times a 3pt field goal was made.
offensive_true_shooting_pct numeric What a team's shooting percentage would be if we accounted for free throws and 3-pointers. True Shooting Percentage = (Total points x 50) divided by ((FGA + (FTA x 0.44)).
offensive_team_turnovers numeric The number of turnovers for the team.
offensive_total_turnovers numeric The number of turnovers plus team turnovers for the team.
offensive_assist_ratio numeric The percentage of a team's possessions that ends in an assist. Assist Ratio = (Assists x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_points_in_paint numeric The amount of points scored in the area known as "the Paint"(the rectangle between the foul line and the baseline).
offensive_off_rebound_rate numeric The percentage of missed shots that a team rebounds offensively. Offensive Rebound Rate = (Offensive Rebounds x Team Minutes) divided by (Player Minutes x (Team Offensive Rebounds + Opponent Defensive Rebounds)).
offensive_turnover_ratio numeric The percentage of a team's possessions that end in a turnover. Turnover Ratio = (Turnover x 100) divided by ((FGA + (FTA x 0.44) + Assists + Turnovers).
offensive_fast_break_points numeric The number of points scored on fast breaks.
offensive_possessions numeric The total number of possessions for a team or player.
offensive_pace_factor numeric The number of possessions a team uses per game.
offensive_avg_field_goals_made numeric The average field goals made per game.
offensive_avg_field_goals_attempted numeric The average field goals attempted per game.
offensive_avg_three_point_field_goals_made numeric The average three point field goals made per game.
offensive_avg_three_point_field_goals_attempted numeric The average three point field goals attempted per game.
offensive_avg_free_throws_made numeric The average free throw shots made per game.
offensive_avg_free_throws_attempted numeric The average free throw shots attempted per game.
offensive_avg_points numeric The average number of points scored per game.
offensive_avg_offensive_rebounds numeric The average offensive rebounds per game.
offensive_avg_assists numeric The average assists per game.
offensive_avg_turnovers numeric The average turnovers committed per game.
offensive_offensive_rebound_pct numeric The percentage of the number of times they obtain the possession of the ball after a missed shot.
offensive_estimated_possessions numeric An estimation of the number of possessions for a team or player.
offensive_avg_estimated_possessions numeric The average number of estimated possessions per game for a team or player.
offensive_points_per_estimated_possessions numeric The number of points per estimated possession for a team or player.
offensive_avg_team_turnovers numeric The average number of turnovers for a team per game.
offensive_avg_total_turnovers numeric The average number of total turnovers for a team per game.
offensive_three_point_field_goal_pct numeric The ratio of 3pt field goals made to 3pt field goals attempted: 3PM / 3PA.
offensive_two_point_field_goals_made numeric The number of 2-point field goals made for a team or player.
offensive_two_point_field_goals_attempted numeric The number of 2-point field goals attempted for a team or player.
offensive_avg_two_point_field_goals_made numeric The number of 2-point field goals made per game for a team or player.
offensive_avg_two_point_field_goals_attempted numeric The number of 2-point field goals attempted per game for a team or player.
offensive_two_point_field_goal_pct numeric The percentage of 2-points fields goals made by a team or player.
offensive_shooting_efficiency numeric The efficiency with which a team or player shoots the basketball.
offensive_scoring_efficiency numeric The efficiency with which a team or player scores the basketball.
offensive_avg48field_goals_made numeric The average number of fieldgoals made per 48 minutes.
offensive_avg48field_goals_attempted numeric The average number of fieldgoals attempted per 48 minutes.
offensive_avg48three_point_field_goals_made numeric The average per number of 3-Pointers made per 48 minutes.
offensive_avg48three_point_field_goals_attempted numeric The average number of 3-pointers attempted per 48 minutes.
offensive_avg48free_throws_made numeric The average number of Free Throws made per 48 minutes.
offensive_avg48free_throws_attempted numeric The average number of free throws attempted per 48 minutes.
offensive_avg48points numeric The average number of points scored per 48 minutes.
offensive_avg48offensive_rebounds numeric The average number of offenseive rebounds per 48 minutes.
offensive_avg48assists numeric The average number of assists per 48 minutes.
offensive_avg48turnovers numeric The average number of turnovers per 48 minutes.
offensive_p40 numeric Points Per 40 Minutes.
offensive_a40 numeric Assists Per 40 Minutes.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_team_stats(team_id = 13, year = 2020))

Get ESPN NBA team names and IDs

Description

Get ESPN NBA team names and IDs

Usage

espn_nba_teams()

Value

A teams data frame

col_name types description
team_id integer Unique team identifier.
abbreviation character Short abbreviation.
display_name character Display name.
short_name character Short display name.
mascot character Team mascot.
nickname character Team or athlete nickname.
team character Team-side label or team identifier.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.
logos_href_3 character Logos href 3.
logos_href_4 character Logos href 4.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

try(espn_nba_teams())

Get ESPN NBA Tournament Detail

Description

Returns metadata for a single tournament plus the ⁠$ref⁠ URL for the tournament's seasons list. Use espn_nba_tournament_seasons() to resolve the seasons.

Usage

espn_nba_tournament(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.
...

Additional arguments; currently unused.

Value

A single-row tibble.

col_name types description
tournament_id character ESPN tournament identifier.
display_name character Human-readable tournament name.
seasons_ref character ⁠$ref⁠ to the seasons-list endpoint.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_tournament(tournament_id = 1)

Get ESPN NBA Tournament Season Detail

Description

Returns single-row detail for one (tournament, season) pair: id, display name, number of rounds, and ⁠$ref⁠s to the season + bracketology resources. Use espn_nba_tournament_seasons() to enumerate valid (tournament_id, season) pairs.

Usage

espn_nba_tournament_season(tournament_id, season, ...)

Arguments

tournament_id

ESPN tournament identifier.
season

Season year (numeric).
...

Additional arguments; currently unused.

Value

A single-row tibble.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_tournament_season(tournament_id = 1, season = 2024)

Get ESPN NBA Tournament Seasons List

Description

Returns the seasons in which a given NBA tournament was held.

Usage

espn_nba_tournament_seasons(tournament_id, ...)

Arguments

tournament_id

ESPN tournament identifier.
...

Additional arguments; currently unused.

Value

A tibble with one row per season.

col_name types description
league character League slug ("nba").
tournament_id character ESPN tournament identifier.
season integer Season year.
ref character Full ⁠$ref⁠ URL for that season.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_tournament_seasons(tournament_id = 1)

Get ESPN NBA Tournaments Index

Description

Returns the index of NBA-branded tournaments tracked by ESPN (e.g. the in-season tournament). Each row is one tournament with its ID and the ⁠$ref⁠ URL.

Usage

espn_nba_tournaments(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per tournament.

col_name types description
tournament_id character ESPN tournament identifier.
ref character Full ⁠$ref⁠ URL for the detail.
league character League slug ("nba").

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_tournaments()

Get ESPN NBA Transactions

Description

Get ESPN NBA Transactions

Get ESPN NBA Transactions

Usage

espn_nba_transactions(season = most_recent_nba_season(), limit = 100, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.
limit

Maximum number of transactions to return (integer). Default 100.
...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).

Details

Calls the ESPN site-v2 endpoint ⁠https://site.api.espn.com/apis/site/v2/sports/basketball/nba/transactions?season={year}&limit={limit}⁠. Releases have a NULL to_team_id; those are stored as NA. Returns an empty tibble rather than erroring when no transactions are available.

Value

A hoopR_data tibble with one row per transaction:

col_name types description
transaction_id character
date character Date in YYYY-MM-DD format.
type character Record type / category.
description character Long-form description text.
team_id character Unique team identifier.
athlete_id character Unique athlete identifier (ESPN).
athlete_name character Athlete display name (ESPN).
from_team_id character
to_team_id character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_transactions(season = 2025, limit = 10)

Get ESPN NBA Venues

Description

Get ESPN NBA Venues

Get ESPN NBA Venues

Usage

espn_nba_venues(...)

Arguments

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per venue.

col_name types description
venue_id character Unique venue identifier.
name character Display name.
full_name character Player's full name.
address_city character
address_state character
capacity integer
indoor logical
grass logical
images_url character

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_venues()

Get ESPN NBA Per-Week Ranking Detail

Description

Returns the long-format ranked teams for one (season x season-type x week x ranking-source). NBA typically returns an empty tibble.

Usage

espn_nba_week_ranking(
  ranking_id,
  week,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

ranking_id

Ranking source id (1 = AP, 2 = Coaches, etc.).
week

Week number.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Per-Week Ranking Detail

Value

A tibble with one row per ranked team (typically 25).

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
name character Ranking name (e.g. "AP Top 25").
short_name character Short name.
type character Ranking type code.
headline character Full headline.
date character Date of the ranking.
current integer Current rank.
previous integer Previous-week rank.
points numeric Voting points.
first_place_votes integer First-place vote count.
trend character Trend indicator (e.g. "+3", "-2", "-").
record_summary character Team's record at time of poll (e.g. "20-2").
team_id character ESPN team id.
team_ref character ⁠$ref⁠ to the team-in-season resource.
last_updated character Last-updated timestamp.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_rankings(), espn_nba_wp()

Examples

espn_nba_week_ranking(ranking_id = 1, week = 5, season = 2025)

Get ESPN NBA Per-Week Rankings Index

Description

Returns the index of ranking sources available for one (NBA season x season-type x week). NBA does not publish weekly rankings, so this typically returns an empty tibble; the wrapper is provided for symmetry with college (MBB / WBB).

Usage

espn_nba_week_rankings(
  week,
  season = most_recent_nba_season(),
  season_type = 2L,
  ...
)

Arguments

week

Week number.
season

Season year. Defaults to most recent NBA season.
season_type

Season-type id (2 = regular (default)).
...

Additional arguments; currently unused.

Details

Get ESPN NBA Per-Week Rankings Index

Value

A tibble with one row per ranking source.

col_name types description
league character League slug.
season integer Season year.
season_type integer Season-type id.
week integer Week number.
ranking_id character ESPN ranking id.
ref character ⁠$ref⁠ URL for the ranked-teams detail.

Author(s)

Saiem Gilani

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_wp()

Examples

espn_nba_week_rankings(week = 5, season = 2025)

Get NBA win probability chart data from ESPN

Description

Get NBA win probability chart data from ESPN

Usage

espn_nba_wp(game_id)

Arguments

game_id

(Integer required): Game ID filter for querying a single game

Value

espn_nba_wp() - A data frame with 21 variables:

col_name types description
game_id numeric Unique game identifier.
play_id character Unique play identifier within a game.
home_win_percentage numeric Home win percentage (0-1 decimal).
away_win_percentage numeric Away win percentage (0-1 decimal).
tie_percentage numeric Tie percentage (0-1 decimal).
sequence_number character Sequence number representing a shot-possession (V3 PBP).
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
participants list Participants.
shooting_play logical TRUE if the play was a shooting attempt.
type_id character Type identifier (numeric).
type_text character Display text for the type field.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
team_id character Unique team identifier.
coordinate_x integer X coordinate on the court (half-court layout).
coordinate_y integer Y coordinate on the court (half-court layout).

See Also

Other ESPN NBA Functions: espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings()

Examples

espn_nba_wp(game_id = 401283399)

Parse ESPN MBB PBP, helper function

Description

Parse ESPN MBB PBP, helper function

Usage

helper_espn_mbb_pbp(resp)

Arguments

resp

Response object from the ESPN MBB game summary endpoint

Value

Returns a tibble

Parse ESPN MBB Player Box, helper function

Description

Parse ESPN MBB Player Box, helper function

Usage

helper_espn_mbb_player_box(resp)

Arguments

resp

Response object from the ESPN MBB game summary endpoint

Value

Returns a tibble

Parse ESPN MBB Team Box, helper function

Description

Parse ESPN MBB Team Box, helper function

Usage

helper_espn_mbb_team_box(resp)

Arguments

resp

Response object from the ESPN MBB game summary endpoint

Value

Returns a tibble

Parse ESPN NBA PBP, helper function

Description

Parse ESPN NBA PBP, helper function

Usage

helper_espn_nba_pbp(resp)

Arguments

resp

Response object from the ESPN NBA game summary endpoint

Value

Returns a tibble

Parse ESPN NBA Player Box, helper function

Description

Parse ESPN NBA Player Box, helper function

Usage

helper_espn_nba_player_box(resp)

Arguments

resp

Response object from the ESPN NBA game summary endpoint

Value

Returns a tibble

Parse ESPN NBA Team Box, helper function

Description

Parse ESPN NBA Team Box, helper function

Usage

helper_espn_nba_team_box(resp)

Arguments

resp

Response object from the ESPN NBA game summary endpoint

Value

Returns a tibble

hoopR Data Loaders Overview

Description

Loaders for full seasons of pre-scraped data from the ⁠sportsdataverse/hoopR-{nba,mbb}-data⁠ releases on sportsdataverse-data. Each helper validates the requested seasons, builds the per-asset URLs, downloads in parallel (with optional progressr::progressr progress + optional DBI insertion), and tags the result with the hoopR_data S3 class.

Details

NBA loaders

Function Asset family
load_nba_pbp() NBA play-by-play
load_nba_player_box() NBA player boxscores
load_nba_team_box() NBA team boxscores
load_nba_schedule() NBA schedule
update_nba_db() Delta loader -> DB

MBB loaders

Function Asset family
load_mbb_pbp() Men's college basketball PBP
load_mbb_player_box() MBB player boxscores
load_mbb_team_box() MBB team boxscores
load_mbb_schedule() MBB schedule
update_mbb_db() Delta loader -> DB

KenPom Scraper Overview

Description

Authenticated scrapers for kenpom.com men's college-basketball pages. Authentication uses an httr2 cookie jar via login(); pages are pulled with .kp_get_page(jar, url) and parsed with rvest. CSS selectors for tables are fragile — KenPom changes the HTML occasionally and selectors may need updating.

Credentials are read from KP_USER / KP_PW env vars (or function args). See ?login for the auth flow.

Details

Team / season ratings

Function Purpose
kp_pomeroy_ratings() Pomeroy season ratings
kp_pomeroy_archive_ratings() Historical Pomeroy ratings
kp_program_ratings() Program-level ratings
kp_team_history() Team history page
kp_arenas() Arena reference

Per-game / per-team detail

Function Purpose
kp_box() Box-score detail
kp_fanmatch() FanMatch daily slate
kp_gameplan() Game-plan page
kp_team_lineups() Team lineup stats
kp_team_depth_chart() Team depth chart
kp_team_player_stats() Per-team player stats
kp_team_schedule() Per-team schedule
kp_team_players() Team roster

Conference / efficiency / four-factor splits

Function Purpose
kp_conf() Conference summary
kp_confhistory() Conference history
kp_confstats() Conference stats
kp_efficiency() Efficiency rankings
kp_fourfactors() Four-factor rankings
kp_pointdist() Points distribution
kp_teamstats() Team stats
kp_hca() Home-court advantage

Player + coach + officials

Function Purpose
kp_player_career() Player career page
kp_playerstats() Player stats
kp_kpoy() KenPom player of the year
kp_height() Team height/experience
kp_coach_history() Coach history
kp_referee() Referee splits
kp_officials() Game officials

Trends and miscellany

kp_trends(), kp_winprob(), kp_minutes_matrix(), kp_foul_trouble(), kp_opptracker(), kp_game_attrs(), kp_user_pw.

Get Home Court Arenas

Description

Get Home Court Arenas

Usage

kp_arenas(year = most_recent_mbb_season())

Arguments

year

Year of data to pull

Value

A data frame with the following columns:

col_name types description
rk numeric Rk.
team character Team-side label or team identifier.
conf character character.
arena character Arena.
alternate character Alternate.
year numeric 4-digit year.

See Also

Other KP Misc. Functions: kp_fanmatch(), kp_game_attrs(), kp_hca(), kp_officials(), kp_referee(), kp_trends()

Examples

try(kp_arenas(year = 2021))

Get KenPom Game Box Score

Description

Get KenPom Game Box Score

Usage

kp_box(game_id, year)

Arguments

game_id

Game id of game to pull
year

Year of game to pull

Value

Returns a tibble of game box scores with names: away_team, home_team, linescore, officials

away_team

col_name types description
hgt character Hgt.
wgt numeric Wgt.
yr character Yr.
number numeric Number.
player character Player.
min numeric Minutes played.
o_rtg numeric O rtg.
percent_ps numeric Percent ps.
pts numeric Points scored.
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
ftm numeric Free throws made.
fta numeric Free throw attempts.
or numeric Or.
dr numeric Dr.
a numeric A.
to numeric To.
blk numeric Blocks.
stl numeric Steals.
pf numeric Personal fouls.
team character Team-side label or team identifier.
wp_note character Wp note.
game_id numeric Unique game identifier.
year numeric 4-digit year.

home_team

col_name types description
hgt character Hgt.
wgt numeric Wgt.
yr character Yr.
number numeric Number.
player character Player.
min numeric Minutes played.
o_rtg numeric O rtg.
percent_ps numeric Percent ps.
pts numeric Points scored.
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
ftm numeric Free throws made.
fta numeric Free throw attempts.
or numeric Or.
dr numeric Dr.
a numeric A.
to numeric To.
blk numeric Blocks.
stl numeric Steals.
pf numeric Personal fouls.
team character Team-side label or team identifier.
wp_note character Wp note.
game_id numeric Unique game identifier.
year numeric 4-digit year.

linescore

col_name types description
team character Team-side label or team identifier.
q1 integer Q1.
q2 integer Q2.
q3 integer Q3.
q4 integer Q4.
t integer T.

officials

col_name types description
official_id character Unique official / referee identifier.
official_name character Official name.
game_id numeric Unique game identifier.
year numeric 4-digit year.

See Also

Other KenPom Boxscore Functions: kp_winprob()

Examples

try(kp_box(game_id = 6, year = 2021))

Get KenPom's coaching resume data

Description

Get KenPom's coaching resume data

Usage

kp_coach_history(coach)

Arguments

coach

Coach filter to select.

Value

A data frame with 30 columns:

col_name types description
year numeric 4-digit year.
team_rk numeric Team rk.
team character Team-side label or team identifier.
coach character Coach.
conf character character.
adj_t character Adj t.
adj_o character Adj o.
adj_d character Adj d.
off_e_fg_pct character Off e field goals percentage (0-1 decimal).
off_to_pct character Off to percentage (0-1 decimal).
off_or_pct character Off or percentage (0-1 decimal).
off_ft_rate character Off ft rate.
off_fg_2_pct character Off field goals 2 percentage (0-1 decimal).
off_fg_3_pct character Off field goals 3 percentage (0-1 decimal).
off_ft_pct character Off free throws percentage (0-1 decimal).
off_fg_3a_pct character Off field goals 3a percentage (0-1 decimal).
off_a_pct character Off a percentage (0-1 decimal).
off_apl character Off apl.
def_e_fg_pct character Def e field goals percentage (0-1 decimal).
def_to_pct character Def to percentage (0-1 decimal).
def_or_pct character Def or percentage (0-1 decimal).
def_ft_rate character Def ft rate.
def_fg_2_pct character Def field goals 2 percentage (0-1 decimal).
def_fg_3_pct character Def field goals 3 percentage (0-1 decimal).
def_blk_pct character Def blocks percentage (0-1 decimal).
def_fg_3a_pct character Def field goals 3a percentage (0-1 decimal).
def_a_pct character Def a percentage (0-1 decimal).
def_apl character Def apl.
foul2partic_pct character Foul2partic percentage (0-1 decimal).
wl character Wl.
wl_conf character Wl conf.
adj_t_rk numeric Adj t rk.
adj_o_rk numeric Adj o rk.
adj_d_rk numeric Adj d rk.
off_e_fg_pct_rk numeric Off e fg pct rk.
off_to_pct_rk numeric Off to pct rk.
off_or_pct_rk numeric Off or pct rk.
off_ft_rate_rk numeric Off ft rate rk.
off_fg_2_pct_rk numeric Off fg 2 pct rk.
off_fg_3_pct_rk numeric Off fg 3 pct rk.
off_ft_pct_rk numeric Off ft pct rk.
off_fg_3a_pct_rk numeric Off fg 3a pct rk.
off_a_pct_rk numeric Off a pct rk.
off_apl_rk numeric Off apl rk.
def_e_fg_pct_rk numeric Def e fg pct rk.
def_to_pct_rk numeric Def to pct rk.
def_or_pct_rk numeric Def or pct rk.
def_ft_rate_rk numeric Def ft rate rk.
def_fg_2_pct_rk numeric Def fg 2 pct rk.
def_fg_3_pct_rk numeric Def fg 3 pct rk.
def_blk_pct_rk numeric Def blk pct rk.
def_fg_3a_pct_rk numeric Def fg 3a pct rk.
def_a_pct_rk numeric Def a pct rk.
def_apl_rk numeric Def apl rk.
foul2partic_pct_rk numeric Foul2partic pct rk.
team_finish character Team finish.
ncaa_seed numeric Ncaa seed.

See Also

Other KenPom Historical Functions: kp_conf(), kp_confhistory(), kp_confstats(), kp_pomeroy_archive_ratings(), kp_program_ratings(), kp_team_history()

Examples

try(kp_coach_history(coach = 'Leonard Hamilton'))

Get KenPom's conference-wide stats

Description

Get KenPom's conference-wide stats

Usage

kp_conf(year, conf)

Arguments

year

Year (YYYY)
conf

Used to limit to players in a specific conference. Allowed values are: 'A10', 'ACC', 'AE', 'AMER',
'ASUN', 'B10', 'B12', 'BE', 'BSKY', 'BSTH', 'BW', 'CAA', 'CUSA', 'HORZ', 'IND', IVY',
'MAAC', 'MAC', 'MEAC', 'MVC', 'MWC', 'NEC', 'OVC', 'P12', 'PAT', 'SB', 'SC', 'SEC', 'SLND',
'SUM', 'SWAC', 'WAC', 'WCC'.
If you try to use a conference that doesn't exist for a given season, like 'IND' and '2018',
you'll get an empty table, as kenpom.com doesn't serve 404 pages for invalid table queries like that.
No filter applied by default.

Value

A list of named data frames:

Standings

col_name types description
team character Team-side label or team identifier.
overall character Overall.
conf character character.
adj_em numeric Adj em.
adj_em_rk numeric Adj em rk.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.
adj_t numeric Adj t.
adj_t_rk numeric Adj t rk.
conf_sos numeric Conf sos.
conf_sos_rk numeric Conf sos rk.
next_game character Next game date or opponent.
year numeric 4-digit year.

ConferencePlayOffense

col_name types description
team character Team-side label or team identifier.
oe numeric Oe.
oe_rk numeric Oe rk.
e_fg_pct numeric E field goals percentage (0-1 decimal).
e_fg_pct_rk numeric E fg pct rk.
to_pct numeric To percentage (0-1 decimal).
to_pct_rk numeric To pct rk.
or_pct numeric Or percentage (0-1 decimal).
or_pct_rk numeric Or pct rk.
ft_rate numeric Ft rate.
ft_rate_rk numeric Ft rate rk.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
fg_3_pct_rk numeric Fg 3 pct rk.
ft_pct numeric Free throw percentage (0-1).
ft_pct_rk numeric Ft pct rk.
tempo numeric Tempo.
tempo_rk numeric Tempo rk.
year numeric 4-digit year.

ConferencePlayDefense

col_name types description
team character Team-side label or team identifier.
de numeric De.
de_rk numeric De rk.
e_fg_pct numeric E field goals percentage (0-1 decimal).
e_fg_pct_rk numeric E fg pct rk.
to_pct numeric To percentage (0-1 decimal).
to_pct_rk numeric To pct rk.
or_pct numeric Or percentage (0-1 decimal).
or_pct_rk numeric Or pct rk.
ft_rate numeric Ft rate.
ft_rate_rk numeric Ft rate rk.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
fg_3_pct_rk numeric Fg 3 pct rk.
blk_pct numeric Blocks percentage (0-1 decimal).
blk_pct_rk numeric Blk pct rk.
stl_pct numeric Steals percentage (0-1 decimal).
stl_pct_rk numeric Stl pct rk.
year numeric 4-digit year.

AllKenPom

col_name types description
rk integer Rk.
player character Player.
year numeric 4-digit year.

ConferenceAggregateStats

col_name types description
stat character Stat.
value numeric Numeric or string value field.
rk numeric Rk.
year numeric 4-digit year.

WinningTrends

col_name types description
stat character Stat.
count character Count of count.
value numeric Numeric or string value field.
rk numeric Rk.
year numeric 4-digit year.

ConferenceComparison

col_name types description
rk numeric Rk.
conference character Conference.
rating numeric Rating.
year numeric 4-digit year.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_confhistory(), kp_confstats(), kp_pomeroy_archive_ratings(), kp_program_ratings(), kp_team_history()

Examples

try(kp_conf(year = 2020, conf = 'ACC'))

Get KenPom's historical conference ratings

Description

Get KenPom's historical conference ratings

Usage

kp_confhistory(conf)

Arguments

conf

Used to limit to players in a specific conference.

Allowed values are: 'A10', 'ACC', 'AE', 'AMER', 'ASUN', 'B10', 'B12', 'BE', 'BSKY', 'BSTH', 'BW', 'CAA', 'CUSA', 'HORZ', 'IND', IVY', 'MAAC', 'MAC', 'MEAC', 'MVC', 'MWC', 'NEC', 'OVC', 'P12', 'PAT', 'SB', 'SC', 'SEC', 'SLND', 'SUM', 'SWAC', 'WAC', 'WCC'.

If you try to use a conference that doesn't exist for a given season, like 'IND' and '2018', you'll get an empty table, as kenpom.com doesn't serve 404 pages for invalid table queries like that. No filter applied by default.

Value

A data frame with the following columns:

col_name types description
year integer 4-digit year.
rank character Rank.
tempo numeric Tempo.
efficiency numeric Efficiency.
e_fg_pct numeric E field goals percentage (0-1 decimal).
to_pct numeric To percentage (0-1 decimal).
or_pct numeric Or percentage (0-1 decimal).
ft_rate numeric Ft rate.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
ft_pct numeric Free throw percentage (0-1).
fg_3a_pct numeric Field goals 3a percentage (0-1 decimal).
a_pct numeric A percentage (0-1 decimal).
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
home_record character Home win-loss record.
bids character Bids.
s16 character S16.
f4 character F4.
ch character Ch.
reg_season_champ character Reg season champ.
tourney_champ character Tourney champ.
best_team character Best team.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_conf(), kp_confstats(), kp_pomeroy_archive_ratings(), kp_program_ratings(), kp_team_history()

Examples

try(kp_confhistory(conf = 'ACC'))

Get KenPom's conference comparison stats

Description

Get KenPom's conference comparison stats

Usage

kp_confstats(year = most_recent_mbb_season())

Arguments

year

Year (YYYY)

Value

A data frame with the following columns:

col_name types description
conf character character.
eff numeric Eff.
eff_rk numeric Eff rk.
tempo numeric Tempo.
tempo_rk numeric Tempo rk.
e_fg_pct numeric E field goals percentage (0-1 decimal).
e_fg_pct_rk numeric E fg pct rk.
to_pct numeric To percentage (0-1 decimal).
to_pct_rk numeric To pct rk.
or_pct numeric Or percentage (0-1 decimal).
or_pct_rk numeric Or pct rk.
ft_rate numeric Ft rate.
ft_rate_rk numeric Ft rate rk.
blk_pct numeric Blocks percentage (0-1 decimal).
blk_pct_rk numeric Blk pct rk.
stl_pct numeric Steals percentage (0-1 decimal).
stl_pct_rk numeric Stl pct rk.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
fg_3_pct_rk numeric Fg 3 pct rk.
ft_pct numeric Free throw percentage (0-1).
ft_pct_rk numeric Ft pct rk.
fg_3a_pct numeric Field goals 3a percentage (0-1 decimal).
fg_3a_pct_rk numeric Fg 3a pct rk.
a_pct numeric A percentage (0-1 decimal).
a_pct_rk numeric A pct rk.
home_w_l character Home team's wins losses.
home_w_l_pct numeric Home wins losses percentage (0-1 decimal).
home_w_l_rk numeric Home team's wins losses rk.
close numeric Close.
close_rk numeric Close rk.
blowouts numeric Blowouts.
blowouts_rk numeric Blowouts rk.
year numeric 4-digit year.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_conf(), kp_confhistory(), kp_pomeroy_archive_ratings(), kp_program_ratings(), kp_team_history()

Examples

try(kp_confstats(year=most_recent_mbb_season()))

Get KenPom Efficiency and Tempo Summary

Description

Get KenPom Efficiency and Tempo Summary

Usage

kp_efficiency(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of efficiency and tempo ratings

col_name types description
team character Team-side label or team identifier.
conf character character.
adj_t numeric Adj t.
adj_t_rk numeric Adj t rk.
raw_t numeric Raw t.
raw_t_rk numeric Raw t rk.
avg_poss_length_off numeric Avg poss length off.
avg_poss_length_off_rk numeric Avg poss length off rk.
avg_poss_length_def numeric Avg poss length def.
avg_poss_length_def_rk numeric Avg poss length def rk.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
raw_o numeric Raw o.
raw_o_rk numeric Raw o rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.
raw_d numeric Raw d.
raw_d_rk numeric Raw d rk.
ncaa_seed numeric Ncaa seed.
year numeric 4-digit year.

See Also

Other KenPom Ratings Functions: kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_efficiency(min_year = 2020, max_year = 2021))

Get FanMatch by date

Description

Get FanMatch by date

Usage

kp_fanmatch(date)

Arguments

date

Date of games to pull (YYYY-MM-DD)

Value

A data frame with the following columns:

col_name types description
prediction character Prediction.
time_et character Time et.
location character Location.
thrill_score numeric Thrill score.
comeback numeric Comeback.
excitement numeric Excitement.
road_rk numeric Road rk.
road_team character Road team.
home_rk numeric Home team's rk.
home_team character Home team's team.
win_rk numeric Win rk.
win_team character Win team.
win_score numeric Win score.
loss_rk numeric Loss rk.
loss_team character Loss team.
loss_score numeric Loss score.
poss numeric Poss.
mvp character Mvp.
event character Event.
date character Date in YYYY-MM-DD format.

See Also

Other KP Misc. Functions: kp_arenas(), kp_game_attrs(), kp_hca(), kp_officials(), kp_referee(), kp_trends()

Examples

try(kp_fanmatch(date = "2022-02-22"))

Get 2-Foul Participation Stats

Description

Get 2-Foul Participation Stats

Usage

kp_foul_trouble(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of foul participation stats

col_name types description
team character Team-side label or team identifier.
conf character character.
two_foul_particpation_pct numeric Two foul particpation percentage (0-1 decimal).
two_foul_particpation_pct_rk numeric Two foul particpation pct rk.
adj2fp numeric Adj2fp.
adj2fp_rk numeric Adj2fp rk.
two_foul_total_time character Time / clock value.
two_foul_total_time_rk character Two foul total time rk.
two_foul_time_on character Two foul time on.
two_foul_time_on_rk character Two foul time on rk.
bench_pct numeric Bench percentage (0-1 decimal).
bench_pct_rk numeric Bench pct rk.
ncaa_seed numeric Ncaa seed.
year integer 4-digit year.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_foul_trouble(min_year = 2020, max_year = most_recent_mbb_season()))

Get Four Factors Data

Description

Get Four Factors Data

Usage

kp_fourfactors(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of four factors ratings

col_name types description
team character Team-side label or team identifier.
conf character character.
adj_t numeric Adj t.
adj_t_rk numeric Adj t rk.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
off_e_fg_pct numeric Off e field goals percentage (0-1 decimal).
off_e_fg_pct_rk numeric Off e fg pct rk.
off_to_pct numeric Off to percentage (0-1 decimal).
off_to_pct_rk numeric Off to pct rk.
off_or_pct numeric Off or percentage (0-1 decimal).
off_or_pct_rk numeric Off or pct rk.
off_ft_rate numeric Off ft rate.
off_ft_rate_rk numeric Off ft rate rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.
def_e_fg_pct numeric Def e field goals percentage (0-1 decimal).
def_e_fg_pct_rk numeric Def e fg pct rk.
def_to_pct numeric Def to percentage (0-1 decimal).
def_to_pct_rk numeric Def to pct rk.
def_or_pct numeric Def or percentage (0-1 decimal).
def_or_pct_rk numeric Def or pct rk.
def_ft_rate numeric Def ft rate.
def_ft_rate_rk numeric Def ft rate rk.
ncaa_seed numeric Ncaa seed.
year numeric 4-digit year.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_fourfactors(min_year = 2020, max_year = 2021))

Get Game Attributes

Description

Get Game Attributes

Usage

kp_game_attrs(year = most_recent_mbb_season(), attr = "Excitement")

Arguments

year

Year of data to pull
attr

Game Attribute, valid values include:
'Excitement', 'Tension','Dominance','MinWp','FanMatch',
'Upsets','Busts','Comeback','Window'

Value

Returns a tibble with game attributes

col_name types description
rk integer Rk.
data character Data.
game character Game.
location character Location.
conf character character.
excitement numeric Excitement.
year numeric 4-digit year.

See Also

Other KP Misc. Functions: kp_arenas(), kp_fanmatch(), kp_hca(), kp_officials(), kp_referee(), kp_trends()

Examples

try(kp_game_attrs(year = 2021, attr = "Excitement"))

Get KenPom's team game plan page

Description

Get KenPom's team game plan page

Usage

kp_gameplan(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a named list of tibbles: gameplan, correlations, position_distributions

gameplan

col_name types description
date Date Date in YYYY-MM-DD format.
opponent_rk numeric Opponent rk.
opponent character Opponent.
result character Result.
location character Location.
pace numeric Possessions per 48 minutes.
off_eff numeric Off eff.
off_eff_rk numeric Off eff rk.
off_e_fg_pct numeric Off e field goals percentage (0-1 decimal).
off_to_pct numeric Off to percentage (0-1 decimal).
off_or_pct numeric Off or percentage (0-1 decimal).
off_ftr numeric Off ftr.
off_fgm_2 numeric Off fgm 2.
off_fga_2 numeric Off fga 2.
off_fg_2_pct numeric Off field goals 2 percentage (0-1 decimal).
off_fgm_3 numeric Off fgm 3.
off_fga_3 numeric Off fga 3.
off_fg_3_pct numeric Off field goals 3 percentage (0-1 decimal).
off_fg_3a_pct numeric Off field goals 3a percentage (0-1 decimal).
def_eff numeric Def eff.
def_eff_rk numeric Def eff rk.
def_e_fg_pct numeric Def e field goals percentage (0-1 decimal).
def_to_pct numeric Def to percentage (0-1 decimal).
def_or_pct numeric Def or percentage (0-1 decimal).
def_ftr numeric Def ftr.
def_fgm_2 numeric Def fgm 2.
def_fga_2 numeric Def fga 2.
def_fg_2_pct numeric Def field goals 2 percentage (0-1 decimal).
def_fgm_3 numeric Def fgm 3.
def_fga_3 numeric Def fga 3.
def_fg_3_pct numeric Def field goals 3 percentage (0-1 decimal).
def_fg_3a_pct numeric Def field goals 3a percentage (0-1 decimal).
wl character Wl.
team_score numeric Team's score / final score.
opponent_score numeric Opponent score.
day_date character Date in YYYY-MM-DD format.
game_date numeric Game date (YYYY-MM-DD).

correlations

col_name types description
correlations_r_x_100 character Correlations r x 100.
pace character Possessions per 48 minutes.
off_e_fg_pct character Off e field goals percentage (0-1 decimal).
off_to_pct character Off to percentage (0-1 decimal).
off_or_pct character Off or percentage (0-1 decimal).
off_ftr character Off ftr.
def_e_fg_pct character Def e field goals percentage (0-1 decimal).
def_to_pct character Def to percentage (0-1 decimal).
def_or_pct character Def or percentage (0-1 decimal).
def_ftr character Def ftr.

position_distributions

col_name types description
team character Team-side label or team identifier.
category character Category label.
c_pct numeric C percentage (0-1 decimal).
pf_pct numeric Personal fouls percentage (0-1 decimal).
sf_pct numeric Sf percentage (0-1 decimal).
sg_pct numeric Sg percentage (0-1 decimal).
pg_pct numeric Pg percentage (0-1 decimal).
c_pct_rk numeric C pct rk.
pf_pct_rk numeric Pf pct rk.
sf_pct_rk numeric Sf pct rk.
sg_pct_rk numeric Sg pct rk.
pg_pct_rk numeric Pg pct rk.
c_pct_d1_avg numeric C pct d1 avg.
pf_pct_d1_avg numeric Pf pct d1 avg.
sf_pct_d1_avg numeric Sf pct d1 avg.
sg_pct_d1_avg numeric Sg pct d1 avg.
pg_pct_d1_avg numeric Pg pct d1 avg.

See Also

Other KenPom Team Functions: kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_gameplan(team='Florida St.', year=2021))

Get Home Court Advantage Estimates

Description

Get Home Court Advantage Estimates

Usage

kp_hca()

Value

A data frame with the following columns:

col_name types description
team character Team-side label or team identifier.
conf character character.
hca numeric Hca.
hca_rk numeric Hca rk.
pf numeric Personal fouls.
pf_rk numeric Pf rk.
pts numeric Points scored.
pts_rk numeric Pts rk.
nst numeric Nst.
nst_rk numeric Nst rk.
blk numeric Blocks.
blk_rk numeric Blk rk.
elev numeric Elev.
elev_rk numeric Elev rk.

See Also

Other KP Misc. Functions: kp_arenas(), kp_fanmatch(), kp_game_attrs(), kp_officials(), kp_referee(), kp_trends()

Examples

try(kp_hca())

Get Heights, Experience, Bench and Continuity Data

Description

Get Heights, Experience, Bench and Continuity Data

Usage

kp_height(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of heights

col_name types description
team character Team-side label or team identifier.
conf character character.
avg_hgt numeric Avg hgt.
avg_hgt_rk numeric Avg hgt rk.
eff_hgt numeric Eff hgt.
eff_hgt_rk numeric Eff hgt rk.
c_hgt numeric C hgt.
c_hgt_rk numeric C hgt rk.
pf_hgt numeric Pf hgt.
pf_hgt_rk numeric Pf hgt rk.
sf_hgt numeric Sf hgt.
sf_hgt_rk numeric Sf hgt rk.
sg_hgt numeric Sg hgt.
sg_hgt_rk numeric Sg hgt rk.
pg_hgt numeric Pg hgt.
pg_hgt_rk numeric Pg hgt rk.
experience numeric Years of professional experience.
experience_rk numeric Experience rk.
bench numeric Bench.
bench_rk numeric Bench rk.
continuity numeric Continuity.
continuity_rk numeric Continuity rk.
ncaa_seed numeric Ncaa seed.
year integer 4-digit year.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_height(min_year = 2020, max_year = 2021))

Get KPoY Leaders Tables

Description

Get KPoY Leaders Tables

Usage

kp_kpoy(year = most_recent_mbb_season())

Arguments

year

Year of data to pull (earliest year of data available: 2011)

Value

Returns a list of tibbles: "kPoYRatings", "GameMVPs"

KPoYRatings

col_name types description
rk integer Rk.
player character Player.
kpoy_rating numeric Kpoy rating.
team character Team-side label or team identifier.
hgt character Hgt.
wgt numeric Wgt.
exp character Exp.
home_town character Home team's town.
year numeric 4-digit year.
group character Group identifier (e.g. conference 'group_id').

GameMVPs

col_name types description
rk numeric Rk.
player character Player.
game_mv_ps numeric Game mv ps.
team character Team-side label or team identifier.
hgt character Hgt.
wgt numeric Wgt.
exp character Exp.
home_town character Home team's town.
year numeric 4-digit year.
group character Group identifier (e.g. conference 'group_id').

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_kpoy(year = 2026))

Get Minutes Matrix from Expanded Player Page

Description

Get Minutes Matrix from Expanded Player Page

Usage

kp_minutes_matrix(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a tibble of minutes matrix data

See Also

Other KenPom Team Functions: kp_gameplan(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_minutes_matrix(team = 'Florida St.', year = 2021))

Get officials rankings

Description

Get officials rankings

Usage

kp_officials(year = most_recent_mbb_season())

Arguments

year

Year of data to pull

Value

A data frame with the following columns:

col_name types description
rk integer Rk.
official_name character Official name.
ref_rating numeric Ref rating.
gms numeric Gms.
last_game character Last game date or score string.
last_game_1 character Last game 1.
year numeric 4-digit year.

See Also

Other KP Misc. Functions: kp_arenas(), kp_fanmatch(), kp_game_attrs(), kp_hca(), kp_referee(), kp_trends()

Examples

try(kp_officials(year = 2021))

Get KenPom's team opponent tracker page

Description

Get KenPom's team opponent tracker page

Usage

kp_opptracker(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a tibble of team opponent tracker data

col_name types description
date Date Date in YYYY-MM-DD format.
game_date numeric Game date (YYYY-MM-DD).
day_date character Date in YYYY-MM-DD format.
wl character Wl.
team character Team-side label or team identifier.
team_score numeric Team's score / final score.
opponent character Opponent.
opponent_score numeric Opponent score.
result character Result.
adj_oe numeric Adj oe.
adj_oe_rk integer Adj oe rk.
off_e_fg_pct numeric Off e field goals percentage (0-1 decimal).
off_e_fg_pct_rk integer Off e fg pct rk.
off_to_pct numeric Off to percentage (0-1 decimal).
off_to_pct_rk integer Off to pct rk.
off_or_pct numeric Off or percentage (0-1 decimal).
off_or_pct_rk integer Off or pct rk.
off_ft_rate numeric Off ft rate.
off_ft_rate_rk integer Off ft rate rk.
off_fg_2_pct numeric Off field goals 2 percentage (0-1 decimal).
off_fg_2_pct_rk integer Off fg 2 pct rk.
off_fg_3_pct numeric Off field goals 3 percentage (0-1 decimal).
off_fg_3_pct_rk integer Off fg 3 pct rk.
off_blk_pct numeric Off blocks percentage (0-1 decimal).
off_blk_pct_rk integer Off blk pct rk.
off_fg_3a_pct numeric Off field goals 3a percentage (0-1 decimal).
off_fg_3a_pct_rk integer Off fg 3a pct rk.
off_apl numeric Off apl.
off_apl_rk integer Off apl rk.
adj_de numeric Adj de.
adj_de_rk integer Adj de rk.
def_e_fg_pct numeric Def e field goals percentage (0-1 decimal).
def_e_fg_pct_rk integer Def e fg pct rk.
def_to_pct numeric Def to percentage (0-1 decimal).
def_to_pct_rk integer Def to pct rk.
def_or_pct numeric Def or percentage (0-1 decimal).
def_or_pct_rk integer Def or pct rk.
def_ft_rate numeric Def ft rate.
def_ft_rate_rk integer Def ft rate rk.
def_fg_2_pct numeric Def field goals 2 percentage (0-1 decimal).
def_fg_2_pct_rk integer Def fg 2 pct rk.
def_fg_3_pct numeric Def field goals 3 percentage (0-1 decimal).
def_fg_3_pct_rk integer Def fg 3 pct rk.
def_blk_pct numeric Def blocks percentage (0-1 decimal).
def_blk_pct_rk integer Def blk pct rk.
def_fg_3a_pct numeric Def field goals 3a percentage (0-1 decimal).
def_fg_3a_pct_rk integer Def fg 3a pct rk.
def_apl numeric Def apl.
def_apl_rk integer Def apl rk.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_opptracker(team = 'Florida St.', year = 2021))

Get KenPom's player career stats from the player page

Description

Get KenPom's player career stats from the player page

Usage

kp_player_career(player_id)

Arguments

player_id

Player Id filter to select.

Value

Returns a named list of tibbles: player_stats, gamelog

player_stats

col_name types description
year numeric 4-digit year.
team_rk numeric Team rk.
team character Team-side label or team identifier.
number numeric Number.
name character Display name.
position character Listed roster position (G, F, C, etc.).
hgt character Hgt.
wgt numeric Wgt.
yr character Yr.
g numeric Games played.
min_pct numeric Min percentage (0-1 decimal).
o_rtg numeric O rtg.
poss_pct numeric Poss percentage (0-1 decimal).
shots_pct numeric Shots percentage (0-1 decimal).
e_fg_pct numeric E field goals percentage (0-1 decimal).
ts_pct numeric True shooting percentage (0-1).
or_pct numeric Or percentage (0-1 decimal).
dr_pct numeric Dr percentage (0-1 decimal).
a_rate numeric A rate.
to_rate numeric To rate.
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
f_cper40 numeric F cper40.
f_dper40 numeric F dper40.
ft_rate numeric Ft rate.
ftm numeric Free throws made.
fta numeric Free throw attempts.
ft_pct numeric Free throw percentage (0-1).
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
group_rank character League/season rank for group.
team_finish character Team finish.
ncaa_seed numeric Ncaa seed.
hometown character Player hometown.
date_of_birth character Date of birth (YYYY-MM-DD).
age character Player age (in years).
comparisons character Comparisons.

gamelog

col_name types description
year numeric 4-digit year.
team character Team-side label or team identifier.
name character Display name.
position character Listed roster position (G, F, C, etc.).
opponent_tier logical Opponent tier.
date character Date in YYYY-MM-DD format.
opponent_rk numeric Opponent rk.
opponent character Opponent.
result character Result.
ot character Ot.
location character Location.
game_type character Game type.
mvp character Mvp.
start character Start.
minutes_played numeric Minutes played.
o_rtg numeric O rtg.
poss_pct numeric Poss percentage (0-1 decimal).
pts numeric Points scored.
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
ftm numeric Free throws made.
fta numeric Free throw attempts.
or numeric Or.
dr numeric Dr.
a numeric A.
to numeric To.
blk numeric Blocks.
stl numeric Steals.
pf numeric Personal fouls.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_player_career(player_id = '41180'))

Get Player Stats Leaders by Metric

Description

Get Player Stats Leaders by Metric

Usage

kp_playerstats(
  metric = "eFG",
  conf = NULL,
  conf_only = FALSE,
  year = most_recent_mbb_season()
)

Arguments

metric

Used to get leaders for different metrics. Available values are:
'ORtg', 'Min', 'eFG', 'Poss', Shots', 'OR', 'DR', 'TO', 'ARate', 'Blk',
'FTRate', 'Stl', 'TS', 'FC40', 'FD40', '2P', '3P', 'FT'.
Default is 'eFG'. 'ORtg' returns a list of four dataframes, as there are four tables:
players that used more than 28 percent of possessions, more than 24 percent of possessions, more than 20 percent of possessions, and with no possession restriction.
conf

Used to limit to players in a specific conference. Allowed values are: 'A10', 'ACC', 'AE', 'AMER',
'ASUN', 'B10', 'B12', 'BE', 'BSKY', 'BSTH', 'BW', 'CAA', 'CUSA', 'HORZ', 'IND', IVY',
'MAAC', 'MAC', 'MEAC', 'MVC', 'MWC', 'NEC', 'OVC', 'P12', 'PAT', 'SB', 'SC', 'SEC', 'SLND',
'SUM', 'SWAC', 'WAC', 'WCC'.
If you try to use a conference that doesn't exist for a given season, like 'IND' and '2018',
you'll get an empty table, as kenpom.com doesn't serve 404 pages for invalid table queries like that.
No filter applied by default.
conf_only

Used to define whether stats should reflect conference games only.
Only available if specific conference is defined. Only available for season after 2013, FALSE by default.
year

Year of data to pull (earliest year of data available: 2004)

Value

Returns a tibble of player stats

col_name types description
rk character Rk.
player character Player.
team character Team-side label or team identifier.
e_fg character E fg.
hgt character Hgt.
wgt character Wgt.
yr character Yr.
year numeric 4-digit year.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_pointdist(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_playerstats(metric = "eFG", conf_only = FALSE, year = 2021))

Get Team Points Distribution

Description

Get Team Points Distribution

Usage

kp_pointdist(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of team points distributions

col_name types description
team character Team-side label or team identifier.
conf character character.
off_ft_pct numeric Off free throws percentage (0-1 decimal).
off_ft_pct_rk numeric Off ft pct rk.
off_fg_2_pct numeric Off field goals 2 percentage (0-1 decimal).
off_fg_2_pct_rk numeric Off fg 2 pct rk.
off_fg_3_pct numeric Off field goals 3 percentage (0-1 decimal).
off_fg_3_pct_rk numeric Off fg 3 pct rk.
def_ft_pct numeric Def free throws percentage (0-1 decimal).
def_ft_pct_rk numeric Def ft pct rk.
def_fg_2_pct numeric Def field goals 2 percentage (0-1 decimal).
def_fg_2_pct_rk numeric Def fg 2 pct rk.
def_fg_3_pct numeric Def field goals 3 percentage (0-1 decimal).
def_fg_3_pct_rk numeric Def fg 3 pct rk.
ncaa_seed numeric Ncaa seed.
year numeric 4-digit year.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pomeroy_ratings(), kp_teamstats()

Examples

try(kp_pointdist(min_year = 2020, max_year = 2021))

Get KenPom's ratings archive pages

Description

Get KenPom's ratings archive pages

Usage

kp_pomeroy_archive_ratings(date)

Arguments

date

Date (YYYY-MM-DD)

Value

A data frame with 22 columns:

col_name types description
adj_em_rk numeric Adj em rk.
team character Team-side label or team identifier.
conf character character.
adj_em numeric Adj em.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.
adj_t numeric Adj t.
adj_t_rk numeric Adj t rk.
final_rk numeric Final rk.
final_adj_em numeric Final adj em.
final_adj_o numeric Final adj o.
final_adj_o_rk numeric Final adj o rk.
final_adj_d numeric Final adj d.
final_adj_d_rk numeric Final adj d rk.
final_adj_t numeric Final adj t.
final_adj_t_rk numeric Final adj t rk.
rk_chg numeric Rk chg.
em_chg numeric Em chg.
adj_t_chg numeric Adj t chg.
ncaa_seed numeric Ncaa seed.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_conf(), kp_confhistory(), kp_confstats(), kp_program_ratings(), kp_team_history()

Examples

try(kp_pomeroy_archive_ratings(date='2018-11-22'))

Get KenPom Ratings

Description

Get KenPom Ratings

Usage

kp_pomeroy_ratings(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of ratings

col_name types description
year integer 4-digit year.
rk numeric Rk.
team character Team-side label or team identifier.
conf character character.
w_l character W l.
adj_em numeric Adj em.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.
adj_t numeric Adj t.
adj_t_rk numeric Adj t rk.
luck numeric Luck.
luck_rk numeric Luck rk.
sos_adj_em numeric Sos adj em.
sos_adj_em_rk numeric Sos adj em rk.
sos_opp_o numeric Sos opp o.
sos_opp_o_rk numeric Sos opp o rk.
sos_opp_d numeric Sos opp d.
sos_opp_d_rk numeric Sos opp d rk.
ncsos_adj_em numeric Ncsos adj em.
ncsos_adj_em_rk numeric Ncsos adj em rk.
ncaa_seed numeric Ncaa seed.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_teamstats()

Examples

try(kp_pomeroy_ratings(min_year = 2020, max_year = 2021))

Get KenPom's program ratings

Description

Get KenPom's program ratings

Usage

kp_program_ratings()

Value

A data frame with 17 columns:

col_name types description
rk numeric Rk.
team character Team-side label or team identifier.
conf character character.
rtg numeric Rtg.
best_rk numeric Best rk.
best_yr numeric Best yr.
worst_rk numeric Worst rk.
worst_yr numeric Worst yr.
kp_median numeric Kp median.
top10 numeric Top10.
top25 numeric Top25.
top50 numeric Top50.
ch numeric Ch.
f4 numeric F4.
s16 numeric S16.
r1 numeric R1.
chg numeric Chg.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_conf(), kp_confhistory(), kp_confstats(), kp_pomeroy_archive_ratings(), kp_team_history()

Examples

try(kp_program_ratings())

Get referee game log

Description

Get referee game log

Usage

kp_referee(referee, year)

Arguments

referee

Referee ID
year

Year of data to pull

Value

A data frame with the following columns:

col_name types description
game_number integer Game number.
date character Date in YYYY-MM-DD format.
time_et character Time et.
game character Game.
location character Location.
venue character Venue name.
conference character Conference.
thrill_score numeric Thrill score.
referee_name character Referee name.
ref_rank numeric League/season rank for ref.
year numeric 4-digit year.

See Also

Other KP Misc. Functions: kp_arenas(), kp_fanmatch(), kp_game_attrs(), kp_hca(), kp_officials(), kp_trends()

Examples

try(kp_referee(referee = 714363, year = 2021))

Get Depth Chart Last 5 Games from Team Page

Description

Get Depth Chart Last 5 Games from Team Page

Usage

kp_team_depth_chart(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

A data frame with the following columns:

col_name types description
pg_number numeric Pg number.
pg_player_first_name character Pg player first name.
pg_player_last_name character Pg player last name.
pg_hgt character Pg hgt.
pg_wgt numeric Pg wgt.
pg_yr character Pg yr.
pg_min_pct numeric Pg min percentage (0-1 decimal).
sg_number numeric Sg number.
sg_player_first_name character Sg player first name.
sg_player_last_name character Sg player last name.
sg_hgt character Sg hgt.
sg_wgt numeric Sg wgt.
sg_yr character Sg yr.
sg_min_pct numeric Sg min percentage (0-1 decimal).
sf_number numeric Sf number.
sf_player_first_name character Sf player first name.
sf_player_last_name character Sf player last name.
sf_hgt character Sf hgt.
sf_wgt numeric Sf wgt.
sf_yr character Sf yr.
sf_min_pct numeric Sf min percentage (0-1 decimal).
pf_number numeric Pf number.
pf_player_first_name character Personal fouls player first name.
pf_player_last_name character Personal fouls player last name.
pf_hgt character Pf hgt.
pf_wgt numeric Pf wgt.
pf_yr character Pf yr.
pf_min_pct numeric Personal fouls min percentage (0-1 decimal).
c_number numeric C number.
c_player_first_name character C player first name.
c_player_last_name character C player last name.
c_hgt character C hgt.
c_wgt numeric C wgt.
c_yr character C yr.
c_min_pct numeric C min percentage (0-1 decimal).
team character Team-side label or team identifier.
year numeric 4-digit year.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_lineups(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_team_depth_chart(team = 'Florida St.', year= 2021))

Get KenPom's team efficiency history

Description

Get KenPom's team efficiency history

Usage

kp_team_history(team)

Arguments

team

Team filter to select.

Value

A data frame with the following columns:

col_name types description
year numeric 4-digit year.
team_rk numeric Team rk.
team character Team-side label or team identifier.
coach character Coach.
conf character character.
adj_t numeric Adj t.
adj_o numeric Adj o.
adj_d numeric Adj d.
off_e_fg_pct numeric Off e field goals percentage (0-1 decimal).
off_to_pct numeric Off to percentage (0-1 decimal).
off_or_pct numeric Off or percentage (0-1 decimal).
off_ft_rate numeric Off ft rate.
off_fg_2_pct numeric Off field goals 2 percentage (0-1 decimal).
off_fg_3_pct numeric Off field goals 3 percentage (0-1 decimal).
off_ft_pct numeric Off free throws percentage (0-1 decimal).
off_fg_3a_pct numeric Off field goals 3a percentage (0-1 decimal).
off_a_pct numeric Off a percentage (0-1 decimal).
off_apl numeric Off apl.
def_e_fg_pct numeric Def e field goals percentage (0-1 decimal).
def_to_pct numeric Def to percentage (0-1 decimal).
def_or_pct numeric Def or percentage (0-1 decimal).
def_ft_rate numeric Def ft rate.
def_fg_2_pct numeric Def field goals 2 percentage (0-1 decimal).
def_fg_3_pct numeric Def field goals 3 percentage (0-1 decimal).
def_blk_pct numeric Def blocks percentage (0-1 decimal).
def_fg_3a_pct numeric Def field goals 3a percentage (0-1 decimal).
def_a_pct numeric Def a percentage (0-1 decimal).
def_apl numeric Def apl.
foul2partic_pct numeric Foul2partic percentage (0-1 decimal).
wl character Wl.
wl_conf character Wl conf.
adj_t_rk numeric Adj t rk.
adj_o_rk numeric Adj o rk.
adj_d_rk numeric Adj d rk.
off_e_fg_pct_rk numeric Off e fg pct rk.
off_to_pct_rk numeric Off to pct rk.
off_or_pct_rk numeric Off or pct rk.
off_ft_rate_rk numeric Off ft rate rk.
off_fg_2_pct_rk numeric Off fg 2 pct rk.
off_fg_3_pct_rk numeric Off fg 3 pct rk.
off_ft_pct_rk numeric Off ft pct rk.
off_fg_3a_pct_rk numeric Off fg 3a pct rk.
off_a_pct_rk numeric Off a pct rk.
off_apl_rk numeric Off apl rk.
def_e_fg_pct_rk numeric Def e fg pct rk.
def_to_pct_rk numeric Def to pct rk.
def_or_pct_rk numeric Def or pct rk.
def_ft_rate_rk numeric Def ft rate rk.
def_fg_2_pct_rk numeric Def fg 2 pct rk.
def_fg_3_pct_rk numeric Def fg 3 pct rk.
def_blk_pct_rk numeric Def blk pct rk.
def_fg_3a_pct_rk numeric Def fg 3a pct rk.
def_a_pct_rk numeric Def a pct rk.
def_apl_rk numeric Def apl rk.
foul2partic_pct_rk numeric Foul2partic pct rk.
team_finish character Team finish.
ncaa_seed numeric Ncaa seed.

See Also

Other KenPom Historical Functions: kp_coach_history(), kp_conf(), kp_confhistory(), kp_confstats(), kp_pomeroy_archive_ratings(), kp_program_ratings()

Examples

try(kp_team_history(team = 'Florida St.'))

Get Lineups Last 5 Games from Team Page

Description

Get Lineups Last 5 Games from Team Page

Usage

kp_team_lineups(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

A data frame with the following columns:

col_name types description
year numeric 4-digit year.
team character Team-side label or team identifier.
min_pct numeric Min percentage (0-1 decimal).
pg_number numeric Pg number.
pg_player_first_name character Pg player first name.
pg_player_last_name character Pg player last name.
pg_hgt character Pg hgt.
pg_wgt numeric Pg wgt.
pg_yr character Pg yr.
sg_number numeric Sg number.
sg_player_first_name character Sg player first name.
sg_player_last_name character Sg player last name.
sg_hgt character Sg hgt.
sg_wgt numeric Sg wgt.
sg_yr character Sg yr.
sf_number numeric Sf number.
sf_player_first_name character Sf player first name.
sf_player_last_name character Sf player last name.
sf_hgt character Sf hgt.
sf_wgt numeric Sf wgt.
sf_yr character Sf yr.
pf_number numeric Pf number.
pf_player_first_name character Personal fouls player first name.
pf_player_last_name character Personal fouls player last name.
pf_hgt character Pf hgt.
pf_wgt numeric Pf wgt.
pf_yr character Pf yr.
c_number numeric C number.
c_player_first_name character C player first name.
c_player_last_name character C player last name.
c_hgt character C hgt.
c_wgt numeric C wgt.
c_yr character C yr.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_player_stats(), kp_team_players(), kp_team_schedule()

Examples

try(kp_team_lineups(team = 'Florida St.', year = 2021))

Get Team Player Stats

Description

Get Team Player Stats

Usage

kp_team_player_stats(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a list of named data frames: all_games, conference_games

all_games

col_name types description
role character Role.
number numeric Number.
player character Player.
ht character Ht.
wt numeric Wt.
yr character Yr.
g numeric Games played.
min_pct numeric Min percentage (0-1 decimal).
o_rtg numeric O rtg.
poss_pct numeric Poss percentage (0-1 decimal).
shots_pct numeric Shots percentage (0-1 decimal).
e_fg_pct numeric E field goals percentage (0-1 decimal).
ts_pct numeric True shooting percentage (0-1).
or_pct numeric Or percentage (0-1 decimal).
dr_pct numeric Dr percentage (0-1 decimal).
a_rate numeric A rate.
to_rate numeric To rate.
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
f_cper40 numeric F cper40.
f_dper40 numeric F dper40.
ft_rate numeric Ft rate.
ftm numeric Free throws made.
fta numeric Free throw attempts.
ft_pct numeric Free throw percentage (0-1).
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
category character Category label.
min_pct_rk numeric Min pct rk.
o_rtg_rk numeric O rtg rk.
poss_pct_rk numeric Poss pct rk.
shots_pct_rk numeric Shots pct rk.
e_fg_pct_rk numeric E fg pct rk.
ts_pct_rk numeric Ts pct rk.
or_pct_rk numeric Or pct rk.
dr_pct_rk numeric Dr pct rk.
a_rate_rk numeric A rate rk.
to_rate_rk numeric To rate rk.
blk_pct_rk numeric Blk pct rk.
stl_pct_rk numeric Stl pct rk.
f_cper40_rk numeric F cper40 rk.
f_dper40_rk numeric F dper40 rk.
ft_rate_rk numeric Ft rate rk.
ft_pct_rk numeric Ft pct rk.
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct_rk numeric Fg 3 pct rk.
group_rank character League/season rank for group.
team character Team-side label or team identifier.
year numeric 4-digit year.
player_id numeric Unique player identifier.

conference_games

col_name types description
role character Role.
number numeric Number.
player character Player.
ht character Ht.
wt numeric Wt.
yr character Yr.
g numeric Games played.
min_pct numeric Min percentage (0-1 decimal).
o_rtg numeric O rtg.
poss_pct numeric Poss percentage (0-1 decimal).
shots_pct numeric Shots percentage (0-1 decimal).
e_fg_pct numeric E field goals percentage (0-1 decimal).
ts_pct numeric True shooting percentage (0-1).
or_pct numeric Or percentage (0-1 decimal).
dr_pct numeric Dr percentage (0-1 decimal).
a_rate numeric A rate.
to_rate numeric To rate.
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
f_cper40 numeric F cper40.
f_dper40 numeric F dper40.
ft_rate numeric Ft rate.
ftm numeric Free throws made.
fta numeric Free throw attempts.
ft_pct numeric Free throw percentage (0-1).
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
category character Category label.
min_pct_rk numeric Min pct rk.
o_rtg_rk numeric O rtg rk.
poss_pct_rk numeric Poss pct rk.
shots_pct_rk numeric Shots pct rk.
e_fg_pct_rk numeric E fg pct rk.
ts_pct_rk numeric Ts pct rk.
or_pct_rk numeric Or pct rk.
dr_pct_rk numeric Dr pct rk.
a_rate_rk numeric A rate rk.
to_rate_rk numeric To rate rk.
blk_pct_rk numeric Blk pct rk.
stl_pct_rk numeric Stl pct rk.
f_cper40_rk numeric F cper40 rk.
f_dper40_rk numeric F dper40 rk.
ft_rate_rk numeric Ft rate rk.
ft_pct_rk numeric Ft pct rk.
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct_rk numeric Fg 3 pct rk.
group_rank character League/season rank for group.
team character Team-side label or team identifier.
year numeric 4-digit year.
player_id numeric Unique player identifier.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_players(), kp_team_schedule()

Examples

try(kp_team_player_stats(team = 'Florida St.', year = 2021))

Get KenPom's player stats from the team page

Description

Get KenPom's player stats from the team page

Usage

kp_team_players(team, year = 2021)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a tibble of team player data

col_name types description
role character Role.
number numeric Number.
player character Player.
ht character Ht.
wt numeric Wt.
yr character Yr.
g numeric Games played.
s numeric S.
min_pct numeric Min percentage (0-1 decimal).
o_rtg numeric O rtg.
poss_pct numeric Poss percentage (0-1 decimal).
shots_pct numeric Shots percentage (0-1 decimal).
e_fg_pct numeric E field goals percentage (0-1 decimal).
ts_pct numeric True shooting percentage (0-1).
or_pct numeric Or percentage (0-1 decimal).
dr_pct numeric Dr percentage (0-1 decimal).
a_rate numeric A rate.
to_rate numeric To rate.
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
f_cper40 numeric F cper40.
f_dper40 numeric F dper40.
ft_rate numeric Ft rate.
ftm numeric Free throws made.
fta numeric Free throw attempts.
ft_pct numeric Free throw percentage (0-1).
fgm_2 numeric Fgm 2.
fga_2 numeric Fga 2.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fgm_3 numeric Fgm 3.
fga_3 numeric Fga 3.
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
min_pct_rk numeric Min pct rk.
o_rtg_rk numeric O rtg rk.
poss_pct_rk numeric Poss pct rk.
shots_pct_rk numeric Shots pct rk.
e_fg_pct_rk numeric E fg pct rk.
ts_pct_rk numeric Ts pct rk.
or_pct_rk numeric Or pct rk.
dr_pct_rk numeric Dr pct rk.
a_rate_rk numeric A rate rk.
to_rate_rk numeric To rate rk.
blk_pct_rk numeric Blk pct rk.
stl_pct_rk numeric Stl pct rk.
f_cper40_rk numeric F cper40 rk.
f_dper40_rk numeric F dper40 rk.
ft_rate_rk numeric Ft rate rk.
ft_pct_rk numeric Ft pct rk.
fg_2_pct_rk numeric Fg 2 pct rk.
fg_3_pct_rk numeric Fg 3 pct rk.
national_rank character League/season rank for national.
team character Team-side label or team identifier.
year numeric 4-digit year.
player_id numeric Unique player identifier.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_schedule()

Examples

try(kp_team_players(team = 'Florida St.', year = 2024))

Get team schedule results

Description

Get team schedule results

Usage

kp_team_schedule(team, year = 2022)

Arguments

team

Team filter to select.
year

Year of data to pull

Value

Returns a tibble of team schedules

col_name types description
team_rk numeric Team rk.
team character Team-side label or team identifier.
opponent_rk numeric Opponent rk.
opponent character Opponent.
result character Result.
poss numeric Poss.
ot numeric Ot.
pre_wp numeric Pre wp.
location character Location.
w numeric Wins.
l numeric Losses.
w_conference numeric W conference.
l_conference numeric L conference.
conference_game logical Conference game.
postseason character Postseason.
year numeric 4-digit year.
day_date character Date in YYYY-MM-DD format.
game_date numeric Game date (YYYY-MM-DD).
w_proj numeric W proj.
l_proj numeric L proj.
w_conference_proj numeric W conference proj.
l_conference_proj numeric L conference proj.
date character Date in YYYY-MM-DD format.
game_id numeric Unique game identifier.
tiers_of_joy character Tiers of joy.

See Also

Other KenPom Team Functions: kp_gameplan(), kp_minutes_matrix(), kp_opptracker(), kp_player_career(), kp_team_depth_chart(), kp_team_lineups(), kp_team_player_stats(), kp_team_players()

Examples

try(kp_team_schedule(team = 'Florida St.', year = 2022))

Get Team Stats

Description

Get Team Stats

Usage

kp_teamstats(min_year, max_year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull
max_year

Last year of data to pull

Value

Returns a tibble of team stats

col_name types description
team character Team-side label or team identifier.
conf character character.
off_fg_3_pct numeric Off field goals 3 percentage (0-1 decimal).
off_fg_3_pct_rk numeric Off fg 3 pct rk.
off_fg_2_pct numeric Off field goals 2 percentage (0-1 decimal).
off_fg_2_pct_rk numeric Off fg 2 pct rk.
off_ft_pct numeric Off free throws percentage (0-1 decimal).
off_ft_pct_rk numeric Off ft pct rk.
off_blk_pct numeric Off blocks percentage (0-1 decimal).
off_blk_pct_rk numeric Off blk pct rk.
off_stl_pct numeric Off steals percentage (0-1 decimal).
off_stl_pct_rk numeric Off stl pct rk.
off_non_stl_pct numeric Off non steals percentage (0-1 decimal).
off_non_stl_pct_rk numeric Off non stl pct rk.
off_a_pct numeric Off a percentage (0-1 decimal).
off_a_pct_rk numeric Off a pct rk.
off_fg_3a_pct numeric Off field goals 3a percentage (0-1 decimal).
off_fg_3a_pct_rk numeric Off fg 3a pct rk.
adj_o numeric Adj o.
adj_o_rk numeric Adj o rk.
ncaa_seed numeric Ncaa seed.
year numeric 4-digit year.
def_fg_3_pct numeric Def field goals 3 percentage (0-1 decimal).
def_fg_3_pct_rk numeric Def fg 3 pct rk.
def_fg_2_pct numeric Def field goals 2 percentage (0-1 decimal).
def_fg_2_pct_rk numeric Def fg 2 pct rk.
def_ft_pct numeric Def free throws percentage (0-1 decimal).
def_ft_pct_rk numeric Def ft pct rk.
def_blk_pct numeric Def blocks percentage (0-1 decimal).
def_blk_pct_rk numeric Def blk pct rk.
def_stl_pct numeric Def steals percentage (0-1 decimal).
def_stl_pct_rk numeric Def stl pct rk.
def_non_stl_pct numeric Def non steals percentage (0-1 decimal).
def_non_stl_pct_rk numeric Def non stl pct rk.
def_a_pct numeric Def a percentage (0-1 decimal).
def_a_pct_rk numeric Def a pct rk.
def_fg_3a_pct numeric Def field goals 3a percentage (0-1 decimal).
def_fg_3a_pct_rk numeric Def fg 3a pct rk.
adj_d numeric Adj d.
adj_d_rk numeric Adj d rk.

See Also

Other KenPom Ratings Functions: kp_efficiency(), kp_foul_trouble(), kp_fourfactors(), kp_height(), kp_kpoy(), kp_playerstats(), kp_pointdist(), kp_pomeroy_ratings()

Examples

try(kp_teamstats(min_year = 2019, max_year = 2021))

Get Division-I statistical trends

Description

Get Division-I statistical trends

Usage

kp_trends()

Value

A data frame with the following columns:

col_name types description
season numeric Season identifier (4-digit year or 'YYYY-YY' string).
efficiency numeric Efficiency.
tempo numeric Tempo.
e_fg_pct numeric E field goals percentage (0-1 decimal).
to_pct numeric To percentage (0-1 decimal).
or_pct numeric Or percentage (0-1 decimal).
ft_rate numeric Ft rate.
fg_2_pct numeric Field goals 2 percentage (0-1 decimal).
fg_3_pct numeric Field goals 3 percentage (0-1 decimal).
fg_3a_pct numeric Field goals 3a percentage (0-1 decimal).
ft_pct numeric Free throw percentage (0-1).
a_pct numeric A percentage (0-1 decimal).
blk_pct numeric Blocks percentage (0-1 decimal).
stl_pct numeric Steals percentage (0-1 decimal).
non_stl_pct numeric Non steals percentage (0-1 decimal).
avg_hgt numeric Avg hgt.
continuity numeric Continuity.
home_win_pct numeric Home win percentage (0-1 decimal).
ppg numeric Points per game.

See Also

Other KP Misc. Functions: kp_arenas(), kp_fanmatch(), kp_game_attrs(), kp_hca(), kp_officials(), kp_referee()

Examples

try(kp_trends())

KenPom Login and Password credentials

Description

Save your KenPom login e-mail and password as the system environment variables KP_USER and KP_PW

Requires a subscription to KenPom.com. Uses httr2 for HTTP requests and cookie management.

Usage

login(user_email = Sys.getenv("KP_USER"), user_pw = Sys.getenv("KP_PW"))

kp_user_email()

kp_password()

has_kp_user_and_pw()

Arguments

user_email

User subscription e-mail
user_pw

User subscription password

Details

Using your KenPom subscription with the package:

Run usethis::edit_r_environ() and THEN paste the following in the new script that pops up (without quotations)

KP_USER = [email protected]
KP_PW = XXX-YOUR-PASSWORD-XXX

You can save the login information for consistent usage by adding 

KP_USER = [email protected]
KP_PW = XXX-YOUR-PASSWORD-XXX
``` \cr
to your .REnviron file (easily accessed via [**`usethis::edit_r_environ()`**](https://usethis.r-lib.org/reference/edit.html)).\cr
\cr

For less consistent usage:\cr
At the beginning of every session or within an R environment, save your login e-mail and password as the environment variables `KP_USER` and `KP_PW` (with quotations) using a command like the following.\cr
```{r}
Sys.setenv(KP_USER = "[email protected]")
Sys.setenv(KP_PW = "XXX-YOUR-PASSWORD-XXX")

Get KenPom Win Probability

Description

Get KenPom Win Probability

Usage

kp_winprob(game_id, year)

Arguments

game_id

Game id of game to pull
year

Year of game to pull

Value

Returns a named list of tibbles: winprob_dataset, game_data, runs

winprob_dataset

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
wp numeric Wp.
time_left numeric Time left.
visitor_score integer Visitor score.
home_score integer Home team score at the time of the play.
visitor_scoring integer Visitor scoring.
home_scoring integer Home team's scoring.
possession_team character Possession team.
possession_number character Possession number.
game_id numeric Unique game identifier.
year numeric 4-digit year.

game_data

col_name types description
game_id character Unique game identifier.
year integer 4-digit year.
full_date character Date in YYYY-MM-DD format.
date character Date in YYYY-MM-DD format.
game_time character Game start time.
venue character Venue name.
city character City.
team1 character Team1.
team1score integer Team1score.
team1_rk character Team1 rk.
team2 character Team2.
team2score integer Team2score.
team2_rk character Team2 rk.
dominance_season_rk character Dominance season rk.
tension_season_rk character Tension season rk.
excitement_season_rk character Excitement season rk.
lead_changes_season_rk character Lead changes season rk.
minimum_wp_season_rk character Minimum wp season rk.
dominance_rk character Dominance rk.
tension_rk character Tension rk.
excitement_rk character Excitement rk.
lead_changes_rk character Lead changes rk.
minimum_wp_rk character Minimum wp rk.
dominance character Dominance.
tension character Tension.
excitement character Excitement.
favchg character Favchg.
min_wp character Min wp.

runs

col_name types description
start numeric Start.
end numeric End.
visitor integer Visitor.
home integer Home.

See Also

Other KenPom Boxscore Functions: kp_box()

Examples

try(kp_winprob(game_id = 1238, year = 2020))

Load cleaned MBB per-game rosters from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball per-game rosters from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_game_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB per-game rosters.

Load cleaned MBB per-game officials from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball per-game officials from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_officials(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB per-game officials.

Load hoopR men's college basketball play-by-play

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_mbb_pbp(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given men's college basketball seasons. (Min: 2006)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
id numeric Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
type_id character Type identifier (numeric).
type_text character Display text for the type field.
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
team_id character Unique team identifier.
participants_0_athlete_id character V2 PBP participant 0 (primary) athlete ID.
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
participants_1_athlete_id character V2 PBP participant 1 (secondary) athlete ID.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_mascot character Away team mascot.
away_team_abbrev character Away team three-letter abbreviation.
away_team_name_alt character Alternate away team name.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_mascot character Home team mascot.
home_team_abbrev character Home team three-letter abbreviation.
home_team_name_alt character Alternate home team name.
home_team_spread numeric Home team's point spread.
game_spread numeric Game spread (signed; positive = home favored).
home_favorite logical TRUE if the home team is the betting favorite.
game_spread_available logical TRUE if a point spread was available.
game_id integer Unique game identifier.
qtr integer Quarter (1-4) or OT period (5+).
time character Time / clock value.
clock_minutes character Clock minutes split out for convenience.
clock_seconds character Clock seconds split out for convenience.
half character Half of the game (1 or 2).
game_half character Half of the game (1 or 2).
lag_qtr numeric Quarter lag (the previous-play's quarter).
lead_qtr numeric Quarter lead (the next-play's quarter).
lag_game_half character Half lag (the previous-play's half).
lead_game_half character Half lead (the next-play's half).
start_quarter_seconds_remaining integer Seconds remaining in the period at the start of the play.
start_half_seconds_remaining integer Seconds remaining in the half at the start of the play.
start_game_seconds_remaining integer Seconds remaining in the game at the start of the play.
game_play_number integer Sequential play number within the game.
end_quarter_seconds_remaining numeric Seconds remaining in the period at the end of the play.
end_half_seconds_remaining numeric Seconds remaining in the half at the end of the play.
end_game_seconds_remaining numeric Seconds remaining in the game at the end of the play.
period integer Period of the game (1-4 quarters; 5+ for OT).
coordinate_x integer X coordinate on the court (half-court layout).
coordinate_y integer Y coordinate on the court (half-court layout).
media_id character Media identifier (video / image).

See Also

Other hoopR Loader Functions: load_mbb_player_box(), load_mbb_schedule(), load_mbb_team_box(), load_nba_pbp(), load_nba_player_box(), load_nba_schedule(), load_nba_team_box()

Examples

load_mbb_pbp(seasons = most_recent_mbb_season())

Load hoopR men's college basketball player box scores

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_mbb_player_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given men's college basketball seasons. (Min: 2003)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_schedule(), load_mbb_team_box(), load_nba_pbp(), load_nba_player_box(), load_nba_schedule(), load_nba_team_box()

Examples

load_mbb_player_box(seasons = most_recent_mbb_season())

Load cleaned MBB player season stats (long format) from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball player season stats (long format) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_player_stats(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB player season stats (long format).

Load cleaned MBB team rosters from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball team rosters from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB team rosters.

Load hoopR men's college basketball schedule

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_mbb_schedule(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given men's college basketball seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
id integer Id.
uid character ESPN UID string (universal identifier).
date character Date in YYYY-MM-DD format.
attendance integer Reported attendance.
time_valid logical Time valid.
neutral_site logical Neutral site.
conference_competition logical Conference competition.
recent logical Recent.
start_date character Start date (YYYY-MM-DD).
notes_type character Notes type.
notes_headline character Notes headline.
type_id character Type identifier (numeric).
type_abbreviation character Type abbreviation.
venue_id character Unique venue identifier.
venue_full_name character Venue full name.
venue_address_city character Venue address city.
venue_address_state character Venue address state / region.
venue_capacity integer Venue seating capacity.
venue_indoor logical TRUE if the venue is indoors.
status_clock numeric Status clock.
status_display_clock character Status display clock.
status_period integer Status period.
status_type_id character Unique identifier for status type.
status_type_name character Status type name.
status_type_state character Status type state.
status_type_completed logical Status type completed.
status_type_description character Status type description.
status_type_detail character Status type detail.
status_type_short_detail character Status type short detail.
format_regulation_periods integer Format regulation periods.
home_id character Unique identifier for home.
home_uid character Home team's uid.
home_location character Home team's location.
home_name character Home name.
home_abbreviation character Home team's abbreviation.
home_display_name character Home display name.
home_short_display_name character Home short display name.
home_color character Color code (hex) for home.
home_alternate_color character Color code (hex) for home alternate.
home_is_active logical Home team's is active.
home_venue_id character Unique identifier for home venue.
home_logo character Home team logo URL.
home_conference_id character Unique identifier for home conference.
home_score character Home team score at the time of the play.
home_winner logical Home team's winner.
away_id character Unique identifier for away.
away_uid character Away team's uid.
away_location character Away team's location.
away_name character Away name.
away_abbreviation character Away team's abbreviation.
away_display_name character Away display name.
away_short_display_name character Away short display name.
away_color character Color code (hex) for away.
away_alternate_color character Color code (hex) for away alternate.
away_is_active logical Away team's is active.
away_venue_id character Unique identifier for away venue.
away_logo character Away team logo URL.
away_conference_id character Unique identifier for away conference.
away_score character Away team score at the time of the play.
away_winner logical Away team's winner.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
status_type_alt_detail character Status type alt detail.
groups_id character Unique identifier for groups.
groups_name character Groups name.
groups_short_name character Groups short name.
groups_is_conference logical Groups is conference.
tournament_id numeric Unique identifier for tournament.
game_date_time POSIXct Game start date/time (ISO 8601).
game_date Date Game date (YYYY-MM-DD).
PBP logical
team_box logical Team box.
player_box logical Player box.

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_team_box(), load_nba_pbp(), load_nba_player_box(), load_nba_schedule(), load_nba_team_box()

Examples

load_mbb_schedule(seasons = most_recent_mbb_season())

Load cleaned MBB standings from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball standings from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_standings(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB standings.

Load hoopR men's college basketball team box scores

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_mbb_team_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given men's college basketball seasons. (Min: 2003)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
team_id character Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
field_goals_made_field_goals_attempted character Field Goals Made-Attempted.
field_goal_pct character Field goal percentage (0-1).
three_point_field_goals_made_three_point_field_goals_attempted character 3-Point Field Goals Made-Attempted.
three_point_field_goal_pct character Three-point field goal percentage (0-1).
free_throws_made_free_throws_attempted character Free Throws Made-Attempted.
free_throw_pct character Free throw percentage (0-1).
total_rebounds character Total rebounds.
offensive_rebounds character Offensive rebounds.
defensive_rebounds character Defensive rebounds.
assists character Total assists.
steals character Total steals.
blocks character Total blocks.
turnovers character Total turnovers.
team_turnovers character Team turnovers (turnovers credited to the team rather than a player).
total_turnovers character Total turnovers (player + team).
technical_fouls character Total technical fouls.
total_technical_fouls character Total technical fouls (player + team).
flagrant_fouls character Total flagrant fouls.
fouls character Personal fouls.
largest_lead character Largest lead during the game.
home_away character Game venue label ('home' or 'away').
opponent_id integer Unique identifier for opponent.
opponent_name character Opponent name.
opponent_mascot character Opponent mascot.
opponent_abbrev character Abbreviation for opponent.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_schedule(), load_nba_pbp(), load_nba_player_box(), load_nba_schedule(), load_nba_team_box()

Examples

load_mbb_team_box(seasons = most_recent_mbb_season())

Load cleaned MBB team season stats (long format) from the data repo

Description

helper that loads multiple seasons of ESPN men's college basketball team season stats (long format) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_mbb_team_stats(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given MBB seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_mbb_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the data table within the database.

Value

Returns a tibble of MBB team season stats (long format).

Load cleaned NBA draft results from the data repo

Description

helper that loads multiple seasons of ESPN NBA draft results (overall pick, round, drafted player, and team) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_draft(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA draft years. (Min: 2003)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the draft data table within the database.

Value

Returns a tibble of NBA draft picks.

Load hoopR NBA game rosters

Description

helper that loads multiple seasons of ESPN NBA per-game rosters from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_game_rosters(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the game-rosters data table within the database.

Value

Returns a tibble of per-game NBA rosters.

Load hoopR NBA officials

Description

helper that loads multiple seasons of ESPN NBA per-game officials from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_officials(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the officials data table within the database.

Value

Returns a tibble of per-game NBA officials.

Load hoopR NBA play-by-play

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_nba_pbp(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
id numeric Id.
sequence_number character Sequence number representing a shot-possession (V3 PBP).
type_id integer Type identifier (numeric).
type_text character Display text for the type field.
text character Text description of the play / record.
away_score integer Away team score at the time of the play.
home_score integer Home team score at the time of the play.
period_number integer Numeric period (1-4 for quarters; 5+ for OT).
period_display_value character Period display label (e.g. '1st Quarter', 'OT').
clock_display_value character Game clock display string (e.g. '8:32').
scoring_play logical TRUE if the play resulted in points scored.
score_value integer Point value of the play (2 / 3 / 1).
team_id integer Unique team identifier.
athlete_id_1 integer Primary athlete identifier (e.g. shooter).
athlete_id_2 integer Secondary athlete identifier (e.g. assister / fouler).
athlete_id_3 integer Athlete id 3.
wallclock character Wallclock.
shooting_play logical TRUE if the play was a shooting attempt.
coordinate_x_raw numeric X coordinate as returned by the API before any adjustment.
coordinate_y_raw numeric Y coordinate as returned by the API before any adjustment.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_mascot character Away team mascot.
away_team_abbrev character Away team three-letter abbreviation.
away_team_name_alt character Alternate away team name.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_mascot character Home team mascot.
home_team_abbrev character Home team three-letter abbreviation.
home_team_name_alt character Alternate home team name.
home_team_spread numeric Home team's point spread.
game_spread numeric Game spread (signed; positive = home favored).
home_favorite logical TRUE if the home team is the betting favorite.
game_spread_available logical TRUE if a point spread was available.
game_id integer Unique game identifier.
qtr integer Quarter (1-4) or OT period (5+).
time character Time / clock value.
clock_minutes integer Clock minutes split out for convenience.
clock_seconds numeric Clock seconds split out for convenience.
half character Half of the game (1 or 2).
game_half character Half of the game (1 or 2).
lead_qtr integer Quarter lead (the next-play's quarter).
lead_game_half character Half lead (the next-play's half).
start_quarter_seconds_remaining integer Seconds remaining in the period at the start of the play.
start_half_seconds_remaining integer Seconds remaining in the half at the start of the play.
start_game_seconds_remaining integer Seconds remaining in the game at the start of the play.
game_play_number integer Sequential play number within the game.
end_quarter_seconds_remaining integer Seconds remaining in the period at the end of the play.
end_half_seconds_remaining integer Seconds remaining in the half at the end of the play.
end_game_seconds_remaining integer Seconds remaining in the game at the end of the play.
period integer Period of the game (1-4 quarters; 5+ for OT).
lag_qtr integer Quarter lag (the previous-play's quarter).
lag_game_half character Half lag (the previous-play's half).
coordinate_x numeric X coordinate on the court (half-court layout).
coordinate_y numeric Y coordinate on the court (half-court layout).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
type_abbreviation character Type abbreviation.

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_schedule(), load_mbb_team_box(), load_nba_player_box(), load_nba_schedule(), load_nba_team_box()

Examples

load_nba_pbp(seasons = most_recent_nba_season())

Load hoopR NBA player box scores

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_nba_player_box(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
athlete_id integer Unique athlete identifier (ESPN).
athlete_display_name character Athlete display name (full).
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_location character Team city or location string.
team_short_display_name character Short team display name (e.g. 'Aces').
minutes numeric Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
offensive_rebounds integer Offensive rebounds.
defensive_rebounds integer Defensive rebounds.
rebounds integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls integer Personal fouls.
plus_minus character Plus/minus point differential while on court.
points integer Points scored.
starter logical TRUE if the player was in the starting lineup; FALSE otherwise.
ejected logical TRUE if the player was ejected from the game.
did_not_play logical TRUE if the player did not appear in the game.
reason character Reason.
active logical TRUE if the row represents an active record (player / team / season).
athlete_jersey character Athlete jersey number.
athlete_short_name character Athlete short display name.
athlete_headshot_href character Athlete headshot image URL.
athlete_position_name character Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation character Athlete position abbreviation (G / F / C).
team_display_name character Full team display name.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo character Team logo image URL.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
home_away character Game venue label ('home' or 'away').
team_winner logical TRUE if the team won this game.
team_score integer Team's score / final score.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_name character Opponent team display name.
opponent_team_location character Opponent team city / location.
opponent_team_display_name character Opponent team full display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_logo character Opponent team logo URL.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_score integer Opponent team's score.

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_schedule(), load_mbb_team_box(), load_nba_pbp(), load_nba_schedule(), load_nba_team_box()

Examples

load_nba_player_box(seasons = most_recent_nba_season())

Load cleaned NBA player season stats from the data repo

Description

helper that loads multiple seasons of ESPN NBA per-player season stats (averages / totals / miscellaneous categories, long format) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_player_stats(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the player season stats data table within the database.

Value

Returns a tibble of NBA player season stats (long format).

Load cleaned NBA team rosters from the data repo

Description

helper that loads multiple seasons of ESPN NBA team rosters (one row per athlete) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots. NOTE: ESPN's roster endpoint returns the current roster, so season files are snapshots as-of-scrape rather than true historical rosters.

Usage

load_nba_rosters(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the rosters data table within the database.

Value

Returns a tibble of NBA team rosters.

Load hoopR NBA schedules

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_nba_schedule(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
id integer Id.
uid character ESPN UID string (universal identifier).
date character Date in YYYY-MM-DD format.
attendance integer Reported attendance.
time_valid logical Time valid.
neutral_site logical Neutral site.
conference_competition logical Conference competition.
recent logical Recent.
start_date character Start date (YYYY-MM-DD).
notes_type character Notes type.
notes_headline character Notes headline.
type_id integer Type identifier (numeric).
type_abbreviation character Type abbreviation.
venue_id integer Unique venue identifier.
venue_full_name character Venue full name.
venue_address_city character Venue address city.
venue_capacity integer Venue seating capacity.
venue_indoor logical TRUE if the venue is indoors.
status_clock integer Status clock.
status_display_clock character Status display clock.
status_period integer Status period.
status_type_id integer Unique identifier for status type.
status_type_name character Status type name.
status_type_state character Status type state.
status_type_completed logical Status type completed.
status_type_description character Status type description.
status_type_detail character Status type detail.
status_type_short_detail character Status type short detail.
format_regulation_periods integer Format regulation periods.
home_id integer Unique identifier for home.
home_uid character Home team's uid.
home_location character Home team's location.
home_name character Home name.
home_abbreviation character Home team's abbreviation.
home_display_name character Home display name.
home_short_display_name character Home short display name.
home_color character Color code (hex) for home.
home_alternate_color character Color code (hex) for home alternate.
home_is_active logical Home team's is active.
home_venue_id integer Unique identifier for home venue.
home_logo character Home team logo URL.
home_score integer Home team score at the time of the play.
home_winner logical Home team's winner.
away_id integer Unique identifier for away.
away_uid character Away team's uid.
away_location character Away team's location.
away_name character Away name.
away_abbreviation character Away team's abbreviation.
away_display_name character Away display name.
away_short_display_name character Away short display name.
away_color character Color code (hex) for away.
away_alternate_color character Color code (hex) for away alternate.
away_is_active logical Away team's is active.
away_venue_id integer Unique identifier for away venue.
away_logo character Away team logo URL.
away_score integer Away team score at the time of the play.
away_winner logical Away team's winner.
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
venue_address_state character Venue address state / region.
status_type_alt_detail character Status type alt detail.
PBP logical
team_box logical Team box.
player_box logical Player box.
game_date_time POSIXct Game start date/time (ISO 8601).
game_date Date Game date (YYYY-MM-DD).

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_schedule(), load_mbb_team_box(), load_nba_pbp(), load_nba_player_box(), load_nba_team_box()

Examples

load_nba_schedule(seasons = most_recent_nba_season())

Load hoopR NBA standings

Description

helper that loads multiple seasons of ESPN NBA standings from the sportsdataverse-data release repo (tidy long format: one row per team-per-stat), either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_standings(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the standings data table within the database.

Value

Returns a tibble of per-season NBA standings.

Load hoopR NBA team box scores

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

Usage

load_nba_team_box(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by
tablename

The name of the play by play data table within the database

Value

Returns a tibble

col_name types description
game_id integer Unique game identifier.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
season_type integer Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date Date Game date (YYYY-MM-DD).
game_date_time POSIXct Game start date/time (ISO 8601).
team_id integer Unique team identifier.
team_uid character ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location character Team city or location string.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_display_name character Full team display name.
team_short_display_name character Short team display name (e.g. 'Aces').
team_color character Team primary color (hex without leading '#').
team_alternate_color character Team alternate color (hex without leading '#').
team_logo character Team logo image URL.
team_home_away character Team home away.
team_score integer Team's score / final score.
team_winner logical TRUE if the team won this game.
assists integer Total assists.
blocks integer Total blocks.
defensive_rebounds integer Defensive rebounds.
fast_break_points character Fast-break points scored.
field_goal_pct numeric Field goal percentage (0-1).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
flagrant_fouls integer Total flagrant fouls.
fouls integer Personal fouls.
free_throw_pct numeric Free throw percentage (0-1).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
largest_lead character Largest lead during the game.
offensive_rebounds integer Offensive rebounds.
points_in_paint character Points scored in the paint.
steals integer Total steals.
team_turnovers integer Team turnovers (turnovers credited to the team rather than a player).
technical_fouls integer Total technical fouls.
three_point_field_goal_pct numeric Three-point field goal percentage (0-1).
three_point_field_goals_made integer Three-point field goals made.
three_point_field_goals_attempted integer Three-point field goal attempts.
total_rebounds integer Total rebounds.
total_technical_fouls integer Total technical fouls (player + team).
total_turnovers integer Total turnovers (player + team).
turnover_points character Turnover points.
turnovers integer Total turnovers.
opponent_team_id integer Unique identifier for the opponent team.
opponent_team_uid character Opponent team uid.
opponent_team_slug character Opponent team slug.
opponent_team_location character Opponent team city / location.
opponent_team_name character Opponent team display name.
opponent_team_abbreviation character Opponent team abbreviation.
opponent_team_display_name character Opponent team full display name.
opponent_team_short_display_name character Opponent team short display name.
opponent_team_color character Opponent team primary color (hex).
opponent_team_alternate_color character Opponent team alternate color (hex).
opponent_team_logo character Opponent team logo URL.
opponent_team_score integer Opponent team's score.

See Also

Other hoopR Loader Functions: load_mbb_pbp(), load_mbb_player_box(), load_mbb_schedule(), load_mbb_team_box(), load_nba_pbp(), load_nba_player_box(), load_nba_schedule()

Examples

load_nba_team_box(seasons = most_recent_nba_season())

Load cleaned NBA team season stats from the data repo

Description

helper that loads multiple seasons of ESPN NBA per-team season stats (general / offensive / defensive categories, long format) from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

Usage

load_nba_team_stats(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_nba_db()).
dbConnection

A DBIConnection object, as returned by DBI::dbConnect().
tablename

The name of the team season stats data table within the database.

Value

Returns a tibble of NBA team season stats (long format).

Most Recent Men's College Basketball Season

Description

Most Recent Men's College Basketball Season

Usage

most_recent_mbb_season()

Most Recent NBA Season

Description

Most Recent NBA Season

Usage

most_recent_nba_season()

Get NBA Stats API All-time Leaders Grid

Description

Get NBA Stats API All-time Leaders Grid

Get NBA Stats API All-time Leaders Grid

Usage

nba_alltimeleadersgrids(
  league_id = "00",
  per_mode = "PerGame",
  season_type = "Regular Season",
  top_x = 10,
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
season_type

Season Type - Regular Season, Playoffs, All-Star
top_x

Top X
...

Additional arguments passed to an underlying function like httr.

Details

 nba_alltimeleadersgrids(league_id = '00')

Value

Returns a named list of data frames: ASTLeaders, BLKLeaders, DREBLeaders, FG3ALeaders, FG3MLeaders, FG3_PCTLeaders, FGALeaders, FGMLeaders, FG_PCTLeaders, FTALeaders, FTMLeaders, FT_PCTLeaders, GPLeaders, OREBLeaders, PFLeaders, PTSLeaders, REBLeaders, STLLeaders, TOVLeaders

GPLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
GP_RANK character
IS_ACTIVE_FLAG character

PTSLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PTS character Points scored.
PTS_RANK character
IS_ACTIVE_FLAG character

ASTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
AST character Assists.
AST_RANK character
IS_ACTIVE_FLAG character

STLLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
STL character Steals.
STL_RANK character
IS_ACTIVE_FLAG character

OREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
OREB character Offensive rebounds.
OREB_RANK character
IS_ACTIVE_FLAG character

DREBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
DREB character Defensive rebounds.
DREB_RANK character
IS_ACTIVE_FLAG character

REBLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
REB character Total rebounds.
REB_RANK character
IS_ACTIVE_FLAG character

BLKLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
BLK character Blocks.
BLK_RANK character
IS_ACTIVE_FLAG character

FGMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGM_RANK character
IS_ACTIVE_FLAG character

FGALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGA character Field goal attempts.
FGA_RANK character
IS_ACTIVE_FLAG character

FG_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG_PCT character Field goal percentage (0-1).
FG_PCT_RANK character
IS_ACTIVE_FLAG character

TOVLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TOV character Turnovers.
TOV_RANK character
IS_ACTIVE_FLAG character

FG3MLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3M character Three-point field goals made.
FG3M_RANK character
IS_ACTIVE_FLAG character

FG3ALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3A character Three-point field goal attempts.
FG3A_RANK character
IS_ACTIVE_FLAG character

FG3_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FG3_PCT character Three-point field goal percentage (0-1).
FG3_PCT_RANK character
IS_ACTIVE_FLAG character

PFLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PF character Personal fouls.
PF_RANK character
IS_ACTIVE_FLAG character

FTMLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTM character Free throws made.
FTM_RANK character
IS_ACTIVE_FLAG character

FTALeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FTA character Free throw attempts.
FTA_RANK character
IS_ACTIVE_FLAG character

FT_PCTLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FT_PCT character Free throw percentage (0-1).
FT_PCT_RANK character
IS_ACTIVE_FLAG character

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Assist Leaders

Description

Get NBA Stats API Assist Leaders

Get NBA Stats API Assist Leaders

Usage

nba_assistleaders(
  league_id = "00",
  per_mode = "PerGame",
  player_or_team = "Team",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
player_or_team

Player or Team
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_assistleaders(league_id = '00', player_or_team = "Player")
 nba_assistleaders(league_id = '00', player_or_team = "Team")

Value

Returns a named list of data frames: AssistLeaders

AssistLeaders

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
AST character Assists.

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Assist Tracker

Description

Get NBA Stats API Assist Tracker

Get NBA Stats API Assist Tracker

Usage

nba_assisttracker(
  league_id = "00",
  per_mode = "PerGame",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

  nba_assisttracker(league_id = '00')

Value

Returns a named list of data frames: AssistTracker

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Boxscore Advanced V2

Description

Get NBA Stats API Boxscore Advanced V2

Get NBA Stats API Boxscore Advanced V2

Usage

nba_boxscoreadvancedv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreadvancedv2(game_id = "0022200021")

Value

Returns a named list of data frames: PlayerStats, TeamStats

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
E_OFF_RATING character
OFF_RATING character Offensive rating (points produced per 100 possessions).
E_DEF_RATING character
DEF_RATING character Defensive rating (points allowed per 100 possessions).
E_NET_RATING character
NET_RATING character Net rating (off rating - def rating).
AST_PCT character Assist percentage (0-1).
AST_TOV character
AST_RATIO character Assist ratio (assists per 100 possessions used).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
REB_PCT character Total rebound percentage (0-1).
TM_TOV_PCT character
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
USG_PCT character Usage percentage (0-1).
E_USG_PCT character
E_PACE character
PACE character Possessions per 48 minutes.
PACE_PER40 character Pace per40.
POSS character Poss.
PIE character Player Impact Estimate (0-1).

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
E_OFF_RATING character
OFF_RATING character Offensive rating (points produced per 100 possessions).
E_DEF_RATING character
DEF_RATING character Defensive rating (points allowed per 100 possessions).
E_NET_RATING character
NET_RATING character Net rating (off rating - def rating).
AST_PCT character Assist percentage (0-1).
AST_TOV character
AST_RATIO character Assist ratio (assists per 100 possessions used).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
REB_PCT character Total rebound percentage (0-1).
E_TM_TOV_PCT character
TM_TOV_PCT character
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
USG_PCT character Usage percentage (0-1).
E_USG_PCT character
E_PACE character
PACE character Possessions per 48 minutes.
PACE_PER40 character Pace per40.
POSS character Poss.
PIE character Player Impact Estimate (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Advanced V3

Description

Get NBA Stats API Boxscore Advanced V3

Get NBA Stats API Boxscore Advanced V3

Usage

nba_boxscoreadvancedv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreadvancedv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_advanced, away_team_player_advanced, home_team_totals_advanced, away_team_totals_advanced

home_team_player_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

away_team_player_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

home_team_totals_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
estimated_team_turnover_percentage numeric Estimated team turnover percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

away_team_totals_advanced

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_rating numeric Estimated offensive rating (points per 100 possessions estimate).
offensive_rating numeric Offensive rating (points per 100 possessions).
estimated_defensive_rating numeric Estimated defensive rating (points allowed per 100 possessions estimate).
defensive_rating numeric Defensive rating (points allowed per 100 possessions).
estimated_net_rating numeric Estimated net rating (off rating - def rating).
net_rating numeric Net rating (off rating - def rating).
assist_percentage numeric Assist percentage (0-1).
assist_to_turnover numeric Assist-to-turnover ratio.
assist_ratio numeric Assist ratio (assists per 100 possessions used).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
defensive_rebound_percentage numeric Defensive rebound percentage (0-1).
rebound_percentage numeric Total rebound percentage (0-1).
estimated_team_turnover_percentage numeric Estimated team turnover percentage (0-1).
turnover_ratio numeric Turnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
true_shooting_percentage numeric True shooting percentage (0-1).
usage_percentage numeric Usage percentage (0-1).
estimated_usage_percentage numeric Estimated usage percentage (0-1).
estimated_pace numeric Estimated possessions per 48 minutes.
pace numeric Possessions per 48 minutes.
pace_per40 numeric Pace per40.
possessions numeric Possessions used.
pie numeric Player Impact Estimate (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Defensive

Description

Get NBA Stats API Boxscore Defensive

Get NBA Stats API Boxscore Defensive

Usage

nba_boxscoredefensive(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Deprecated) 

 nba_boxscoredefensive(game_id = "0022200021")

Value

Returns a named list of data frames: PlayerDefensiveStats, Table1

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Defensive V2

Description

Get NBA Stats API Boxscore Defensive V2

Get NBA Stats API Boxscore Defensive V2

Usage

nba_boxscoredefensivev2(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoredefensivev2(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_defensive, away_team_player_defensive, home_team_totals_defensive, away_team_totals_defensive

home_team_player_defensive

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
matchup_minutes character Matchup minutes.
partial_possessions numeric Partial possessions.
switches_on integer Switches on.
player_points integer Player points.
defensive_rebounds integer Defensive rebounds.
matchup_assists integer Matchup assists.
matchup_turnovers integer Matchup turnovers.
steals integer Total steals.
blocks integer Total blocks.
matchup_field_goals_made integer Number of matchup field goals made.
matchup_field_goals_attempted integer Number of matchup field goals attempted.
matchup_field_goal_percentage numeric Matchup field goal percentage (0-1 decimal).
matchup_three_pointers_made integer Number of matchup three pointers made.
matchup_three_pointers_attempted integer Number of matchup three pointers attempted.
matchup_three_pointer_percentage numeric Matchup three pointer percentage (0-1 decimal).

away_team_player_defensive

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
matchup_minutes character Matchup minutes.
partial_possessions numeric Partial possessions.
switches_on integer Switches on.
player_points integer Player points.
defensive_rebounds integer Defensive rebounds.
matchup_assists integer Matchup assists.
matchup_turnovers integer Matchup turnovers.
steals integer Total steals.
blocks integer Total blocks.
matchup_field_goals_made integer Number of matchup field goals made.
matchup_field_goals_attempted integer Number of matchup field goals attempted.
matchup_field_goal_percentage numeric Matchup field goal percentage (0-1 decimal).
matchup_three_pointers_made integer Number of matchup three pointers made.
matchup_three_pointers_attempted integer Number of matchup three pointers attempted.
matchup_three_pointer_percentage numeric Matchup three pointer percentage (0-1 decimal).

home_team_totals_defensive

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').

away_team_totals_defensive

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Four Factors V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscorefourfactorsv3() instead.

Usage

nba_boxscorefourfactorsv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorefourfactorsv2(game_id = "0022200021")

Value

Returns a named list of data frames: sqlPlayersFourFactors, sqlTeamFourFactors

sqlPlayersFourFactors

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
EFG_PCT character Effective field goal percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_TOV_PCT character
OREB_PCT character Offensive rebound percentage (0-1).
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character
OPP_OREB_PCT character

sqlTeamsFourFactors

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
EFG_PCT character Effective field goal percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_TOV_PCT character
OREB_PCT character Offensive rebound percentage (0-1).
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character
OPP_OREB_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Four Factors V3

Description

Get NBA Stats API Boxscore Four Factors V3

Get NBA Stats API Boxscore Four Factors V3

Usage

nba_boxscorefourfactorsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorefourfactorsv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_four_factors, away_team_player_four_factors, home_team_totals_four_factors, away_team_totals_four_factors

home_team_player_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

away_team_player_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

home_team_totals_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

away_team_totals_four_factors

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentage numeric Effective field goal percentage (0-1).
free_throw_attempt_rate numeric Free throw attempt rate (FTA / FGA).
team_turnover_percentage numeric Team turnover percentage (0-1).
offensive_rebound_percentage numeric Offensive rebound percentage (0-1).
opp_effective_field_goal_percentage numeric Opponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_rate numeric Opponent free throw attempt rate.
opp_team_turnover_percentage numeric Opponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentage numeric Opponent offensive rebound percentage (0-1 decimal).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Hustle V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_hustlestatsboxscore() instead.

Usage

nba_boxscorehustlev2(game_id = "0022200021", ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorehustlev2(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_hustle, away_team_player_hustle, home_team_hustle_totals, away_team_hustle_totals

home_team_player_hustle

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points integer Points scored.
contested_shots integer Defensively contested shots.
contested_shots2pt integer Contested shots2pt.
contested_shots3pt integer Contested shots3pt.
deflections integer Defensive deflections.
charges_drawn integer Charges drawn.
screen_assists integer Screen assists (resulting in a basket).
screen_assist_points integer Points generated from screen assists.
loose_balls_recovered_offensive integer Loose balls recovered on offense.
loose_balls_recovered_defensive integer Loose balls recovered on defense.
loose_balls_recovered_total integer Loose balls recovered total.
offensive_box_outs integer Offensive box outs.
defensive_box_outs integer Defensive box outs.
box_out_player_team_rebounds integer Box-outs that led to either a player or team rebound.
box_out_player_rebounds integer Box-outs that led to a player rebound.
box_outs integer Box-outs executed.

away_team_player_hustle

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points integer Points scored.
contested_shots integer Defensively contested shots.
contested_shots2pt integer Contested shots2pt.
contested_shots3pt integer Contested shots3pt.
deflections integer Defensive deflections.
charges_drawn integer Charges drawn.
screen_assists integer Screen assists (resulting in a basket).
screen_assist_points integer Points generated from screen assists.
loose_balls_recovered_offensive integer Loose balls recovered on offense.
loose_balls_recovered_defensive integer Loose balls recovered on defense.
loose_balls_recovered_total integer Loose balls recovered total.
offensive_box_outs integer Offensive box outs.
defensive_box_outs integer Defensive box outs.
box_out_player_team_rebounds integer Box-outs that led to either a player or team rebound.
box_out_player_rebounds integer Box-outs that led to a player rebound.
box_outs integer Box-outs executed.

home_team_totals_hustle

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points integer Points scored.
contested_shots integer Defensively contested shots.
contested_shots2pt integer Contested shots2pt.
contested_shots3pt integer Contested shots3pt.
deflections integer Defensive deflections.
charges_drawn integer Charges drawn.
screen_assists integer Screen assists (resulting in a basket).
screen_assist_points integer Points generated from screen assists.
loose_balls_recovered_offensive integer Loose balls recovered on offense.
loose_balls_recovered_defensive integer Loose balls recovered on defense.
loose_balls_recovered_total integer Loose balls recovered total.
offensive_box_outs integer Offensive box outs.
defensive_box_outs integer Defensive box outs.
box_out_player_team_rebounds integer Box-outs that led to either a player or team rebound.
box_out_player_rebounds integer Box-outs that led to a player rebound.
box_outs integer Box-outs executed.

away_team_totals_hustle

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points integer Points scored.
contested_shots integer Defensively contested shots.
contested_shots2pt integer Contested shots2pt.
contested_shots3pt integer Contested shots3pt.
deflections integer Defensive deflections.
charges_drawn integer Charges drawn.
screen_assists integer Screen assists (resulting in a basket).
screen_assist_points integer Points generated from screen assists.
loose_balls_recovered_offensive integer Loose balls recovered on offense.
loose_balls_recovered_defensive integer Loose balls recovered on defense.
loose_balls_recovered_total integer Loose balls recovered total.
offensive_box_outs integer Offensive box outs.
defensive_box_outs integer Defensive box outs.
box_out_player_team_rebounds integer Box-outs that led to either a player or team rebound.
box_out_player_rebounds integer Box-outs that led to a player rebound.
box_outs integer Box-outs executed.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Matchups

Description

Get NBA Stats API Boxscore Matchups

Get NBA Stats API Boxscore Matchups

Usage

nba_boxscorematchups(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Deprecated) 

 nba_boxscorematchups(game_id = "0022200021")

Value

Returns a named list of data frames: PlayerMatchupsStats

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Matchups V3

Description

Get NBA Stats API Boxscore Matchups V3

Get NBA Stats API Boxscore Matchups V3

Usage

nba_boxscorematchupsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorematchupsv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_matchups, away_team_player_matchups

home_team_player_matchups

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
matchups_person_id integer Unique identifier for matchups person.
matchups_first_name character Matchups first name.
matchups_family_name character Matchups family name.
matchups_name_i character Matchups name i.
matchups_player_slug character Matchups player slug.
matchups_jersey_num character Matchups jersey num.
matchup_minutes character Matchup minutes.
matchup_minutes_sort numeric Matchup minutes sort.
partial_possessions numeric Partial possessions.
percentage_defender_total_time numeric Time / clock value.
percentage_offensive_total_time numeric Time / clock value.
percentage_total_time_both_on numeric Percentage total time both on.
switches_on integer Switches on.
player_points integer Player points.
team_points integer Team points.
matchup_assists integer Matchup assists.
matchup_potential_assists integer Matchup potential assists.
matchup_turnovers integer Matchup turnovers.
matchup_blocks integer Matchup blocks.
matchup_field_goals_made integer Number of matchup field goals made.
matchup_field_goals_attempted integer Number of matchup field goals attempted.
matchup_field_goals_percentage numeric Matchup field goals percentage (0-1 decimal).
matchup_three_pointers_made integer Number of matchup three pointers made.
matchup_three_pointers_attempted integer Number of matchup three pointers attempted.
matchup_three_pointers_percentage numeric Matchup three pointers percentage (0-1 decimal).
help_blocks integer Help blocks.
help_field_goals_made integer Number of help field goals made.
help_field_goals_attempted integer Number of help field goals attempted.
help_field_goals_percentage numeric Help field goals percentage (0-1 decimal).
matchup_free_throws_made integer Number of matchup free throws made.
matchup_free_throws_attempted integer Number of matchup free throws attempted.
shooting_fouls integer Shooting fouls.

away_team_player_matchups

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
matchups_person_id integer Unique identifier for matchups person.
matchups_first_name character Matchups first name.
matchups_family_name character Matchups family name.
matchups_name_i character Matchups name i.
matchups_player_slug character Matchups player slug.
matchups_jersey_num character Matchups jersey num.
matchup_minutes character Matchup minutes.
matchup_minutes_sort numeric Matchup minutes sort.
partial_possessions numeric Partial possessions.
percentage_defender_total_time numeric Time / clock value.
percentage_offensive_total_time numeric Time / clock value.
percentage_total_time_both_on numeric Percentage total time both on.
switches_on integer Switches on.
player_points integer Player points.
team_points integer Team points.
matchup_assists integer Matchup assists.
matchup_potential_assists integer Matchup potential assists.
matchup_turnovers integer Matchup turnovers.
matchup_blocks integer Matchup blocks.
matchup_field_goals_made integer Number of matchup field goals made.
matchup_field_goals_attempted integer Number of matchup field goals attempted.
matchup_field_goals_percentage numeric Matchup field goals percentage (0-1 decimal).
matchup_three_pointers_made integer Number of matchup three pointers made.
matchup_three_pointers_attempted integer Number of matchup three pointers attempted.
matchup_three_pointers_percentage numeric Matchup three pointers percentage (0-1 decimal).
help_blocks integer Help blocks.
help_field_goals_made integer Number of help field goals made.
help_field_goals_attempted integer Number of help field goals attempted.
help_field_goals_percentage numeric Help field goals percentage (0-1 decimal).
matchup_free_throws_made integer Number of matchup free throws made.
matchup_free_throws_attempted integer Number of matchup free throws attempted.
shooting_fouls integer Shooting fouls.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Misc V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscoremiscv3() instead.

Usage

nba_boxscoremiscv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoremiscv2(game_id = "0022200021")

Value

Returns a named list of data frames: sqlPlayersMisc, sqlTeamsMisc

sqlPlayersMisc

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
PTS_OFF_TOV character Points scored off opponent turnovers.
PTS_2ND_CHANCE character
PTS_FB character
PTS_PAINT character Points scored in the paint.
OPP_PTS_OFF_TOV character
OPP_PTS_2ND_CHANCE character
OPP_PTS_FB character
OPP_PTS_PAINT character
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character

sqlTeamsMisc

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
PTS_OFF_TOV character Points scored off opponent turnovers.
PTS_2ND_CHANCE character
PTS_FB character
PTS_PAINT character Points scored in the paint.
OPP_PTS_OFF_TOV character
OPP_PTS_2ND_CHANCE character
OPP_PTS_FB character
OPP_PTS_PAINT character
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Misc V3

Description

Get NBA Stats API Boxscore Misc V3

Get NBA Stats API Boxscore Misc V3

Usage

nba_boxscoremiscv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoremiscv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_misc, away_team_player_misc, home_team_totals_misc, away_team_totals_misc

home_team_player_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

away_team_player_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

home_team_totals_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

away_team_totals_misc

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnovers integer Points scored off opponent turnovers.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
points_paint integer Points scored in the paint.
opp_points_off_turnovers integer Opponent points off turnovers.
opp_points_second_chance integer Opponent points second chance.
opp_points_fast_break integer Opponent points fast break.
opp_points_paint integer Opponent points paint.
blocks integer Total blocks.
blocks_against integer Shots blocked by opponents while attempting.
fouls_personal integer Personal fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Player Tracking V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscoreplayertrackv3() instead.

Usage

nba_boxscoreplayertrackv2(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreplayertrackv2(game_id = "0022200021")

Value

Returns a named list of data frames: PlayerStats, TeamStats

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
SPD character
DIST character
ORBC character
DRBC character
RBC character
TCHS character
SAST character
FTAST character
PASS character
AST character Assists.
CFGM character
CFGA character
CFG_PCT character
UFGM character
UFGA character
UFG_PCT character
FG_PCT character Field goal percentage (0-1).
DFGM character
DFGA character
DFG_PCT character

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
DIST character
ORBC character
DRBC character
RBC character
TCHS character
SAST character
FTAST character
PASS character
AST character Assists.
CFGM character
CFGA character
CFG_PCT character
UFGM character
UFGA character
UFG_PCT character
FG_PCT character Field goal percentage (0-1).
DFGM character
DFGA character
DFG_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Other NBA Player Tracking Functions: nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Boxscore Player Tracking V3

Description

Get NBA Stats API Boxscore Player Tracking V3

Get NBA Stats API Boxscore Player Tracking V3

Usage

nba_boxscoreplayertrackv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreplayertrackv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_player_track, away_team_player_player_track, home_team_totals_player_track, away_team_totals_player_track

home_team_player_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
speed numeric Speed.
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

away_team_player_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
speed numeric Speed.
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

home_team_totals_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

away_team_totals_player_track

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
distance numeric Distance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensive integer Rebound chances offensive.
rebound_chances_defensive integer Rebound chances defensive.
rebound_chances_total integer Rebound chances total.
touches integer Touches.
secondary_assists integer Secondary assists.
free_throw_assists integer Free throw assists (passes that led to a fouled shot attempt).
passes integer Passes.
assists integer Total assists.
contested_field_goals_made integer Contested field goals made.
contested_field_goals_attempted integer Contested field goal attempts.
contested_field_goal_percentage numeric Contested field goal percentage (0-1).
uncontested_field_goals_made integer Number of uncontested field goals made.
uncontested_field_goals_attempted integer Number of uncontested field goals attempted.
uncontested_field_goals_percentage numeric Uncontested field goals percentage (0-1 decimal).
field_goal_percentage numeric Field Goal Percentage.
defended_at_rim_field_goals_made integer Field goals made allowed when defending at the rim.
defended_at_rim_field_goals_attempted integer Field goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentage numeric Field goal percentage allowed at the rim (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Scoring V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscorescoringv3() instead.

Usage

nba_boxscorescoringv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorescoringv2(game_id = "0022200021")

Value

Returns a named list of data frames: sqlPlayersScoring, sqlTeamsScoring

sqlPlayersScoring

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT character
PCT_PTS_2PT_MR character
PCT_PTS_3PT character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_OFF_TOV character
PCT_PTS_PAINT character
PCT_AST_2PM character
PCT_UAST_2PM character
PCT_AST_3PM character
PCT_UAST_3PM character
PCT_AST_FGM character
PCT_UAST_FGM character

sqlTeamsScoring

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT character
PCT_PTS_2PT_MR character
PCT_PTS_3PT character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_OFF_TOV character
PCT_PTS_PAINT character
PCT_AST_2PM character
PCT_UAST_2PM character
PCT_AST_3PM character
PCT_UAST_3PM character
PCT_AST_FGM character
PCT_UAST_FGM character

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Scoring V3

Description

Get NBA Stats API Boxscore Scoring V3

Get NBA Stats API Boxscore Scoring V3

Usage

nba_boxscorescoringv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscorescoringv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_scoring, away_team_player_scoring, home_team_totals_scoring, away_team_totals_scoring

home_team_player_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

away_team_player_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

home_team_totals_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

away_team_totals_scoring

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2pt numeric Percentage field goals attempted2pt.
percentage_field_goals_attempted3pt numeric Percentage field goals attempted3pt.
percentage_points2pt numeric Percentage points2pt.
percentage_points_midrange2pt numeric Percentage points midrange2pt.
percentage_points3pt numeric Percentage points3pt.
percentage_points_fast_break numeric Percentage points fast break.
percentage_points_free_throw numeric Percentage points free throw.
percentage_points_off_turnovers numeric Percentage points off turnovers.
percentage_points_paint numeric Percentage points paint.
percentage_assisted2pt numeric Percentage assisted2pt.
percentage_unassisted2pt numeric Percentage unassisted2pt.
percentage_assisted3pt numeric Percentage assisted3pt.
percentage_unassisted3pt numeric Percentage unassisted3pt.
percentage_assisted_fgm numeric Percentage assisted fgm.
percentage_unassisted_fgm numeric Percentage unassisted fgm.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Similarity Score

Description

Get NBA Stats API Boxscore Similarity Score

Get NBA Stats API Boxscore Similarity Score

Usage

nba_boxscoresimilarityscore(
  person_1_id = "202691",
  person_1_league_id = "00",
  person_1_season = most_recent_nba_season() - 3,
  person_1_season_type = "Regular Season",
  person_2_id = "1626164",
  person_2_league_id = "00",
  person_2_season = most_recent_nba_season() - 3,
  person_2_season_type = "Regular Season",
  ...
)

Arguments

person_1_id

person_1_id
person_1_league_id

person_1_league_id
person_1_season

person_1_season
person_1_season_type

person_1_season_type
person_2_id

person_2_id
person_2_league_id

person_2_league_id
person_2_season

person_2_season
person_2_season_type

person_2_season_type
...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Deprecated) 

z <- nba_commonallplayers()$CommonAllPlayers
klay <- z %>% dplyr::filter(DISPLAY_FIRST_LAST == 'Klay Thompson')
book <- z %>% dplyr::filter(DISPLAY_FIRST_LAST == 'Devin Booker')
nba_boxscoresimilarityscore(person_1_id = klay$PERSON_ID,
  person_1_league_id = '00',
  person_1_season = year_to_season(most_recent_nba_season() - 1),
  person_1_season_type = 'Regular Season',
  person_2_id = book$PERSON_ID,
  person_2_league_id = '00',
  person_2_season = year_to_season(most_recent_nba_season() - 1),
  person_2_season_type = 'Regular Season'
)

Value

Returns a named list of data frames: BoxScoreSimilarityScores

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Similarity Functions: nba_glalumboxscoresimilarityscore()

Get NBA Stats API Boxscore Summary V2

Description

Get NBA Stats API Boxscore Summary V2

Get NBA Stats API Boxscore Summary V2

Usage

nba_boxscoresummaryv2(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoresummaryv2(game_id = "0022200021")

Value

Returns a named list of data frames: AvailableVideo, GameInfo, GameSummary, InactivePlayers, LastMeeting, LineScore, Officials, OtherStats, SeasonSeries

GameSummary

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
GAME_STATUS_ID character Numeric game status identifier.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
GAMECODE character
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LIVE_PERIOD character
LIVE_PC_TIME character
NATL_TV_BROADCASTER_ABBREVIATION character
LIVE_PERIOD_TIME_BCAST character
WH_STATUS character Wh status.

OtherStats

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PTS_PAINT character Points scored in the paint.
PTS_2ND_CHANCE character
PTS_FB character
LARGEST_LEAD character Largest lead during the game.
LEAD_CHANGES character Lead changes.
TIMES_TIED character Times tied.
TEAM_TURNOVERS character Team turnovers (turnovers credited to the team rather than a player).
TOTAL_TURNOVERS character Total turnovers (player + team).
TEAM_REBOUNDS character Team rebounds (rebounds credited to the team rather than a player).
PTS_OFF_TO character

Officials

col_name types description
OFFICIAL_ID character Unique official / referee identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.

InactivePlayers

col_name types description
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
JERSEY_NUM character Jersey number worn by the player.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').

GameInfo

col_name types description
GAME_DATE character Game date (YYYY-MM-DD).
ATTENDANCE character Reported attendance.
GAME_TIME character Game start time.

LineScore

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME character
TEAM_NICKNAME character Team nickname.
TEAM_WINS_LOSSES character
PTS_QTR1 character
PTS_QTR2 character
PTS_QTR3 character
PTS_QTR4 character
PTS_OT1 character
PTS_OT2 character
PTS_OT3 character
PTS_OT4 character
PTS_OT5 character
PTS_OT6 character
PTS_OT7 character
PTS_OT8 character
PTS_OT9 character
PTS_OT10 character
PTS character Points scored.

LastMeeting

col_name types description
GAME_ID character Unique game identifier.
LAST_GAME_ID character
LAST_GAME_DATE_EST character
LAST_GAME_HOME_TEAM_ID character
LAST_GAME_HOME_TEAM_CITY character
LAST_GAME_HOME_TEAM_NAME character
LAST_GAME_HOME_TEAM_ABBREVIATION character
LAST_GAME_HOME_TEAM_POINTS character
LAST_GAME_VISITOR_TEAM_ID character
LAST_GAME_VISITOR_TEAM_CITY character
LAST_GAME_VISITOR_TEAM_NAME character
LAST_GAME_VISITOR_TEAM_CITY1 character
LAST_GAME_VISITOR_TEAM_POINTS character

SeasonSeries

col_name types description
GAME_ID character Unique game identifier.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
GAME_DATE_EST character Game date est.
HOME_TEAM_WINS character Home team's team wins.
HOME_TEAM_LOSSES character Home team's team losses.
SERIES_LEADER character

AvailableVideo

col_name types description
GAME_ID character Unique game identifier.
VIDEO_AVAILABLE_FLAG character Video available flag.
PT_AVAILABLE character Pt available.
PT_XYZ_AVAILABLE character Pt xyz available.
WH_STATUS character Wh status.
HUSTLE_STATUS character Hustle status.
HISTORICAL_STATUS character Historical status.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Summary V3

Description

Get NBA Stats API Boxscore Summary V3

Get NBA Stats API Boxscore Summary V3

Usage

nba_boxscoresummaryv3(game_id = "0022200021", ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoresummaryv3(game_id = "0022200021")

Value

Returns a named list of data frames: GameSummary, GameInfo, ArenaInfo, Officials, LineScore, InactivePlayers, LastFiveMeetings, OtherStats, AvailableVideo

GameSummary

col_name types description
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
duration integer Duration.
attendance integer Reported attendance.
sellout character Sellout.

GameInfo

col_name types description
game_id character Unique game identifier.
game_date character Game date (YYYY-MM-DD).
attendance integer Reported attendance.
game_duration integer Game duration.

ArenaInfo

col_name types description
game_id character Unique game identifier.
arena_id integer Unique identifier for arena.
arena_name character Arena name.
arena_city character Arena city.
arena_state character Arena state.
arena_country character Arena country.
arena_timezone character Arena timezone.

Officials

col_name types description
game_id character Unique game identifier.
person_id integer Unique player identifier (V3 endpoints).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
jersey_num character Jersey number worn by the player.

LineScore

col_name types description
game_id character Unique game identifier.
team_id integer Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_wins integer Team wins.
team_losses integer Team losses.
period1_score integer Period1 score.
period2_score integer Period2 score.
period3_score integer Period3 score.
period4_score integer Period4 score.
score integer Final score.

InactivePlayers

col_name types description
game_id character Unique game identifier.
team_id integer Unique team identifier.
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
jersey_num character Jersey number worn by the player.

LastFiveMeetings

col_name types description
recency_order integer Recency order.
game_id character Unique game identifier.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
away_team_id integer Unique identifier for the away team.
away_team_city character Away team city / location.
away_team_name character Away team name.
away_team_tricode character Away team three-letter code.
away_team_score integer Away team's score.
away_team_wins integer Away team's team wins.
away_team_losses integer Away team's team losses.
home_team_id integer Unique identifier for the home team.
home_team_city character Home team city / location.
home_team_name character Home team name.
home_team_tricode character Home team three-letter code.
home_team_score integer Home team's score.
home_team_wins integer Home team's team wins.
home_team_losses integer Home team's team losses.

OtherStats

col_name types description
game_id character Unique game identifier.
team_id integer Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
points integer Points scored.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_percentage numeric Free throw percentage (0-1 decimal).
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
points_fast_break integer Fast-break points scored.
biggest_lead integer Biggest lead.
lead_changes integer Lead changes.
times_tied integer Times tied.
biggest_scoring_run integer Biggest scoring run.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
rebounds_team integer Rebounds team.
points_from_turnovers integer Points from turnovers.
bench_points integer Points scored by the bench.

AvailableVideo

col_name types description
game_id character Unique game identifier.
video_available_flag integer Video available flag.
pt_available integer Pt available.
pt_xyz_available integer Pt xyz available.
wh_status integer Wh status.
hustle_status integer Hustle status.
historical_status integer Historical status.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Traditional V2

Description

Get NBA Stats API Boxscore Traditional V2

Get NBA Stats API Boxscore Traditional V2

Usage

nba_boxscoretraditionalv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoretraditionalv2(game_id = "0022200021")

Value

A list of data frames: PlayerStats, TeamStats, TeamStarterBenchStats

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character To.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character To.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamStarterBenchStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
STARTERS_BENCH character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TO character To.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Traditional V3

Description

Get NBA Stats API Boxscore Traditional V3

Get NBA Stats API Boxscore Traditional V3

Usage

nba_boxscoretraditionalv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '0022200021')
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoretraditionalv3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_traditional, away_team_player_traditional, home_team_totals_traditional, away_team_totals_traditional, home_team_starters_totals, away_team_starters_totals, home_team_bench_totals, away_team_bench_totals

home_team_player_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

away_team_player_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

home_team_totals_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

away_team_totals_traditional

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.
plus_minus_points numeric Plus/minus point differential while on court.

home_team_starters_totals

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.

away_team_starters_totals

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.

home_team_bench_totals

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.

away_team_bench_totals

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
three_pointers_made integer Three-point field goals made.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
free_throws_made integer Free throws made.
free_throws_attempted integer Free throw attempts.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
rebounds_offensive integer Offensive rebounds.
rebounds_defensive integer Defensive rebounds.
rebounds_total integer Total rebounds.
assists integer Total assists.
steals integer Total steals.
blocks integer Total blocks.
turnovers integer Total turnovers.
fouls_personal integer Personal fouls.
points integer Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoreusagev3()

Get NBA Stats API Boxscore Usage V2

Description

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscoreusagev3() instead.

Usage

nba_boxscoreusagev2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

start_period
end_period

end_period
start_range

start_range
end_range

end_range
range_type

range_type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreusagev2(game_id = "0022200021")

Value

Returns a named list of data frames: sqlPlayersUsage, sqlTeamsUsage

sqlPlayersUsage

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MIN character Minutes played.
USG_PCT character Usage percentage (0-1).
PCT_FGM character
PCT_FGA character
PCT_FG3M character
PCT_FG3A character
PCT_FTM character
PCT_FTA character
PCT_OREB character
PCT_DREB character
PCT_REB character
PCT_AST character
PCT_TOV character
PCT_STL character
PCT_BLK character
PCT_BLKA character
PCT_PF character
PCT_PFD character
PCT_PTS character

sqlTeamsUsage

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MIN character Minutes played.
USG_PCT character Usage percentage (0-1).
PCT_FGM character
PCT_FGA character
PCT_FG3M character
PCT_FG3A character
PCT_FTM character
PCT_FTA character
PCT_OREB character
PCT_DREB character
PCT_REB character
PCT_AST character
PCT_TOV character
PCT_STL character
PCT_BLK character
PCT_BLKA character
PCT_PF character
PCT_PFD character
PCT_PTS character

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_gamerotation(), nba_hustlestatsboxscore(), nba_live_boxscore()

Get NBA Stats API Boxscore Usage V3

Description

Get NBA Stats API Boxscore Usage V3

Get NBA Stats API Boxscore Usage V3

Usage

nba_boxscoreusagev3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

game_id

Game ID
start_period

Start period filter - default: 0
end_period

End period filter - default: 0
start_range

Start range filter (in tenths of a second) - default: 0
end_range

End range filter (in tenths of a second) - default: 0
range_type

Range type - 0: by half, 1: by period, 2: custom range
...

Additional arguments passed to an underlying function like httr.

Details

 nba_boxscoreusagev3(game_id = "0022200021")

Value

Returns a named list of data frames: home_team_player_usage, away_team_player_usage, home_team_totals_usage, away_team_totals_usage

home_team_player_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

away_team_player_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_id integer Unique player identifier (V3 endpoints).
first_name character Player's first name.
family_name character Player's family / last name.
name_i character Initialed name (e.g. 'A. Wilson').
player_slug character URL-safe player identifier.
position character Listed roster position (G, F, C, etc.).
comment character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_num character Jersey number worn by the player.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

home_team_totals_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

away_team_totals_usage

col_name types description
game_id character Unique game identifier.
away_team_id integer Unique identifier for the away team.
home_team_id integer Unique identifier for the home team.
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentage numeric Usage percentage (0-1).
percentage_field_goals_made numeric Number of percentage field goals made.
percentage_field_goals_attempted numeric Number of percentage field goals attempted.
percentage_three_pointers_made numeric Number of percentage three pointers made.
percentage_three_pointers_attempted numeric Number of percentage three pointers attempted.
percentage_free_throws_made numeric Number of percentage free throws made.
percentage_free_throws_attempted numeric Number of percentage free throws attempted.
percentage_rebounds_offensive numeric Percentage rebounds offensive.
percentage_rebounds_defensive numeric Percentage rebounds defensive.
percentage_rebounds_total numeric Percentage rebounds total.
percentage_assists numeric Percentage assists.
percentage_turnovers numeric Percentage turnovers.
percentage_steals numeric Percentage steals.
percentage_blocks numeric Percentage blocks.
percentage_blocks_allowed numeric Percentage blocks allowed.
percentage_personal_fouls numeric Percentage personal fouls.
percentage_personal_fouls_drawn numeric Percentage personal fouls drawn.
percentage_points numeric Percentage points.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore V3 Functions: nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoresummaryv3(), nba_boxscoretraditionalv3()

Get NBA Stats API All Players

Description

Get NBA Stats API All Players

Get NBA Stats API All Players

Usage

nba_commonallplayers(
  is_only_current_season = 0,
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

is_only_current_season

is_only_current_season
league_id

league_id
season

season
...

Additional arguments passed to an underlying function like httr.

Details

All Players 

  nba_commonallplayers(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: CommonAllPlayers

CommonAllPlayers

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FIRST_LAST character
ROSTERSTATUS character
FROM_YEAR character
TO_YEAR character
PLAYERCODE character
PLAYER_SLUG character URL-safe player identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CODE character
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
GAMES_PLAYED_FLAG character
OTHERLEAGUE_EXPERIENCE_CH character

Author(s)

Saiem Gilani

See Also

Other NBA Roster Functions: nba_commonplayerinfo(), nba_commonteamroster(), nba_commonteamyears()

Get NBA Stats API Player Info

Description

Get NBA Stats API Player Info

Get NBA Stats API Player Info

Usage

nba_commonplayerinfo(league_id = "00", player_id = "2544", ...)

Arguments

league_id

league_id
player_id

player_id
...

Additional arguments passed to an underlying function like httr.

Details

Player Info 

 nba_commonplayerinfo(league_id = '00', player_id = '2544')

Value

Return a named list of data frames: CommonPlayerInfo, PlayerHeadlineStats, AvailableSeasons

CommonPlayerInfo

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
DISPLAY_FIRST_LAST character
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FI_LAST character
PLAYER_SLUG character URL-safe player identifier.
BIRTHDATE character
SCHOOL character Player's school / college (when distinct from 'college').
COUNTRY character Country (full name or code).
LAST_AFFILIATION character
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
SEASON_EXP character
JERSEY character Jersey number worn by the player.
POSITION character Listed roster position (G, F, C, etc.).
ROSTERSTATUS character
GAMES_PLAYED_CURRENT_SEASON_FLAG character
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CODE character
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYERCODE character
FROM_YEAR character
TO_YEAR character
DLEAGUE_FLAG character
NBA_FLAG character
GAMES_PLAYED_FLAG character
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
GREATEST_75_FLAG character

PlayerHeadlineStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TimeFrame character
PTS character Points scored.
AST character Assists.
REB character Total rebounds.
PIE character Player Impact Estimate (0-1).

AvailableSeasons

col_name types description
SEASON_ID character Unique season identifier.

Author(s)

Saiem Gilani

See Also

Other NBA Roster Functions: nba_commonallplayers(), nba_commonteamroster(), nba_commonteamyears()

Get NBA Stats API Playoff Series

Description

Get NBA Stats API Playoff Series

Get NBA Stats API Playoff Series

Usage

nba_commonplayoffseries(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 2),
  series_id = "",
  ...
)

Arguments

league_id

league_id
season

season
series_id

series_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_commonplayoffseries(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))

Value

Return a named list of data frames: PlayoffSeries

PlayoffSeries

col_name types description
GAME_ID character Unique game identifier.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
SERIES_ID character
GAME_NUM character

Author(s)

Saiem Gilani

Get NBA Stats API Team Roster

Description

Get NBA Stats API Team Roster

Get NBA Stats API Team Roster

Usage

nba_commonteamroster(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  team_id = "1610612739",
  ...
)

Arguments

league_id

league_id
season

season
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

Team Roster 

 nba_commonteamroster(season = year_to_season(most_recent_nba_season() - 1), team_id = '1610612739')

Value

Return a named list of data frames: Coaches, CommonTeamRoster

CommonTeamRoster

col_name types description
TeamID character Teamid.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LeagueID character
PLAYER character Player.
NICKNAME character Team or athlete nickname.
PLAYER_SLUG character URL-safe player identifier.
NUM character
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
BIRTH_DATE character Date of birth (YYYY-MM-DD).
AGE character Player age (in years).
EXP character Exp.
SCHOOL character Player's school / college (when distinct from 'college').
PLAYER_ID character Unique player identifier.
HOW_ACQUIRED character

Coaches

col_name types description
TEAM_ID character Unique team identifier.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
COACH_ID character
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
COACH_NAME character
IS_ASSISTANT character
COACH_TYPE character
SORT_SEQUENCE character
SUB_SORT_SEQUENCE character

Author(s)

Saiem Gilani

See Also

Other NBA Roster Functions: nba_commonallplayers(), nba_commonplayerinfo(), nba_commonteamyears()

Get NBA Stats API Common Team Years

Description

Get NBA Stats API Common Team Years

Get NBA Stats API Common Team Years

Usage

nba_commonteamyears(league_id = "00", ...)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
...

Additional arguments passed to an underlying function like httr.

Details

 nba_commonteamyears(league_id = '00')

Value

Returns a named list of data frames: TeamYears

TeamYears

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
MIN_YEAR character
MAX_YEAR character
ABBREVIATION character Short abbreviation.

Author(s)

Saiem Gilani

See Also

Other NBA Roster Functions: nba_commonallplayers(), nba_commonplayerinfo(), nba_commonteamroster()

Get NBA Stats API Cumulative Player Stats

Description

Get NBA Stats API Cumulative Player Stats

Get NBA Stats API Cumulative Player Stats

Usage

nba_cumestatsplayer(
  game_ids = "0022000756",
  league_id = "00",
  player_id = "1629611",
  season = "2020-21",
  season_type = "Regular Season",
  team_id = "",
  ...
)

Arguments

game_ids

game_ids
league_id

league_id
player_id

player_id
season

season
season_type

season_type
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

CUME Stats 

 nba_cumestatsplayer()

Value

Return a named list of data frames: GameByGameStats, TotalPlayerStats

GameByGameStats

col_name types description
DATE_EST character
VISITOR_TEAM character
HOME_TEAM character Home team's team.
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AVG_TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
AVG_PTS character

TotalPlayerStats

col_name types description
DISPLAY_FI_LAST character
PERSON_ID character Unique player identifier (V3 endpoints).
JERSEY_NUM character Jersey number worn by the player.
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
MAX_ACTUAL_MINUTES character
MAX_ACTUAL_SECONDS character
MAX_REB character
MAX_AST character
MAX_STL character
MAX_TURNOVERS character
MAX_BLK character
MAX_PTS character
AVG_ACTUAL_MINUTES character
AVG_ACTUAL_SECONDS character
AVG_TOT_REB character
AVG_AST character
AVG_STL character
AVG_TURNOVERS character The average turnovers committed per game.
AVG_BLK character
AVG_PTS character
PER_MIN_TOT_REB character
PER_MIN_AST character
PER_MIN_STL character
PER_MIN_TURNOVERS character
PER_MIN_BLK character
PER_MIN_PTS character

Author(s)

Saiem Gilani

See Also

Other NBA Cume Functions: nba_cumestatsplayergames(), nba_cumestatsteam(), nba_cumestatsteamgames()

Get NBA Stats API Cumulative Player Game Stats

Description

Get NBA Stats API Cumulative Player Game Stats

Get NBA Stats API Cumulative Player Game Stats

Usage

nba_cumestatsplayergames(
  league_id = "00",
  location = "",
  outcome = "",
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  ...
)

Arguments

league_id

league_id
location

location
outcome

outcome
player_id

player_id
season

season
season_type

season_type
vs_conference

vs_conference
vs_division

vs_division
vs_team_id

vs_team_id
...

Additional arguments passed to an underlying function like httr.

Details

CUME Stats 

 nba_cumestatsplayergames(player_id = '2544')

Value

Returns a named list of data frames: CumeStatsPlayerGames

CumeStatsPlayerGames

col_name types description
MATCHUP character Matchup.
GAME_ID character Unique game identifier.

Author(s)

Saiem Gilani

See Also

Other NBA Cume Functions: nba_cumestatsplayer(), nba_cumestatsteam(), nba_cumestatsteamgames()

Get NBA Stats API Cumulative Team Stats

Description

Get NBA Stats API Cumulative Team Stats

Get NBA Stats API Cumulative Team Stats

Usage

nba_cumestatsteam(
  game_ids = "0022201094",
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

Arguments

game_ids

game_ids
league_id

league_id
season

season
season_type

season_type
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

CUME Stats 

 nba_cumestatsteam(game_ids = '0022201094', season = '2022-23', team_id = '1610612739')

Value

Returns a named list of data frames: GameByGameStats, TotalTeamStats

GameByGameStats

col_name types description
JERSEY_NUM character Jersey number worn by the player.
PLAYER character Player.
PERSON_ID character Unique player identifier (V3 endpoints).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
DQ character
STL character Steals.
TURNOVERS character Total turnovers.
BLK character Blocks.
PTS character Points scored.
MAX_ACTUAL_MINUTES character
MAX_ACTUAL_SECONDS character
MAX_REB character
MAX_AST character
MAX_STL character
MAX_TURNOVERS character
MAX_BLKP character
MAX_PTS character
AVG_ACTUAL_MINUTES character
AVG_ACTUAL_SECONDS character
AVG_REB character
AVG_AST character
AVG_STL character
AVG_TURNOVERS character The average turnovers committed per game.
AVG_BLKP character
AVG_PTS character
PER_MIN_REB character
PER_MIN_AST character
PER_MIN_STL character
PER_MIN_TURNOVERS character
PER_MIN_BLK character
PER_MIN_PTS character

TotalTeamStats

col_name types description
CITY character City.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
W character Wins.
L character Losses.
W_HOME character
L_HOME character
W_ROAD character
L_ROAD character
TEAM_TURNOVERS character Team turnovers (turnovers credited to the team rather than a player).
TEAM_REBOUNDS character Team rebounds (rebounds credited to the team rather than a player).
GP character Games played.
GS character Games started.
ACTUAL_MINUTES character
ACTUAL_SECONDS character
FG character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3 character
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FT character
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OFF_REB character
DEF_REB character
TOT_REB character
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOTAL_TURNOVERS character Total turnovers (player + team).
BLK character Blocks.
PTS character Points scored.
AVG_REB character
AVG_PTS character
DQ character

Author(s)

Saiem Gilani

See Also

Other NBA Cume Functions: nba_cumestatsplayer(), nba_cumestatsplayergames(), nba_cumestatsteamgames()

Get NBA Stats API Cumulative Team Game Stats

Description

Get NBA Stats API Cumulative Team Game Stats

Get NBA Stats API Cumulative Team Game Stats

Usage

nba_cumestatsteamgames(
  league_id = "00",
  location = "",
  outcome = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_id = "",
  season_type = "Regular Season",
  team_id = 1610612739,
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  ...
)

Arguments

league_id

league_id
location

location
outcome

outcome
season

season
season_id

season_id
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_team_id

vs_team_id
...

Additional arguments passed to an underlying function like httr.

Details

CUME Stats 

 nba_cumestatsteamgames(team_id = 1610612739, season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: CumeStatsTeamGames

CumeStatsTeamGames

col_name types description
MATCHUP character Matchup.
GAME_ID character Unique game identifier.

Author(s)

Saiem Gilani

See Also

Other NBA Cume Functions: nba_cumestatsplayer(), nba_cumestatsplayergames(), nba_cumestatsteam()

Get NBA Data API Play-by-Play

Description

Get NBA Data API Play-by-Play

Get NBA Data API Play-by-Play

Usage

nba_data_pbp(game_id = "0021900001", ...)

Arguments

game_id

Game ID - 10 digits, i.e. "0021900001"
...

Additional arguments passed to an underlying function like httr.

Details

 nba_data_pbp(game_id = "0021900001")

Value

Returns a tibble

col_name types description
game_id character Unique game identifier.
league character League.
period integer Period of the game (1-4 quarters; 5+ for OT).
event_num integer Sequential event number within the game (V2 PBP).
clock character Game clock value.
description character Long-form description text.
locX integer
locY integer
opt1 integer Opt1.
opt2 integer Opt2.
event_action_type integer Numeric event-action-type code (V2 PBP).
event_type integer Event / play type code (V2 PBP).
team_id integer Unique team identifier.
offense_team_id integer Unique identifier for offense team.
player1_id integer V2 PBP primary player ID (e.g. shooter / fouler).
player2_id integer V2 PBP secondary player ID (e.g. assister / fouled-by).
player3_id integer V2 PBP tertiary player ID (e.g. blocker).
home_score integer Home team score at the time of the play.
away_score integer Away team score at the time of the play.
order integer Display order within the result set.

Event Message Types (event_type):

1 -> MAKE

2 -> MISS

3 -> FreeThrow

4 -> Rebound

5 -> Turnover

6 -> Foul

7 -> Violation

8 -> Substitution

9 -> Timeout

10 -> JumpBall

11 -> Ejection

12 -> StartOfPeriod

13 -> EndOfPeriod

14 -> Empty

Author(s)

Saiem Gilani

See Also

Other NBA PBP Functions: nba_live_pbp(), nba_pbp(), nba_pbps(), nba_playbyplayv3(), nba_winprobabilitypbp()

Get NBA Stats API Defense Hub

Description

Get NBA Stats API Defense Hub

Get NBA Stats API Defense Hub

Usage

nba_defensehub(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals
player_or_team

Player or Team
player_scope

Player Scope - All Players, Rookies
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs
...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Deprecated) 

 nba_defensehub(league_id = '00', player_or_team = "Player")
 nba_defensehub(league_id = '00', player_or_team = "Team")

Value

Returns a named list of data frames: DefenseHubStat1, DefenseHubStat10, DefenseHubStat2, DefenseHubStat3, DefenseHubStat4, DefenseHubStat5, DefenseHubStat6, DefenseHubStat7, DefenseHubStat8, DefenseHubStat9

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Draft Board

Description

Get NBA Stats API Draft Board

Get NBA Stats API Draft Board

Usage

nba_draftboard(season = most_recent_nba_season() - 1, ...)

Arguments

season

season
...

Additional arguments passed to an underlying function like httr.

Details

  nba_draftboard(season = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Picks, TeamsWithoutPicks, LiveDetails

Picks

col_name types description
pick_number integer Pick number.
pick_details character Pick details.
team_id integer Unique team identifier.
team_type character Team type.
team_season integer Team season.
team_team_id integer Unique identifier for team team.
team_permalink character Team permalink.
team_app_url character URL for team app.
team_trade_details list Team trade details.
team_team_name character Team team name.
team_team_abbr character Team team abbr.
team_picked_first_round logical Team picked first round.
team_picked_second_round logical Team picked second round.
team_team_record_season character Team team record season.
team_team_record_wins_and_losses character Team team record wins and losses.
team_team_record_season_finish character Team team record season finish.
team_team_record_playoffs_finish character Team team record playoffs finish.
prospect_id integer Unique identifier for prospect.
prospect_type character Prospect type.
prospect_season integer Prospect season.
prospect_display_name character Prospect display name.
prospect_first_name character Prospect first name.
prospect_last_name character Prospect last name.
prospect_permalink character Prospect permalink.
prospect_app_url character URL for prospect app.
prospect_position character Prospect position.
prospect_weight_lbs integer Prospect weight lbs.
prospect_school character Prospect school.
prospect_status character Prospect status.
prospect_birthday character Prospect birthday.
prospect_country character Prospect country.
prospect_trade_details list Prospect trade details.
prospect_height_feet_and_inches character Prospect height feet and inches.
prospect_height_inches_only integer Prospect height inches only.

TeamsWithoutPicks

col_name types description
id integer Id.
type character Record type / category.
season integer Season identifier (4-digit year or 'YYYY-YY' string).
team_id integer Unique team identifier.
team_record data.frame Team record string (e.g. '8-3' or '8-3 Overall').
permalink character Permalink.
app_url character URL for app.
trade_details list Trade details.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbr character Team abbr.
picked_second_round logical Picked second round.
picked_first_round logical Picked first round.

LiveDetails

col_name types description
is_draft_live logical Is draft live.
live_draft_current_pick_number numeric Live draft current pick number.

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftcombinedrillresults(), nba_draftcombinenonstationaryshooting(), nba_draftcombineplayeranthro(), nba_draftcombinespotshooting(), nba_draftcombinestats(), nba_drafthistory()

Get NBA Stats API Draft Combine Drill Results

Description

Get NBA Stats API Draft Combine Drill Results

Get NBA Stats API Draft Combine Drill Results

Usage

nba_draftcombinedrillresults(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

Arguments

league_id

league_id
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

Draft Combine 

 nba_draftcombinedrillresults(season_year = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Results

Results

col_name types description
TEMP_PLAYER_ID character
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
STANDING_VERTICAL_LEAP character
MAX_VERTICAL_LEAP character
LANE_AGILITY_TIME character
MODIFIED_LANE_AGILITY_TIME character
THREE_QUARTER_SPRINT character
BENCH_PRESS character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinenonstationaryshooting(), nba_draftcombineplayeranthro(), nba_draftcombinespotshooting(), nba_draftcombinestats(), nba_drafthistory()

Get NBA Stats API Draft Combine Non-Stationary Shooting

Description

Get NBA Stats API Draft Combine Non-Stationary Shooting

Get NBA Stats API Draft Combine Non-Stationary Shooting

Usage

nba_draftcombinenonstationaryshooting(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

Arguments

league_id

league_id
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

Draft Combine Non-stationary Shooting 

 nba_draftcombinenonstationaryshooting(season_year = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Results

Results

col_name types description
TEMP_PLAYER_ID character
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
OFF_DRIB_FIFTEEN_BREAK_LEFT_MADE character
OFF_DRIB_FIFTEEN_BREAK_LEFT_ATTEMPT character
OFF_DRIB_FIFTEEN_BREAK_LEFT_PCT character
OFF_DRIB_FIFTEEN_TOP_KEY_MADE character
OFF_DRIB_FIFTEEN_TOP_KEY_ATTEMPT character
OFF_DRIB_FIFTEEN_TOP_KEY_PCT character
OFF_DRIB_FIFTEEN_BREAK_RIGHT_MADE character
OFF_DRIB_FIFTEEN_BREAK_RIGHT_ATTEMPT character
OFF_DRIB_FIFTEEN_BREAK_RIGHT_PCT character
OFF_DRIB_COLLEGE_BREAK_LEFT_MADE character
OFF_DRIB_COLLEGE_BREAK_LEFT_ATTEMPT character
OFF_DRIB_COLLEGE_BREAK_LEFT_PCT character
OFF_DRIB_COLLEGE_TOP_KEY_MADE character
OFF_DRIB_COLLEGE_TOP_KEY_ATTEMPT character
OFF_DRIB_COLLEGE_TOP_KEY_PCT character
OFF_DRIB_COLLEGE_BREAK_RIGHT_MADE character
OFF_DRIB_COLLEGE_BREAK_RIGHT_ATTEMPT character
OFF_DRIB_COLLEGE_BREAK_RIGHT_PCT character
ON_MOVE_FIFTEEN_MADE character
ON_MOVE_FIFTEEN_ATTEMPT character
ON_MOVE_FIFTEEN_PCT character
ON_MOVE_COLLEGE_MADE character
ON_MOVE_COLLEGE_ATTEMPT character
ON_MOVE_COLLEGE_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinedrillresults(), nba_draftcombineplayeranthro(), nba_draftcombinespotshooting(), nba_draftcombinestats(), nba_drafthistory()

Get NBA Stats API Draft Combine Player Anthropological Measurements

Description

Get NBA Stats API Draft Combine Player Anthropological Measurements

Get NBA Stats API Draft Combine Player Anthropological Measurements

Usage

nba_draftcombineplayeranthro(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

Arguments

league_id

league_id
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

Draft Combine Player Anthro 

 nba_draftcombineplayeranthro(season_year = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Results

Results

col_name types description
TEMP_PLAYER_ID character
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT_WO_SHOES character
HEIGHT_WO_SHOES_FT_IN character
HEIGHT_W_SHOES character
HEIGHT_W_SHOES_FT_IN character
WEIGHT character Player weight in pounds.
WINGSPAN character
WINGSPAN_FT_IN character
STANDING_REACH character
STANDING_REACH_FT_IN character
BODY_FAT_PCT character
HAND_LENGTH character
HAND_WIDTH character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinedrillresults(), nba_draftcombinenonstationaryshooting(), nba_draftcombinespotshooting(), nba_draftcombinestats(), nba_drafthistory()

Get NBA Stats API Draft Combine - Spot Shooting

Description

Get NBA Stats API Draft Combine - Spot Shooting

Get NBA Stats API Draft Combine - Spot Shooting

Usage

nba_draftcombinespotshooting(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

Arguments

league_id

league_id
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

Draft Combine Spot Shooting 

 nba_draftcombinespotshooting(season_year = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Results

Results

col_name types description
TEMP_PLAYER_ID character
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
FIFTEEN_CORNER_LEFT_MADE character
FIFTEEN_CORNER_LEFT_ATTEMPT character
FIFTEEN_CORNER_LEFT_PCT character
FIFTEEN_BREAK_LEFT_MADE character
FIFTEEN_BREAK_LEFT_ATTEMPT character
FIFTEEN_BREAK_LEFT_PCT character
FIFTEEN_TOP_KEY_MADE character
FIFTEEN_TOP_KEY_ATTEMPT character
FIFTEEN_TOP_KEY_PCT character
FIFTEEN_BREAK_RIGHT_MADE character
FIFTEEN_BREAK_RIGHT_ATTEMPT character
FIFTEEN_BREAK_RIGHT_PCT character
FIFTEEN_CORNER_RIGHT_MADE character
FIFTEEN_CORNER_RIGHT_ATTEMPT character
FIFTEEN_CORNER_RIGHT_PCT character
COLLEGE_CORNER_LEFT_MADE character
COLLEGE_CORNER_LEFT_ATTEMPT character
COLLEGE_CORNER_LEFT_PCT character
COLLEGE_BREAK_LEFT_MADE character
COLLEGE_BREAK_LEFT_ATTEMPT character
COLLEGE_BREAK_LEFT_PCT character
COLLEGE_TOP_KEY_MADE character
COLLEGE_TOP_KEY_ATTEMPT character
COLLEGE_TOP_KEY_PCT character
COLLEGE_BREAK_RIGHT_MADE character
COLLEGE_BREAK_RIGHT_ATTEMPT character
COLLEGE_BREAK_RIGHT_PCT character
COLLEGE_CORNER_RIGHT_MADE character
COLLEGE_CORNER_RIGHT_ATTEMPT character
COLLEGE_CORNER_RIGHT_PCT character
NBA_CORNER_LEFT_MADE character
NBA_CORNER_LEFT_ATTEMPT character
NBA_CORNER_LEFT_PCT character
NBA_BREAK_LEFT_MADE character
NBA_BREAK_LEFT_ATTEMPT character
NBA_BREAK_LEFT_PCT character
NBA_TOP_KEY_MADE character
NBA_TOP_KEY_ATTEMPT character
NBA_TOP_KEY_PCT character
NBA_BREAK_RIGHT_MADE character
NBA_BREAK_RIGHT_ATTEMPT character
NBA_BREAK_RIGHT_PCT character
NBA_CORNER_RIGHT_MADE character
NBA_CORNER_RIGHT_ATTEMPT character
NBA_CORNER_RIGHT_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinedrillresults(), nba_draftcombinenonstationaryshooting(), nba_draftcombineplayeranthro(), nba_draftcombinestats(), nba_drafthistory()

Get NBA Stats API Draft Combine Stats

Description

Get NBA Stats API Draft Combine Stats

Get NBA Stats API Draft Combine Stats

Usage

nba_draftcombinestats(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

Arguments

league_id

league_id
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

 nba_draftcombinestats(season_year = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: DraftCombineStats

DraftCombineStats

col_name types description
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
PLAYER_ID character Unique player identifier.
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
PLAYER_NAME character Player name.
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT_WO_SHOES character
HEIGHT_WO_SHOES_FT_IN character
HEIGHT_W_SHOES character
HEIGHT_W_SHOES_FT_IN character
WEIGHT character Player weight in pounds.
WINGSPAN character
WINGSPAN_FT_IN character
STANDING_REACH character
STANDING_REACH_FT_IN character
BODY_FAT_PCT character
HAND_LENGTH character
HAND_WIDTH character
STANDING_VERTICAL_LEAP character
MAX_VERTICAL_LEAP character
LANE_AGILITY_TIME character
MODIFIED_LANE_AGILITY_TIME character
THREE_QUARTER_SPRINT character
BENCH_PRESS character
SPOT_FIFTEEN_CORNER_LEFT character
SPOT_FIFTEEN_BREAK_LEFT character
SPOT_FIFTEEN_TOP_KEY character
SPOT_FIFTEEN_BREAK_RIGHT character
SPOT_FIFTEEN_CORNER_RIGHT character
SPOT_COLLEGE_CORNER_LEFT character
SPOT_COLLEGE_BREAK_LEFT character
SPOT_COLLEGE_TOP_KEY character
SPOT_COLLEGE_BREAK_RIGHT character
SPOT_COLLEGE_CORNER_RIGHT character
SPOT_NBA_CORNER_LEFT character
SPOT_NBA_BREAK_LEFT character
SPOT_NBA_TOP_KEY character
SPOT_NBA_BREAK_RIGHT character
SPOT_NBA_CORNER_RIGHT character
OFF_DRIB_FIFTEEN_BREAK_LEFT character
OFF_DRIB_FIFTEEN_TOP_KEY character
OFF_DRIB_FIFTEEN_BREAK_RIGHT character
OFF_DRIB_COLLEGE_BREAK_LEFT character
OFF_DRIB_COLLEGE_TOP_KEY character
OFF_DRIB_COLLEGE_BREAK_RIGHT character
ON_MOVE_FIFTEEN character
ON_MOVE_COLLEGE character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinedrillresults(), nba_draftcombinenonstationaryshooting(), nba_draftcombineplayeranthro(), nba_draftcombinespotshooting(), nba_drafthistory()

Get NBA Stats API Draft History

Description

Get NBA Stats API Draft History

Usage

nba_drafthistory(
  league_id = "00",
  college = "",
  overall_pick = "",
  round_pick = "",
  round_num = "",
  season = most_recent_nba_season() - 1,
  team_id = "",
  top_x = "",
  ...
)

Arguments

league_id

league_id
college

college
overall_pick

overall_pick
round_pick

round_pick
round_num

round_num
season

season
team_id

team_id
top_x

top_x
...

Additional arguments passed to an underlying function like httr.

Details

Draft History 

 nba_drafthistory(season = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: DraftHistory

DraftHistory

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_NAME character Player name.
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
ROUND_NUMBER character Numeric round.
ROUND_PICK character
OVERALL_PICK character
DRAFT_TYPE character
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
ORGANIZATION character
ORGANIZATION_TYPE character
PLAYER_PROFILE_FLAG character

Author(s)

Saiem Gilani

See Also

Other NBA Draft Functions: nba_draftboard(), nba_draftcombinedrillresults(), nba_draftcombinenonstationaryshooting(), nba_draftcombineplayeranthro(), nba_draftcombinespotshooting(), nba_draftcombinestats()

Get NBA Stats API Dunk Score Leaders

Description

Get NBA Stats API Dunk Score Leaders

Get NBA Stats API Dunk Score Leaders

Usage

nba_dunkscoreleaders(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  player_id = "",
  team_id = "",
  game_id = "",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format: '2023-24'
season_type

Season Type - 'Regular Season', 'Playoffs'
player_id

Player ID filter (optional, leave empty for all players)
team_id

Team ID filter (optional, leave empty for all teams)
game_id

Game ID filter (optional, leave empty for all games)
...

Additional arguments passed to an underlying function like httr.

Details

 nba_dunkscoreleaders(season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: DunkScoreLeaders

DunkScoreLeaders

col_name types description
game_id character Unique game identifier.
game_date character Game date (YYYY-MM-DD).
matchup character Matchup.
period character Period of the game (1-4 quarters; 5+ for OT).
game_clock_time character Time / clock value.
event_num character Sequential event number within the game (V2 PBP).
player_id character Unique player identifier.
player_name character Player name.
first_name character Player's first name.
last_name character Player's last name.
team_id character Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
dunk_score character Dunk score.
jump_subscore character Jump subscore.
power_subscore character Power subscore.
style_subscore character Style subscore.
defensive_contest_subscore character Defensive contest subscore.
max_ball_height character Max ball height.
ball_speed_through_rim character Ball speed through rim.
player_vertical character Player vertical.
hang_time character Time / clock value.
takeoff_distance character Takeoff distance.
reverse_dunk character Reverse dunk.
dunk360 character Dunk360.
through_the_legs character Through the legs.
alley_oop character Alley oop.
tip_in character Tip in.
self_oop character Self oop.
player_rotation character Player rotation.
player_lateral_speed character Player lateral speed.
ball_distance_traveled character Ball distance traveled.
ball_reach_back character Ball reach back.
total_ball_acceleration character Total ball acceleration.
dunking_hand character Dunking hand.
jumping_foot character Jumping foot.
pass_length character Pass length.
catching_hand character Catching hand.
catch_distance character Catch distance.
lateral_catch_distance character Lateral catch distance.
passer_id character Unique identifier for passer.
passer_name character Passer name.
passer_first_name character Passer first name.
passer_last_name character Passer last name.
pass_release_point character Pass release point.
shooter_id character Unique identifier for shooter.
shooter_name character Shooter name (for shot events).
shooter_first_name character Shooter first name.
shooter_last_name character Shooter last name.
shot_release_point character Shot release point.
shot_length character Shot length.
defensive_contest_level character Defensive contest level.
possible_attempted_charge character Possible attempted charge.
video_available character Video available.

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Fantasy Widget

Description

Get NBA Stats API Fantasy Widget

Get NBA Stats API Fantasy Widget

Usage

nba_fantasywidget(
  active_players = "N",
  date_from = "",
  date_to = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = "",
  opponent_team_id = "",
  po_round = "",
  player_id = "",
  position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  todays_opponent = 0,
  todays_players = "N",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

active_players

active_players
date_from

date_from date_from
date_to

date_to date_to
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
po_round

po_round
player_id

player_id
position

position
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
todays_opponent

todays_opponent
todays_players

todays_players
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_fantasywidget(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: FantasyWidgetResult

FantasyWidgetResult

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_POSITION character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
MIN character Minutes played.
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
BLK character Blocks.
STL character Steals.
TOV character Turnovers.
FG3M character Three-point field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Fantasy Functions: nba_infographicfanduelplayer(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph()

Get NBA Stats API Franchise History

Description

Get NBA Stats API Franchise History

Get NBA Stats API Franchise History

Usage

nba_franchisehistory(league_id = "00", ...)

Arguments

league_id

league_id
...

Additional arguments passed to an underlying function like httr.

Details

Franchise History 

 nba_franchisehistory(league_id = '00')
 nba_franchisehistory(league_id = '01')
 nba_franchisehistory(league_id = '10')
 nba_franchisehistory(league_id = '20')

Value

Returns a named list of data frames: DefunctTeams, FranchiseHistory

FranchiseHistory

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
START_YEAR character
END_YEAR character
YEARS character Years.
GAMES character
WINS character Total wins.
LOSSES character Total losses.
WIN_PCT character
PO_APPEARANCES character
DIV_TITLES character
CONF_TITLES character
LEAGUE_TITLES character

DefunctTeams

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
START_YEAR character
END_YEAR character
YEARS character Years.
GAMES character
WINS character Total wins.
LOSSES character Total losses.
WIN_PCT character
PO_APPEARANCES character
DIV_TITLES character
CONF_TITLES character
LEAGUE_TITLES character

Author(s)

Saiem Gilani

See Also

Other NBA Franchise Functions: nba_franchiseleaders(), nba_franchiseleaderswrank(), nba_franchiseplayers()

Get NBA Stats API Franchise Leaders

Description

Get NBA Stats API Franchise Leaders

Get NBA Stats API Franchise Leaders

Usage

nba_franchiseleaders(league_id = "00", team_id = "1610612739", ...)

Arguments

league_id

league_id
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

Franchise Leaders 

 nba_franchiseleaders(league_id = '00', team_id = '1610612739')

Value

Returns a named list of data frames: FranchiseLeaders

FranchiseLeaders

col_name types description
TEAM_ID character Unique team identifier.
PTS character Points scored.
PTS_PERSON_ID character
PTS_PLAYER character
AST character Assists.
AST_PERSON_ID character
AST_PLAYER character
REB character Total rebounds.
REB_PERSON_ID character
REB_PLAYER character
BLK character Blocks.
BLK_PERSON_ID character
BLK_PLAYER character
STL character Steals.
STL_PERSON_ID character
STL_PLAYER character

Author(s)

Saiem Gilani

See Also

Other NBA Franchise Functions: nba_franchisehistory(), nba_franchiseleaderswrank(), nba_franchiseplayers()

Get NBA Stats API Franchise Leaders with Rank

Description

Get NBA Stats API Franchise Leaders with Rank

Get NBA Stats API Franchise Leaders with Rank

Usage

nba_franchiseleaderswrank(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

Arguments

league_id

league_id
per_mode

per_mode
season_type

season_type
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

Franchise Players 

 nba_franchiseleaderswrank(league_id = '00', team_id = '1610612739')
 nba_franchiseleaderswrank(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')

Value

Returns a named list of data frames: FranchiseLeaderswRank

FranchiseLeaderswRank

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER character Player.
SEASON_TYPE character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
ACTIVE_WITH_TEAM character
GP character Games played.
MINUTES character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.
F_RANK_GP character
F_RANK_MINUTES character
F_RANK_FGM character
F_RANK_FGA character
F_RANK_FG_PCT character
F_RANK_FG3M character
F_RANK_FG3A character
F_RANK_FG3_PCT character
F_RANK_FTM character
F_RANK_FTA character
F_RANK_FT_PCT character
F_RANK_OREB character
F_RANK_DREB character
F_RANK_REB character
F_RANK_AST character
F_RANK_PF character
F_RANK_STL character
F_RANK_TOV character
F_RANK_BLK character
F_RANK_PTS character

Author(s)

Saiem Gilani

See Also

Other NBA Franchise Functions: nba_franchisehistory(), nba_franchiseleaders(), nba_franchiseplayers()

Get NBA Stats API Franchise Players

Description

Get NBA Stats API Franchise Players

Get NBA Stats API Franchise Players

Usage

nba_franchiseplayers(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

Arguments

league_id

league_id
per_mode

per_mode
season_type

season_type
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

Franchise Players 

 nba_franchiseplayers(league_id = '00', team_id = '1610612739')
 nba_franchiseplayers(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')

Value

Returns a named list of data frames: FranchisePlayers

FranchisePlayers

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER character Player.
SEASON_TYPE character Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
ACTIVE_WITH_TEAM character
GP character Games played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Franchise Functions: nba_franchisehistory(), nba_franchiseleaders(), nba_franchiseleaderswrank()

Get NBA Stats API Game Rotation

Description

Get NBA Stats API Game Rotation

Get NBA Stats API Game Rotation

Usage

nba_gamerotation(game_id, league_id = "00", rotation_stat = "PLAYER_PTS", ...)

Arguments

game_id

Game ID
league_id

League ID
rotation_stat

Rotation stat to provide details on: PLAYER_PTS, PT_DIFF, USG_PCT
...

Additional arguments passed to an underlying function like httr.

Details

 nba_gamerotation(game_id = "0022200021")

Value

Returns a named list of data frames: AwayTeam, HomeTeam

AwayTeam

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_FIRST character
PLAYER_LAST character
IN_TIME_REAL character
OUT_TIME_REAL character
PLAYER_PTS character
PT_DIFF character
USG_PCT character Usage percentage (0-1).

HomeTeam

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_FIRST character
PLAYER_LAST character
IN_TIME_REAL character
OUT_TIME_REAL character
PLAYER_PTS character
PT_DIFF character
USG_PCT character Usage percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_hustlestatsboxscore(), nba_live_boxscore()

Other NBA Lineup Functions: nba_leaguedashlineups(), nba_leaguelineupviz(), nba_shotchartlineupdetail(), nba_teamdashlineups()

Get NBA Stats API G-League Alum Boxscore Similarity Score

Description

Get NBA Stats API G-League Alum Boxscore Similarity Score

Get NBA Stats API G-League Alum Boxscore Similarity Score

Usage

nba_glalumboxscoresimilarityscore(
  person_1_id,
  person_1_league_id,
  person_1_season,
  person_1_season_type,
  person_2_id,
  person_2_league_id,
  person_2_season,
  person_2_season_type,
  ...
)

Arguments

person_1_id

person_1_id
person_1_league_id

person_1_league_id
person_1_season

person_1_season
person_1_season_type

person_1_season_type
person_2_id

person_2_id
person_2_league_id

person_2_league_id
person_2_season

person_2_season
person_2_season_type

person_2_season_type
...

Additional arguments passed to an underlying function like httr.

Details

(Possibly Deprecated)

Value

Returns a named list of data frames: GLeagueAlumBoxScoreSimilarityScores

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Similarity Functions: nba_boxscoresimilarityscore()

Get NBA Stats API Gravity Leaders

Description

Get NBA Stats API Gravity Leaders

Get NBA Stats API Gravity Leaders

Usage

nba_gravityleaders(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format: '2023-24'
season_type

Season Type - 'Regular Season', 'Playoffs'
...

Additional arguments passed to an underlying function like httr.

Details

 nba_gravityleaders(season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: GravityLeaders

GravityLeaders

col_name types description
playerid character Playerid.
firstname character Firstname.
lastname character Lastname.
teamid character Teamid.
teamabbreviation character Teamabbreviation.
teamname character Teamname.
teamcity character Teamcity.
frames character Frames.
gravityscore character Gravityscore.
avggravityscore character Avggravityscore.
onballperimeterframes character Onballperimeterframes.
onballperimetergravityscore character Onballperimetergravityscore.
avgonballperimetergravityscore character Avgonballperimetergravityscore.
offballperimeterframes character Offballperimeterframes.
offballperimetergravityscore character Offballperimetergravityscore.
avgoffballperimetergravityscore character Avgoffballperimetergravityscore.
onballinteriorframes character Onballinteriorframes.
onballinteriorgravityscore character Onballinteriorgravityscore.
avgonballinteriorgravityscore character Avgonballinteriorgravityscore.
offballinteriorframes character Offballinteriorframes.
offballinteriorgravityscore character Offballinteriorgravityscore.
avgoffballinteriorgravityscore character Avgoffballinteriorgravityscore.
gamesplayed character Gamesplayed.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
pts character Points scored.
reb character Total rebounds.
ast character Assists.

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Homepage Leaders

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead.

Usage

nba_homepageleaders(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_category = "Points",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals
player_or_team

Player or Team
player_scope

Player Scope - All Players, Rookies
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs
stat_category

Stat Category: Points, Rebounds, Assists, Defense, Clutch, Playmaking, Efficiency, Fast Break, Scoring Breakdown
...

Additional arguments passed to an underlying function like httr.

Details

 nba_homepageleaders(league_id = '00', player_or_team = "Player")
 nba_homepageleaders(league_id = '00', player_or_team = "Team")

Value

Returns a named list of data frames: HomePageLeaders, LeagueAverage, LeagueMax

HomePageLeaders

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PTS character Points scored.
FG_PCT character Field goal percentage (0-1).
FG3_PCT character Three-point field goal percentage (0-1).
FT_PCT character Free throw percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
TS_PCT character True shooting percentage (0-1).
PTS_PER48 character

LeagueAverage

col_name types description
PTS numeric Points scored.
FG_PCT numeric Field goal percentage (0-1).
FG3_PCT numeric Three-point field goal percentage (0-1).
FT_PCT numeric Free throw percentage (0-1).
EFG_PCT numeric Effective field goal percentage (0-1).
TS_PCT numeric True shooting percentage (0-1).
PTS_PER48 numeric

LeagueMax

col_name types description
PTS numeric Points scored.
FG_PCT numeric Field goal percentage (0-1).
FG3_PCT numeric Three-point field goal percentage (0-1).
FT_PCT numeric Free throw percentage (0-1).
EFG_PCT numeric Effective field goal percentage (0-1).
TS_PCT numeric True shooting percentage (0-1).
PTS_PER48 numeric

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepagev2(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API HomepageV2 Leaders

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead.

Usage

nba_homepagev2(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_type = "Traditional",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals
player_or_team

Player or Team
player_scope

Player Scope - All Players, Rookies
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs
stat_type

Stat Type - Traditional, Advanced, Tracking
...

Additional arguments passed to an underlying function like httr.

Details

 nba_homepagev2(league_id = '00', player_or_team = "Player")
 nba_homepagev2(league_id = '00', player_or_team = "Team")

Value

Returns a named list of data frames: HomePageStat1, HomePageStat2, HomePageStat3, HomePageStat4, HomePageStat5, HomePageStat6, HomePageStat7, HomePageStat8

HomePageStat1

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PTS character Points scored.

HomePageStat2

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
REB character Total rebounds.

HomePageStat3

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
AST character Assists.

HomePageStat4

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
STL character Steals.

HomePageStat5

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FG_PCT character Field goal percentage (0-1).

HomePageStat6

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FT_PCT character Free throw percentage (0-1).

HomePageStat7

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FG3_PCT character Three-point field goal percentage (0-1).

HomePageStat8

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
BLK character Blocks.

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_leaderstiles(), nba_leagueleaders()

Get NBA Stats API Hustle Stats Boxscore

Description

Get NBA Stats API Hustle Stats Boxscore

Get NBA Stats API Hustle Stats Boxscore

Usage

nba_hustlestatsboxscore(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_hustlestatsboxscore(game_id = "0022200021")

Value

Returns a named list of data frames: HustleStatsAvailable, PlayerStats, TeamStats

HustleStatsAvailable

col_name types description
GAME_ID character Unique game identifier.
HUSTLE_STATUS character Hustle status.

PlayerStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
START_POSITION character
COMMENT character Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
MINUTES character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
PTS character Points scored.
CONTESTED_SHOTS character Defensively contested shots.
CONTESTED_SHOTS_2PT character Contested two-point shots.
CONTESTED_SHOTS_3PT character Contested three-point shots.
DEFLECTIONS character Defensive deflections.
CHARGES_DRAWN character Charges drawn.
SCREEN_ASSISTS character Screen assists (resulting in a basket).
SCREEN_AST_PTS character
OFF_LOOSE_BALLS_RECOVERED character
DEF_LOOSE_BALLS_RECOVERED character
LOOSE_BALLS_RECOVERED character Loose balls recovered.
OFF_BOXOUTS character
DEF_BOXOUTS character
BOX_OUT_PLAYER_TEAM_REBS character
BOX_OUT_PLAYER_REBS character
BOX_OUTS character Box-outs executed.

TeamStats

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
MINUTES character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
PTS character Points scored.
CONTESTED_SHOTS character Defensively contested shots.
CONTESTED_SHOTS_2PT character Contested two-point shots.
CONTESTED_SHOTS_3PT character Contested three-point shots.
DEFLECTIONS character Defensive deflections.
CHARGES_DRAWN character Charges drawn.
SCREEN_ASSISTS character Screen assists (resulting in a basket).
SCREEN_AST_PTS character
OFF_LOOSE_BALLS_RECOVERED character
DEF_LOOSE_BALLS_RECOVERED character
LOOSE_BALLS_RECOVERED character Loose balls recovered.
OFF_BOXOUTS character
DEF_BOXOUTS character
BOX_OUT_PLAYER_TEAM_REBS character
BOX_OUT_PLAYER_REBS character
BOX_OUTS character Box-outs executed.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_live_boxscore()

Other NBA Hustle Functions: nba_leaguehustlestatsplayer(), nba_leaguehustlestatsplayerleaders(), nba_leaguehustlestatsteam(), nba_leaguehustlestatsteamleaders()

Get NBA Stats API FanDuel Player Infographic

Description

Get NBA Stats API FanDuel Player Infographic

Get NBA Stats API FanDuel Player Infographic

Usage

nba_infographicfanduelplayer(game_id, ...)

Arguments

game_id

game_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_infographicfanduelplayer(game_id = "0022201086")

Value

Return a named list of data frames: FanDuelPlayer

FanDuelPlayer

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
JERSEY_NUM character Jersey number worn by the player.
PLAYER_POSITION character
LOCATION character Location.
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
USG_PCT character Usage percentage (0-1).
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Fantasy Functions: nba_fantasywidget(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph()

Get NBA Stats API In-Season Tournament Standings

Description

Get NBA Stats API In-Season Tournament Standings

Get NBA Stats API In-Season Tournament Standings

Usage

nba_iststandings(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  section = "group",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format: '2023-24'
section

Section filter - 'group' or 'knockout'
...

Additional arguments passed to an underlying function like httr.

Details

 nba_iststandings(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: Standings

Standings

col_name types description
league_id character League identifier ('10' = WNBA).
season_year character Season year string ('YYYY-YY' format).
team_id character Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
conference character Conference.
ist_group character Ist group.
clinch_indicator character Playoff clinch indicator (e.g. 'x' clinched playoff, 'e' eliminated).
clinched_ist_knockout character Clinched ist knockout.
clinched_ist_group character Clinched ist group.
clinched_ist_wildcard character Clinched ist wildcard.
ist_wildcard_rank character League/season rank for ist wildcard.
ist_group_rank character League/season rank for ist group.
ist_knockout_rank character League/season rank for ist knockout.
wins character Total wins.
losses character Total losses.
pct character Pct.
ist_group_gb character Ist group gb.
ist_wildcard_gb character Ist wildcard gb.
diff character Diff.
pts character Points scored.
opp_pts character Opponent points.

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Get NBA Stats API Leaders Tiles

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead.

Usage

nba_leaderstiles(
  league_id = "00",
  game_scope = "Season",
  player_or_team = "Team",
  player_scope = "All Players",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat = "PTS",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals
player_or_team

Player or Team
player_scope

Player Scope - All Players, Rookies
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs
stat

Stat - PTS, REB, AST, FG_PCT, FT_PCT, FG3_PCT, STL, BLK
...

Additional arguments passed to an underlying function like httr.

Details

 nba_leaderstiles(league_id = '00', player_or_team = "Player")
 nba_leaderstiles(league_id = '00', player_or_team = "Team")

Value

Returns a named list of data frames: AllTimeSeasonHigh, LastSeasonHigh, LeadersTiles, LowSeasonHigh,

LeadersTiles

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PTS character Points scored.

AllTimeSeasonHigh

col_name types description
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
SEASON_YEAR character Season year string ('YYYY-YY' format).
PTS character Points scored.

LastSeasonHigh

col_name types description
RANK character Rank.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PTS character Points scored.

LowSeasonHigh

col_name types description
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
SEASON_YEAR character Season year string ('YYYY-YY' format).
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leagueleaders()

Get NBA Stats API League Dashboard Lineups

Description

Get NBA Stats API League Dashboard Lineups

Get NBA Stats API League Dashboard Lineups

Usage

nba_leaguedashlineups(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
division

division
game_segment

game_segment
group_quantity

group_quantity
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Lineups Dashboard 

 nba_leaguedashlineups(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: Lineups

Lineups

col_name types description
GROUP_SET character
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Lineup Functions: nba_gamerotation(), nba_leaguelineupviz(), nba_shotchartlineupdetail(), nba_teamdashlineups()

Get NBA Stats API League Dashboard Player Tracking - Opponent Shots

Description

Get NBA Stats API League Dashboard Player Tracking - Opponent Shots

Get NBA Stats API League Dashboard Player Tracking - Opponent Shots

Usage

nba_leaguedashoppptshot(
  close_def_dist_range = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  dribble_range = "",
  game_segment = "",
  general_range = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "Y",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  shot_dist_range = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

close_def_dist_range

close_def_dist_range
conference

conference
date_from

date_from
date_to

date_to
division

division
dribble_range

dribble_range
game_segment

game_segment
general_range

general_range
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
shot_dist_range

shot_dist_range
team_id

team_id
touch_time_range

touch_time_range
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Opponent Shots - General 

 nba_leaguedashoppptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPTShots

LeagueDashPTShots

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
G character Games played.
FGA_FREQUENCY character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
FG2A_FREQUENCY character
FG2M character
FG2A character
FG2_PCT character
FG3A_FREQUENCY character
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API League Dashboard Player Biographical Stats

Description

Get NBA Stats API League Dashboard Player Biographical Stats

Get NBA Stats API League Dashboard Player Biographical Stats

Usage

nba_leaguedashplayerbiostats(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_segment = "",
  game_scope = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = "",
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
game_segment

game_segment
game_scope

game_scope
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
touch_time_range

touch_time_range
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Player Bio Stats 

 nba_leaguedashplayerbiostats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPlayerBioStats

LeagueDashPlayerBioStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
PLAYER_HEIGHT character
PLAYER_HEIGHT_INCHES character
PLAYER_WEIGHT character
COLLEGE character College or school attended.
COUNTRY character Country (full name or code).
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
GP character Games played.
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
NET_RATING character Net rating (off rating - def rating).
OREB_PCT character Offensive rebound percentage (0-1).
DREB_PCT character Defensive rebound percentage (0-1).
USG_PCT character Usage percentage (0-1).
TS_PCT character True shooting percentage (0-1).
AST_PCT character Assist percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API League Dashboard by Player Clutch Splits

Description

Get NBA Stats API League Dashboard by Player Clutch Splits

Get NBA Stats API League Dashboard by Player Clutch Splits

Usage

nba_leaguedashplayerclutch(
  ahead_behind = "Ahead or Behind",
  clutch_time = "Last 5 Minutes",
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  point_diff = 5,
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

ahead_behind

ahead_behind
clutch_time

clutch_time
college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
game_scope

game_scope
game_segment

game_segment
height

height
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
point_diff

point_diff
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
touch_time_range

touch_time_range
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Players Clutch Stats 

 nba_leaguedashplayerclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPlayerClutch

LeagueDashPlayerClutch

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API League Dashboard Player Tracking - Player Shots

Description

Get NBA Stats API League Dashboard Player Tracking - Player Shots

Get NBA Stats API League Dashboard Player Tracking - Player Shots

Usage

nba_leaguedashplayerptshot(
  close_def_dist_range = "",
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  distance_range = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  dribble_range = "",
  game_scope = "",
  game_segment = "",
  general_range = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  shot_dist_range = "",
  starter_bench = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

close_def_dist_range

close_def_dist_range
college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
distance_range

distance_range
division

division
draft_pick

draft_pick
draft_year

draft_year
dribble_range

dribble_range
game_scope

game_scope
game_segment

game_segment
general_range

general_range
height

height
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
shot_dist_range

shot_dist_range
starter_bench

starter_bench
team_id

team_id
touch_time_range

touch_time_range
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Players Shot Dashboard 

 nba_leaguedashplayerptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPTShots

LeagueDashPTShots

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
PLAYER_LAST_TEAM_ID character
PLAYER_LAST_TEAM_ABBREVIATION character
AGE character Player age (in years).
GP character Games played.
G character Games played.
FGA_FREQUENCY character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
FG2A_FREQUENCY character
FG2M character
FG2A character
FG2_PCT character
FG3A_FREQUENCY character
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API League Dashboard Player Shot Locations

Description

Get NBA Stats API League Dashboard Player Shot Locations

Get NBA Stats API League Dashboard Player Shot Locations

Usage

nba_leaguedashplayershotlocations(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  distance_range = "By Zone",
  division = "",
  draft_pick = "",
  draft_year = "",
  dribble_range = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
distance_range

distance_range
division

division
draft_pick

draft_pick
draft_year

draft_year
dribble_range

dribble_range
game_scope

game_scope
game_segment

game_segment
height

height
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Players Shooting by Shot Location 

 nba_leaguedashplayershotlocations(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: ShotLocations

ShotLocations

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
NICKNAME character Team or athlete nickname.
Restricted_Area_FGM character
Restricted_Area_FGA character
Restricted_Area_FG_PCT character
In_The_Paint_Non_RA_FGM character
In_The_Paint_Non_RA_FGA character
In_The_Paint_Non_RA_FG_PCT character
Mid_Range_FGM character
Mid_Range_FGA character
Mid_Range_FG_PCT character
Left_Corner_3_FGM character
Left_Corner_3_FGA character
Left_Corner_3_FG_PCT character
Right_Corner_3_FGM character
Right_Corner_3_FGA character
Right_Corner_3_FG_PCT character
Above_the_Break_3_FGM character
Above_the_Break_3_FGA character
Above_the_Break_3_FG_PCT character
Backcourt_FGM character
Backcourt_FGA character
Backcourt_FG_PCT character
Corner_3_FGM character
Corner_3_FGA character
Corner_3_FG_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Shooting Functions: nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Get NBA Stats API League Dashboard Player Stats

Description

Get NBA Stats API League Dashboard Player Stats

Get NBA Stats API League Dashboard Player Stats

Usage

nba_leaguedashplayerstats(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_scope = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  two_way = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
game_scope

game_scope
game_segment

game_segment
height

height
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
two_way

two_way
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Players Stats 

 nba_leaguedashplayerstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPlayerStats

LeagueDashPlayerStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API League Dashboard Player Tracking - Defense

Description

Get NBA Stats API League Dashboard Player Tracking - Defense

Get NBA Stats API League Dashboard Player Tracking - Defense

Usage

nba_leaguedashptdefend(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  defense_category = "Overall",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_segment = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = "",
  player_experience = "",
  player_id = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
defense_category

defense_category
division

division
draft_pick

draft_pick
draft_year

draft_year
game_segment

game_segment
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_id

player_id
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Defensive Dashboard 

 nba_leaguedashptdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPTDefend

LeagueDashPTDefend

col_name types description
CLOSE_DEF_PERSON_ID character
PLAYER_NAME character Player name.
PLAYER_LAST_TEAM_ID character
PLAYER_LAST_TEAM_ABBREVIATION character
PLAYER_POSITION character
AGE character Player age (in years).
GP character Games played.
G character Games played.
FREQ character
D_FGM character
D_FGA character
D_FG_PCT character
NORMAL_FG_PCT character
PCT_PLUSMINUS character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API League Dashboard Player Tracking - Stats

Description

Get NBA Stats API League Dashboard Player Tracking - Stats

Get NBA Stats API League Dashboard Player Tracking - Stats

Usage

nba_leaguedashptstats(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  game_scope = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "PerGame",
  period = "",
  player_experience = "",
  player_or_team = "Player",
  player_position = "",
  pt_measure_type = "Drives",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
game_scope

game_scope
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_or_team

player_or_team
player_position

player_position
pt_measure_type

pt_measure_type
season

season
season_segment

season_segment
season_type

season_type
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Players Tracking (Second Spectrum) Stats 

 nba_leaguedashptstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPtStats

LeagueDashPtStats

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
W character Wins.
L character Losses.
MIN character Minutes played.
DRIVES character
DRIVE_FGM character
DRIVE_FGA character
DRIVE_FG_PCT character
DRIVE_FTM character
DRIVE_FTA character
DRIVE_FT_PCT character
DRIVE_PTS character
DRIVE_PTS_PCT character
DRIVE_PASSES character
DRIVE_PASSES_PCT character
DRIVE_AST character
DRIVE_AST_PCT character
DRIVE_TOV character
DRIVE_TOV_PCT character
DRIVE_PF character
DRIVE_PF_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API League Dashboard Player Tracking - Team Defense

Description

Get NBA Stats API League Dashboard Player Tracking - Team Defense

Get NBA Stats API League Dashboard Player Tracking - Team Defense

Usage

nba_leaguedashptteamdefend(
  conference = "",
  date_from = "",
  date_to = "",
  defense_category = "Overall",
  division = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "PerGame",
  period = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
defense_category

defense_category
division

division
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Defensive Dashboard 

 nba_leaguedashptteamdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPtTeamDefend

LeagueDashPtTeamDefend

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
G character Games played.
FREQ character
D_FGM character
D_FGA character
D_FG_PCT character
NORMAL_FG_PCT character
PCT_PLUSMINUS character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API League Dashboard by Team Clutch Splits

Description

Get NBA Stats API League Dashboard by Team Clutch Splits

Get NBA Stats API League Dashboard by Team Clutch Splits

Usage

nba_leaguedashteamclutch(
  ahead_behind = "Ahead or Behind",
  clutch_time = "Last 5 Minutes",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  point_diff = 5,
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

ahead_behind

ahead_behind
clutch_time

clutch_time
conference

conference
date_from

date_from
date_to

date_to
division

division
game_scope

game_scope
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
point_diff

point_diff
po_round

po_round
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Clutch Stats 

 nba_leaguedashteamclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashTeamClutch

LeagueDashTeamClutch

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Clutch Functions: nba_playerdashboardbyclutch(), nba_teamdashboardbyclutch()

Get NBA Stats API League Dashboard Player Tracking - Team Shots

Description

Get NBA Stats API League Dashboard Player Tracking - Team Shots

Get NBA Stats API League Dashboard Player Tracking - Team Shots

Usage

nba_leaguedashteamptshot(
  close_def_dist_range = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  dribble_range = "",
  game_segment = "",
  general_range = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  shot_dist_range = "",
  team_id = "",
  touch_time_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

close_def_dist_range

close_def_dist_range
conference

conference
date_from

date_from
date_to

date_to
division

division
dribble_range

dribble_range
game_segment

game_segment
general_range

general_range
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
shot_dist_range

shot_dist_range
team_id

team_id
touch_time_range

touch_time_range
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Shot Dashboard 

 nba_leaguedashteamptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashPTShots

LeagueDashPTShots

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
G character Games played.
FGA_FREQUENCY character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
EFG_PCT character Effective field goal percentage (0-1).
FG2A_FREQUENCY character
FG2M character
FG2A character
FG2_PCT character
FG3A_FREQUENCY character
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Get NBA Stats API League Dashboard Team Shot Locations

Description

Get NBA Stats API League Dashboard Team Shot Locations

Get NBA Stats API League Dashboard Team Shot Locations

Usage

nba_leaguedashteamshotlocations(
  conference = "",
  date_from = "",
  date_to = "",
  distance_range = "By Zone",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_experience = "",
  player_position = "",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
distance_range

distance_range
division

division
game_scope

game_scope
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_experience

player_experience
player_position

player_position
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Shooting by Shot Location 

 nba_leaguedashteamshotlocations(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: ShotLocations

ShotLocations

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
Restricted_Area_FGM character
Restricted_Area_FGA character
Restricted_Area_FG_PCT character
In_The_Paint_Non_RA_FGM character
In_The_Paint_Non_RA_FGA character
In_The_Paint_Non_RA_FG_PCT character
Mid_Range_FGM character
Mid_Range_FGA character
Mid_Range_FG_PCT character
Left_Corner_3_FGM character
Left_Corner_3_FGA character
Left_Corner_3_FG_PCT character
Right_Corner_3_FGM character
Right_Corner_3_FGA character
Right_Corner_3_FG_PCT character
Above_the_Break_3_FGM character
Above_the_Break_3_FGA character
Above_the_Break_3_FG_PCT character
Backcourt_FGM character
Backcourt_FGA character
Backcourt_FG_PCT character
Corner_3_FGM character
Corner_3_FGA character
Corner_3_FG_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Get NBA Stats API League Dashboard Team Stats

Description

Get NBA Stats API League Dashboard Team Stats

Get NBA Stats API League Dashboard Team Stats

Usage

nba_leaguedashteamstats(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_scope = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  starter_bench = "",
  team_id = "",
  two_way = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
division

division
game_scope

game_scope
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
starter_bench

starter_bench
team_id

team_id
two_way

two_way
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Stats 

 nba_leaguedashteamstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueDashTeamStats

LeagueDashTeamStats

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Team Functions: nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API League Game Streak Finder

Description

Get NBA Stats API League Game Streak Finder

Get NBA Stats API League Game Streak Finder

Usage

nba_leaguegamefinder(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_year = "",
  draft_team_id = "",
  draft_round = "",
  draft_number = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  league_id = "00",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  outcome = "",
  po_round = "",
  player_id = "",
  player_or_team = "T",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  years_experience = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
division

division
draft_year

draft_year
draft_team_id

draft_team_id
draft_round

draft_round
draft_number

draft_number
et_ast

et_ast
et_blk

et_blk
et_dd

et_dd
et_dreb

et_dreb
et_fg3a

et_fg3a
et_fg3m

et_fg3m
et_fg3_pct

et_fg3_pct
et_fga

et_fga
et_fgm

et_fgm
et_fg_pct

et_fg_pct
et_fta

et_fta
et_ftm

et_ftm
et_ft_pct

et_ft_pct
et_minutes

et_minutes
et_oreb

et_oreb
et_pf

et_pf
et_pts

et_pts
et_reb

et_reb
et_stl

et_stl
et_td

et_td
et_tov

et_tov
game_id

game_id
gt_ast

gt_ast
gt_blk

gt_blk
gt_dd

gt_dd
gt_dreb

gt_dreb
gt_fg3a

gt_fg3a
gt_fg3m

gt_fg3m
gt_fg3_pct

gt_fg3_pct
gt_fga

gt_fga
gt_fgm

gt_fgm
gt_fg_pct

gt_fg_pct
gt_fta

gt_fta
gt_ftm

gt_ftm
gt_ft_pct

gt_ft_pct
gt_minutes

gt_minutes
gt_oreb

gt_oreb
gt_pf

gt_pf
gt_pts

gt_pts
gt_reb

gt_reb
gt_stl

gt_stl
gt_td

gt_td
gt_tov

gt_tov
league_id

league_id
location

location
lt_ast

lt_ast
lt_blk

lt_blk
lt_dd

lt_dd
lt_dreb

lt_dreb
lt_fg3a

lt_fg3a
lt_fg3m

lt_fg3m
lt_fg3_pct

lt_fg3_pct
lt_fga

lt_fga
lt_fgm

lt_fgm
lt_fg_pct

lt_fg_pct
lt_fta

lt_fta
lt_ftm

lt_ftm
lt_ft_pct

lt_ft_pct
lt_minutes

lt_minutes
lt_oreb

lt_oreb
lt_pf

lt_pf
lt_pts

lt_pts
lt_reb

lt_reb
lt_stl

lt_stl
lt_td

lt_td
lt_tov

lt_tov
outcome

outcome
po_round

po_round
player_id

player_id
player_or_team

player_or_team
rookie_year

rookie_year
season

season - Min: '1983-84'
season_segment

season_segment
season_type

season_type
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_team_id

vs_team_id
years_experience

years_experience
...

Additional arguments passed to an underlying function like httr.

Details

 nba_leaguegamefinder(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: LeagueGameFinderResults

LeagueGameFinderResults

col_name types description
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
MIN character Minutes played.
PTS character Points scored.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Game Finder Functions: nba_playergamestreakfinder(), nba_teamgamestreakfinder()

Get NBA Stats API League Game Log

Description

Get NBA Stats API League Game Log

Get NBA Stats API League Game Log

Usage

nba_leaguegamelog(
  counter = 0,
  date_from = "",
  date_to = "",
  direction = "ASC",
  league_id = "00",
  player_or_team = "T",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  sorter = "DATE",
  ...
)

Arguments

counter

counter
date_from

date_from
date_to

date_to
direction

direction
league_id

league_id
player_or_team

player_or_team
season

season
season_type

season_type
sorter

sorter
...

Additional arguments passed to an underlying function like httr.

Details

Player/Team Boxscores 

 nba_leaguegamelog(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: LeagueGameLog

LeagueGameLog

col_name types description
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
VIDEO_AVAILABLE character Video available.

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Get NBA Stats API League Hustle Stats Player

Description

Get NBA Stats API League Hustle Stats Player

Get NBA Stats API League Hustle Stats Player

Usage

nba_leaguehustlestatsplayer(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Player Hustle Stats 

 nba_leaguehustlestatsplayer(league_id = '00')
 nba_leaguehustlestatsplayer(league_id = '00', team_id = '1610612761')

Value

Returns a named list of data frames: HustleStatsPlayer

HustleStatsPlayer

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
G character Games played.
MIN character Minutes played.
CONTESTED_SHOTS character Defensively contested shots.
CONTESTED_SHOTS_2PT character Contested two-point shots.
CONTESTED_SHOTS_3PT character Contested three-point shots.
DEFLECTIONS character Defensive deflections.
CHARGES_DRAWN character Charges drawn.
SCREEN_ASSISTS character Screen assists (resulting in a basket).
SCREEN_AST_PTS character
OFF_LOOSE_BALLS_RECOVERED character
DEF_LOOSE_BALLS_RECOVERED character
LOOSE_BALLS_RECOVERED character Loose balls recovered.
PCT_LOOSE_BALLS_RECOVERED_OFF character
PCT_LOOSE_BALLS_RECOVERED_DEF character
OFF_BOXOUTS character
DEF_BOXOUTS character
BOX_OUT_PLAYER_TEAM_REBS character
BOX_OUT_PLAYER_REBS character
BOX_OUTS character Box-outs executed.
PCT_BOX_OUTS_OFF character
PCT_BOX_OUTS_DEF character
PCT_BOX_OUTS_TEAM_REB character
PCT_BOX_OUTS_REB character

Author(s)

Saiem Gilani

See Also

Other NBA Hustle Functions: nba_hustlestatsboxscore(), nba_leaguehustlestatsplayerleaders(), nba_leaguehustlestatsteam(), nba_leaguehustlestatsteamleaders()

Get NBA Stats API League Hustle Stats Player Leaders

Description

Get NBA Stats API League Hustle Stats Player Leaders

Get NBA Stats API League Hustle Stats Player Leaders

Usage

nba_leaguehustlestatsplayerleaders(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Player Hustle Stats Leaders 

 nba_leaguehustlestatsplayerleaders(league_id = '00')

Value

Returns a named list of data frames: PlayerChargesDrawnLeaders, PlayerContestedShotsLeaders, PlayerDeflectionsLeaders, PlayerLooseBallLeaders, PlayerScreenAssistLeaders, Table5

PlayerContestedShotsLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
CONTESTED_SHOTS character Defensively contested shots.

PlayerChargesDrawnLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
CHARGES_DRAWN character Charges drawn.

PlayerDeflectionsLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
DEFLECTIONS character Defensive deflections.

PlayerLooseBallLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
LOOSE_BALLS_RECOVERED character Loose balls recovered.

PlayerScreenAssistLeaders

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
SCREEN_ASSISTS character Screen assists (resulting in a basket).

Table5

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
AGE character Player age (in years).
RANK character Rank.
BOX_OUTS character Box-outs executed.

Author(s)

Saiem Gilani

See Also

Other NBA Hustle Functions: nba_hustlestatsboxscore(), nba_leaguehustlestatsplayer(), nba_leaguehustlestatsteam(), nba_leaguehustlestatsteamleaders()

Get NBA Stats API League Hustle Stats Team

Description

Get NBA Stats API League Hustle Stats Team

Get NBA Stats API League Hustle Stats Team

Usage

nba_leaguehustlestatsteam(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Team Hustle Stats 

 nba_leaguehustlestatsteam(league_id = '00')

Value

Returns a named list of data frames: HustleStatsTeam

HustleStatsTeam

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
MIN character Minutes played.
CONTESTED_SHOTS character Defensively contested shots.
CONTESTED_SHOTS_2PT character Contested two-point shots.
CONTESTED_SHOTS_3PT character Contested three-point shots.
DEFLECTIONS character Defensive deflections.
CHARGES_DRAWN character Charges drawn.
SCREEN_ASSISTS character Screen assists (resulting in a basket).
SCREEN_AST_PTS character
OFF_LOOSE_BALLS_RECOVERED character
DEF_LOOSE_BALLS_RECOVERED character
LOOSE_BALLS_RECOVERED character Loose balls recovered.
PCT_LOOSE_BALLS_RECOVERED_OFF character
PCT_LOOSE_BALLS_RECOVERED_DEF character
OFF_BOXOUTS character
DEF_BOXOUTS character
BOX_OUTS character Box-outs executed.
PCT_BOX_OUTS_OFF character
PCT_BOX_OUTS_DEF character

Author(s)

Saiem Gilani

See Also

Other NBA Hustle Functions: nba_hustlestatsboxscore(), nba_leaguehustlestatsplayer(), nba_leaguehustlestatsplayerleaders(), nba_leaguehustlestatsteamleaders()

Get NBA Stats API League Hustle Stats Team Leaders

Description

Get NBA Stats API League Hustle Stats Team Leaders

Get NBA Stats API League Hustle Stats Team Leaders

Usage

nba_leaguehustlestatsteamleaders(
  college = "",
  conference = "",
  country = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_pick = "",
  draft_year = "",
  height = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  player_experience = "",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  weight = "",
  ...
)

Arguments

college

college
conference

conference
country

country
date_from

date_from
date_to

date_to
division

division
draft_pick

draft_pick
draft_year

draft_year
height

height
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
player_experience

player_experience
player_position

player_position
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
weight

weight
...

Additional arguments passed to an underlying function like httr.

Details

Team Hustle Stats Leaders 

 nba_leaguehustlestatsteamleaders(league_id = '00')

Value

Returns a named list of data frames: Table5, Table6, TeamChargesDrawnLeaders, TeamContestedShotsLeaders, TeamDeflectionsLeaders, TeamLooseBallLeaders, TeamScreenAssistLeaders

TeamContestedShotsLeaders

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
CONTESTED_SHOTS character Defensively contested shots.

TeamChargesDrawnLeaders

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
CHARGES_DRAWN character Charges drawn.

TeamDeflectionsLeaders

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
DEFLECTIONS character Defensive deflections.

TeamLooseBallLeaders

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
LOOSE_BALLS_RECOVERED character Loose balls recovered.

TeamScreenAssistLeaders

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
SCREEN_ASSISTS character Screen assists (resulting in a basket).

Table5

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
BOX_OUTS character Box-outs executed.

Table6

col_name types description
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
RANK character Rank.
BOX_OUTS character Box-outs executed.

Author(s)

Saiem Gilani

See Also

Other NBA Hustle Functions: nba_hustlestatsboxscore(), nba_leaguehustlestatsplayer(), nba_leaguehustlestatsplayerleaders(), nba_leaguehustlestatsteam()

Get NBA Stats API League Leaders

Description

Get NBA Stats API League Leaders

Get NBA Stats API League Leaders

Usage

nba_leagueleaders(
  active_flag = "",
  league_id = "00",
  per_mode = "Totals",
  scope = "S",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  stat_category = "PTS",
  ...
)

Arguments

active_flag

Active Flag
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - Totals, PerGame, Per48
scope

Scope - RS, S, Rookies
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs
stat_category

Stat Category: PTS, REB, AST, FG_PCT, FT_PCT, FG3_PCT, STL, BLK
...

Additional arguments passed to an underlying function like httr.

Details

League Leaders 

 nba_leagueleaders(league_id = '00')

Value

Returns a named list of data frames: LeagueLeaders

LeagueLeaders

col_name types description
PLAYER_ID character Unique player identifier.
RANK character Rank.
PLAYER character Player.
TEAM_ID character Unique team identifier.
TEAM character Team-side label or team identifier.
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
EFF character Eff.
AST_TOV character
STL_TOV character

Author(s)

Saiem Gilani

See Also

Other NBA Leaders Functions: nba_alltimeleadersgrids(), nba_assistleaders(), nba_assisttracker(), nba_defensehub(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_homepagev2(), nba_leaderstiles()

Get NBA Stats API League Lineup Visual Data

Description

Get NBA Stats API League Lineup Visual Data

Get NBA Stats API League Lineup Visual Data

Usage

nba_leaguelineupviz(
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  minutes_min = 10,
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
division

division
game_segment

game_segment
group_quantity

group_quantity
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
minutes_min

minutes_min
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Lineups Dashboard 

 nba_leaguelineupviz(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: LeagueLineupViz

LeagueLineupViz

col_name types description
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
MIN character Minutes played.
OFF_RATING character Offensive rating (points produced per 100 possessions).
DEF_RATING character Defensive rating (points allowed per 100 possessions).
NET_RATING character Net rating (off rating - def rating).
PACE character Possessions per 48 minutes.
TS_PCT character True shooting percentage (0-1).
FTA_RATE character Free throw attempt rate (FTA / FGA).
TM_AST_PCT character
PCT_FGA_2PT character
PCT_FGA_3PT character
PCT_PTS_2PT_MR character
PCT_PTS_FB character
PCT_PTS_FT character
PCT_PTS_PAINT character
PCT_AST_FGM character
PCT_UAST_FGM character
OPP_FG3_PCT character
OPP_EFG_PCT character
OPP_FTA_RATE character
OPP_TOV_PCT character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Lineup Functions: nba_gamerotation(), nba_leaguedashlineups(), nba_shotchartlineupdetail(), nba_teamdashlineups()

Get NBA Stats API League Player On/Off Details

Description

Get NBA Stats API League Player On/Off Details

Get NBA Stats API League Player On/Off Details

Usage

nba_leagueplayerondetails(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
per_mode

per_mode
period

period
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_leagueplayerondetails(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: PlayersOnCourtLeaguePlayerDetails

PlayersOnCourtLeaguePlayerDetails

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API League Season Matchups

Description

Get NBA Stats API League Season Matchups

Get NBA Stats API League Season Matchups

Usage

nba_leagueseasonmatchups(
  def_player_id = "",
  def_team_id = "",
  league_id = "00",
  off_player_id = "",
  off_team_id = "",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

def_player_id

def_player_id
def_team_id

def_team_id
league_id

league_id
off_player_id

off_player_id
off_team_id

off_team_id
per_mode

per_mode
season

season
season_type

season_type
...

Additional arguments passed to an underlying function like httr.

Details

Player Season Matchups 

 nba_leagueseasonmatchups(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: SeasonMatchups

SeasonMatchups

col_name types description
SEASON_ID character Unique season identifier.
OFF_PLAYER_ID character
OFF_PLAYER_NAME character
DEF_PLAYER_ID character
DEF_PLAYER_NAME character
GP character Games played.
MATCHUP_MIN character
PARTIAL_POSS character
PLAYER_PTS character
TEAM_PTS character
MATCHUP_AST character
MATCHUP_TOV character
MATCHUP_BLK character
MATCHUP_FGM character
MATCHUP_FGA character
MATCHUP_FG_PCT character
MATCHUP_FG3M character
MATCHUP_FG3A character
MATCHUP_FG3_PCT character
HELP_BLK character
HELP_FGM character
HELP_FGA character
HELP_FG_PERC character
MATCHUP_FTM character
MATCHUP_FTA character
SFL character
MATCHUP_TIME_SEC character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API League Standings

Description

Get NBA Stats API League Standings

Get NBA Stats API League Standings

Usage

nba_leaguestandings(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  season_year = "",
  ...
)

Arguments

league_id

league_id
season

season
season_type

season_type
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

League Standings 

 nba_leaguestandings(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: Standings

Standings

col_name types description
LeagueID character
SeasonID character
TeamID character Teamid.
TeamCity character Teamcity.
TeamName character Teamname.
Conference character Conference.
ConferenceRecord character
PlayoffRank character
ClinchIndicator character
Division character Team division.
DivisionRecord character
DivisionRank character
WINS character Total wins.
LOSSES character Total losses.
WinPCT character
LeagueRank character
Record character Record string (e.g. '12-4').
HOME character Home.
ROAD character Road.
L10 character
Last10Home character
Last10Road character
OT character Ot.
ThreePTSOrLess character
TenPTSOrMore character
LongHomeStreak character
strLongHomeStreak character
LongRoadStreak character
strLongRoadStreak character
LongWinStreak character
LongLossStreak character
CurrentHomeStreak character
strCurrentHomeStreak character
CurrentRoadStreak character
strCurrentRoadStreak character
CurrentStreak character
strCurrentStreak character
ConferenceGamesBack character
DivisionGamesBack character
ClinchedConferenceTitle character
ClinchedDivisionTitle character
ClinchedPlayoffBirth character
EliminatedConference character
EliminatedDivision character
AheadAtHalf character
BehindAtHalf character
TiedAtHalf character
AheadAtThird character
BehindAtThird character
TiedAtThird character
Score100PTS character
OppScore100PTS character
OppOver500 character
LeadInFGPCT character
LeadInReb character
FewerTurnovers character
PointsPG character
OppPointsPG character
DiffPointsPG character
vsEast character
vsAtlantic character
vsCentral character
vsSoutheast character
vsWest character
vsNorthwest character
vsPacific character
vsSouthwest character
Jan character
Feb character
Mar character
Apr character
May character
Jun character
Jul character
Aug character
Sep character
Oct character
Nov character
Dec character
PreAS character
PostAS character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Get NBA Stats API League Standings V3

Description

Get NBA Stats API League Standings V3

Get NBA Stats API League Standings V3

Usage

nba_leaguestandingsv3(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  season_year = "",
  ...
)

Arguments

league_id

league_id
season

season
season_type

season_type
season_year

season_year
...

Additional arguments passed to an underlying function like httr.

Details

League Standings 

 nba_leaguestandingsv3(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: Standings

Standings

col_name types description
LeagueID character
SeasonID character
TeamID character Teamid.
TeamCity character Teamcity.
TeamName character Teamname.
TeamSlug character
Conference character Conference.
ConferenceRecord character
PlayoffRank character
ClinchIndicator character
Division character Team division.
DivisionRecord character
DivisionRank character
WINS character Total wins.
LOSSES character Total losses.
WinPCT character
LeagueRank character
Record character Record string (e.g. '12-4').
HOME character Home.
ROAD character Road.
L10 character
Last10Home character
Last10Road character
OT character Ot.
ThreePTSOrLess character
TenPTSOrMore character
LongHomeStreak character
strLongHomeStreak character
LongRoadStreak character
strLongRoadStreak character
LongWinStreak character
LongLossStreak character
CurrentHomeStreak character
strCurrentHomeStreak character
CurrentRoadStreak character
strCurrentRoadStreak character
CurrentStreak character
strCurrentStreak character
ConferenceGamesBack character
DivisionGamesBack character
ClinchedConferenceTitle character
ClinchedDivisionTitle character
ClinchedPlayoffBirth character
ClinchedPlayIn character
EliminatedConference character
EliminatedDivision character
AheadAtHalf character
BehindAtHalf character
TiedAtHalf character
AheadAtThird character
BehindAtThird character
TiedAtThird character
Score100PTS character
OppScore100PTS character
OppOver500 character
LeadInFGPCT character
LeadInReb character
FewerTurnovers character
PointsPG character
OppPointsPG character
DiffPointsPG character
vsEast character
vsAtlantic character
vsCentral character
vsSoutheast character
vsWest character
vsNorthwest character
vsPacific character
vsSouthwest character
Jan character
Feb character
Mar character
Apr character
May character
Jun character
Jul character
Aug character
Sep character
Oct character
Nov character
Dec character
Score_80_Plus character
Opp_Score_80_Plus character
Score_Below_80 character
Opp_Score_Below_80 character
TotalPoints character
OppTotalPoints character
DiffTotalPoints character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_matchupsrollup(), nba_playoffpicture(), nba_shotchartleaguewide()

Get NBA Stats API Live Boxscore

Description

Get NBA Stats API Live Boxscore

Get NBA Stats API Live Boxscore

Usage

nba_live_boxscore(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_live_boxscore(game_id = "0022201086")

Value

Returns a named list of data frames: game_details, arena, officials, home_team_boxscore, away_team_boxscore, home_team_player_boxscore, away_team_player_boxscore, home_team_linescores, away_team_linescores

game_details

col_name types description
game_id character Unique game identifier.
game_time_local character Game time local.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_time_home character Game time home.
game_time_away character Game time away.
game_et character Game et.
duration integer Duration.
game_code character ESPN game code (numeric identifier).
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_status integer Game status label.
regulation_periods integer Regulation periods.
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
attendance integer Reported attendance.
sellout character Sellout.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_score integer Home team's score.
home_team_in_bonus character Home team's team in bonus.
home_team_timeouts_remaining integer Home team's team timeouts remaining.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_score integer Away team's score.
away_team_in_bonus character Away team's team in bonus.
away_team_timeouts_remaining integer Away team's team timeouts remaining.

arena

col_name types description
arena_id integer Unique identifier for arena.
arena_name character Arena name.
arena_city character Arena city.
arena_state character Arena state.
arena_country character Arena country.
arena_timezone character Arena timezone.

officials

col_name types description
person_id integer Unique player identifier (V3 endpoints).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
jersey_num character Jersey number worn by the player.
assignment character Assignment.

home_team_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
assists integer Total assists.
assists_turnover_ratio numeric Assists turnover ratio.
bench_points integer Points scored by the bench.
biggest_lead integer Biggest lead.
biggest_lead_score character Biggest lead score.
biggest_scoring_run integer Biggest scoring run.
biggest_scoring_run_score character Biggest scoring run score.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
fast_break_points_attempted integer Number of fast break points attempted.
fast_break_points_made integer Number of fast break points made.
fast_break_points_percentage numeric Fast break points percentage (0-1 decimal).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_effective_adjusted numeric Field goals effective adjusted.
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_team integer Fouls team.
fouls_technical integer Technical fouls.
fouls_team_technical integer Fouls team technical.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
lead_changes integer Lead changes.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
points integer Points scored.
points_against integer Points allowed.
points_fast_break integer Fast-break points scored.
points_from_turnovers integer Points from turnovers.
points_in_the_paint integer Points in the paint.
points_in_the_paint_attempted integer Number of points in the paint attempted.
points_in_the_paint_made integer Number of points in the paint made.
points_in_the_paint_percentage numeric Points in the paint percentage (0-1 decimal).
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_personal integer Rebounds personal.
rebounds_team integer Rebounds team.
rebounds_team_defensive integer Rebounds team defensive.
rebounds_team_offensive integer Rebounds team offensive.
rebounds_total integer Total rebounds.
second_chance_points_attempted integer Number of second chance points attempted.
second_chance_points_made integer Number of second chance points made.
second_chance_points_percentage numeric Second chance points percentage (0-1 decimal).
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
time_leading character Time leading.
times_tied integer Times tied.
true_shooting_attempts numeric Number of true shooting attempted.
true_shooting_percentage numeric True shooting percentage (0-1).
turnovers integer Total turnovers.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).

away_team_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
assists integer Total assists.
assists_turnover_ratio numeric Assists turnover ratio.
bench_points integer Points scored by the bench.
biggest_lead integer Biggest lead.
biggest_lead_score character Biggest lead score.
biggest_scoring_run integer Biggest scoring run.
biggest_scoring_run_score character Biggest scoring run score.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
fast_break_points_attempted integer Number of fast break points attempted.
fast_break_points_made integer Number of fast break points made.
fast_break_points_percentage numeric Fast break points percentage (0-1 decimal).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_effective_adjusted numeric Field goals effective adjusted.
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_team integer Fouls team.
fouls_technical integer Technical fouls.
fouls_team_technical integer Fouls team technical.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
lead_changes integer Lead changes.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
points integer Points scored.
points_against integer Points allowed.
points_fast_break integer Fast-break points scored.
points_from_turnovers integer Points from turnovers.
points_in_the_paint integer Points in the paint.
points_in_the_paint_attempted integer Number of points in the paint attempted.
points_in_the_paint_made integer Number of points in the paint made.
points_in_the_paint_percentage numeric Points in the paint percentage (0-1 decimal).
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_personal integer Rebounds personal.
rebounds_team integer Rebounds team.
rebounds_team_defensive integer Rebounds team defensive.
rebounds_team_offensive integer Rebounds team offensive.
rebounds_total integer Total rebounds.
second_chance_points_attempted integer Number of second chance points attempted.
second_chance_points_made integer Number of second chance points made.
second_chance_points_percentage numeric Second chance points percentage (0-1 decimal).
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
time_leading character Time leading.
times_tied integer Times tied.
true_shooting_attempts numeric Number of true shooting attempted.
true_shooting_percentage numeric True shooting percentage (0-1).
turnovers integer Total turnovers.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).

home_team_player_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
status character Status label.
order integer Display order within the result set.
person_id integer Unique player identifier (V3 endpoints).
jersey_num character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
starter character TRUE if the player was in the starting lineup; FALSE otherwise.
oncourt character Oncourt.
played character Played.
assists integer Total assists.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_technical integer Technical fouls.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
minus numeric Minus.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
plus numeric Plus.
plus_minus_points numeric Plus/minus point differential while on court.
points integer Points scored.
points_fast_break integer Fast-break points scored.
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_total integer Total rebounds.
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
turnovers integer Total turnovers.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
not_playing_reason character Not playing reason.
not_playing_description character Not playing description.

away_team_player_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
status character Status label.
order integer Display order within the result set.
person_id integer Unique player identifier (V3 endpoints).
jersey_num character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
starter character TRUE if the player was in the starting lineup; FALSE otherwise.
oncourt character Oncourt.
played character Played.
assists integer Total assists.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_technical integer Technical fouls.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
minus numeric Minus.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
plus numeric Plus.
plus_minus_points numeric Plus/minus point differential while on court.
points integer Points scored.
points_fast_break integer Fast-break points scored.
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_total integer Total rebounds.
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
turnovers integer Total turnovers.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
not_playing_reason character Not playing reason.
not_playing_description character Not playing description.

home_team_linescores

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
score integer Final score.

away_team_linescores

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
score integer Final score.

Author(s)

Saiem Gilani

See Also

Other NBA Boxscore Functions: nba_boxscoreadvancedv2(), nba_boxscoredefensive(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresummaryv2(), nba_boxscoretraditionalv2(), nba_boxscoreusagev2(), nba_gamerotation(), nba_hustlestatsboxscore()

Other NBA Live Functions: nba_live_pbp(), nba_todays_scoreboard()

Get NBA Stats API Live play-by-play

Description

Get NBA Stats API Live play-by-play

Get NBA Stats API Live play-by-play

Usage

nba_live_pbp(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_live_pbp(game_id = '0022201086')

Value

Returns a data frame: PlayByPlay

col_name types description
event_num integer Sequential event number within the game (V2 PBP).
clock character Game clock value.
time_actual character Time actual.
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
qualifiers list Qualifiers.
player1_id integer V2 PBP primary player ID (e.g. shooter / fouler).
x numeric X.
y numeric Y.
offense_team_id integer Unique identifier for offense team.
home_score character Home team score at the time of the play.
away_score character Away team score at the time of the play.
edited character Edited.
order integer Display order within the result set.
is_target_score_last_period logical Is target score last period.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
side character Side label (e.g. 'home', 'away', or 'overUnder').
description character Long-form description text.
person_ids_filter list Person ids filter.
team_id integer Unique team identifier.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
descriptor character Descriptor.
jump_ball_recovered_name character Jump ball recovered name.
jump_ball_recoverd_person_id integer Unique identifier for jump ball recoverd person.
player_name character Player name.
player_name_i character Player name i.
jump_ball_won_player_name character Jump ball won player name.
jump_ball_won_person_id integer Unique identifier for jump ball won person.
jump_ball_lost_player_name character Jump ball lost player name.
jump_ball_lost_person_id integer Unique identifier for jump ball lost person.
area character Area.
area_detail character Area detail.
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
points_total integer Running total of points scored.
assist_player_name_initial character Assist player name initial.
assist_person_id integer Unique identifier for assist person.
assist_total integer Assist total.
shot_action_number integer Shot action number.
rebound_total integer Rebound total.
rebound_defensive_total integer Rebound defensive total.
rebound_offensive_total integer Rebound offensive total.
official_id integer Unique official / referee identifier.
foul_personal_total integer Foul personal total.
foul_technical_total integer Foul technical total.
foul_drawn_player_name character Foul drawn player name.
foul_drawn_person_id integer Unique identifier for foul drawn person.
block_player_name character Block player name.
block_person_id integer Unique identifier for block person.
turnover_total integer Turnover total.
steal_player_name character Steal player name.
steal_person_id integer Unique identifier for steal person.
player2_id integer V2 PBP secondary player ID (e.g. assister / fouled-by).
player3_id integer V2 PBP tertiary player ID (e.g. blocker).

Author(s)

Saiem Gilani

See Also

Other NBA PBP Functions: nba_data_pbp(), nba_pbp(), nba_pbps(), nba_playbyplayv3(), nba_winprobabilitypbp()

Other NBA Live Functions: nba_live_boxscore(), nba_todays_scoreboard()

Get NBA Stats API Matchups Rollup

Description

Get NBA Stats API Matchups Rollup

Get NBA Stats API Matchups Rollup

Usage

nba_matchupsrollup(
  def_player_id = "",
  def_team_id = "",
  league_id = "00",
  off_player_id = "",
  off_team_id = "",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

def_player_id

def_player_id
def_team_id

def_team_id
league_id

league_id
off_player_id

off_player_id
off_team_id

off_team_id
per_mode

per_mode
season

season
season_type

season_type
...

Additional arguments passed to an underlying function like httr.

Details

Player Matchups Rollup 

 nba_matchupsrollup(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: MatchupsRollup

MatchupsRollup

col_name types description
SEASON_ID character Unique season identifier.
POSITION character Listed roster position (G, F, C, etc.).
PERCENT_OF_TIME character
DEF_PLAYER_ID character
DEF_PLAYER_NAME character
GP character Games played.
MATCHUP_MIN character
PARTIAL_POSS character
PLAYER_PTS character
TEAM_PTS character
MATCHUP_AST character
MATCHUP_TOV character
MATCHUP_BLK character
MATCHUP_FGM character
MATCHUP_FGA character
MATCHUP_FG_PCT character
MATCHUP_FG3M character
MATCHUP_FG3A character
MATCHUP_FG3_PCT character
MATCHUP_FTM character
MATCHUP_FTA character
SFL character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_playoffpicture(), nba_shotchartleaguewide()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API play-by-play

Description

Get NBA Stats API play-by-play

Get NBA Stats API play-by-play

Usage

nba_pbp(game_id, on_court = TRUE, version = "v3", p = NULL, ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '0022201086')
on_court

If TRUE (default), on-court player IDs are added for each play event. V3 uses nba_gamerotation() stint data; V2 infers lineups from substitution events.
version

Play-by-play version - "v3" (default) or "v2". V3 returns richer data with shot coordinates, shot values, and V3 action types. V2 is available from 2016-17 onwards.
p

Optional progress object from progressr (default: NULL). Used internally by nba_pbps().
...

Additional arguments passed to an underlying function like httr.

Details

 nba_pbp(game_id = '0022201086')
 nba_pbp(game_id = '0022201086', version = "v2")

Value

Returns a data frame: PlayByPlay

col_name types description
game_id character Unique game identifier.
event_num character Sequential event number within the game (V2 PBP).
event_type character Event / play type code (V2 PBP).
event_action_type character Numeric event-action-type code (V2 PBP).
period numeric Period of the game (1-4 quarters; 5+ for OT).
clock character Game clock value.
minute_game numeric Minute game.
time_remaining numeric Time remaining.
wc_time_string character Wc time string.
time_quarter character Time quarter.
minute_remaining_quarter numeric Minute remaining quarter.
seconds_remaining_quarter numeric Seconds remaining quarter.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
home_description character Home team's description.
neutral_description character Neutral description.
visitor_description character Visitor description.
description character Long-form description text.
location character Location.
score character Final score.
away_score numeric Away team score at the time of the play.
home_score numeric Home team score at the time of the play.
score_margin character Score margin.
person1type character Person1type.
player1_id character V2 PBP primary player ID (e.g. shooter / fouler).
player1_name character V2 PBP primary player name.
player1_team_id character Team ID of player1.
player1_team_city character Player1 team city.
player1_team_nickname character Player1 team nickname.
player1_team_abbreviation character Player1 team abbreviation.
person2type character Person2type.
player2_id character V2 PBP secondary player ID (e.g. assister / fouled-by).
player2_name character V2 PBP secondary player name.
player2_team_id character Team ID of player2.
player2_team_city character Player2 team city.
player2_team_nickname character Player2 team nickname.
player2_team_abbreviation character Player2 team abbreviation.
person3type character Person3type.
player3_id character V2 PBP tertiary player ID (e.g. blocker).
player3_name character V2 PBP tertiary player name.
player3_team_id character Team ID of player3.
player3_team_city character Player3 team city.
player3_team_nickname character Player3 team nickname.
player3_team_abbreviation character Player3 team abbreviation.
video_available_flag character Video available flag.
team_leading character Team leading.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
points_total integer Running total of points scored.
shot_value integer Point value of the shot (2 or 3).
away_player1 numeric Away team's player1.
away_player2 numeric Away team's player2.
away_player3 numeric Away team's player3.
away_player4 numeric Away team's player4.
away_player5 numeric Away team's player5.
home_player1 numeric Home team's player1.
home_player2 numeric Home team's player2.
home_player3 numeric Home team's player3.
home_player4 numeric Home team's player4.
home_player5 numeric Home team's player5.

Author(s)

Jason Lee

See Also

Other NBA PBP Functions: nba_data_pbp(), nba_live_pbp(), nba_pbps(), nba_playbyplayv3(), nba_winprobabilitypbp()

Get NBA Stats API play-by-play (Multiple Games)

Description

Get NBA Stats API play-by-play (Multiple Games)

Get NBA Stats API play-by-play (Multiple Games)

Usage

nba_pbps(
  game_ids = NULL,
  on_court = TRUE,
  version = "v3",
  nest_data = FALSE,
  ...
)

Arguments

game_ids

Game IDs
on_court

IF TRUE will be added ID of players on court
version

Play-by-play version ("v3" is the default, "v2" available from 2016-17 onwards)
nest_data

If TRUE returns nested data by game
...

Additional arguments passed to an underlying function like httr.

Details

y <- c("0022201086", "0022200021")

nba_pbps(game_ids = y)
nba_pbps(game_ids = y, version = "v2")

Value

Returns a data frame: PlayByPlay

col_name types description
game_id character Unique game identifier.
event_num character Sequential event number within the game (V2 PBP).
event_type character Event / play type code (V2 PBP).
event_action_type character Numeric event-action-type code (V2 PBP).
period numeric Period of the game (1-4 quarters; 5+ for OT).
clock character Game clock value.
minute_game numeric Minute game.
time_remaining numeric Time remaining.
wc_time_string character Wc time string.
time_quarter character Time quarter.
minute_remaining_quarter numeric Minute remaining quarter.
seconds_remaining_quarter numeric Seconds remaining quarter.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
home_description character Home team's description.
neutral_description character Neutral description.
visitor_description character Visitor description.
description character Long-form description text.
location character Location.
score character Final score.
away_score numeric Away team score at the time of the play.
home_score numeric Home team score at the time of the play.
score_margin character Score margin.
person1type character Person1type.
player1_id character V2 PBP primary player ID (e.g. shooter / fouler).
player1_name character V2 PBP primary player name.
player1_team_id character Team ID of player1.
player1_team_city character Player1 team city.
player1_team_nickname character Player1 team nickname.
player1_team_abbreviation character Player1 team abbreviation.
person2type character Person2type.
player2_id character V2 PBP secondary player ID (e.g. assister / fouled-by).
player2_name character V2 PBP secondary player name.
player2_team_id character Team ID of player2.
player2_team_city character Player2 team city.
player2_team_nickname character Player2 team nickname.
player2_team_abbreviation character Player2 team abbreviation.
person3type character Person3type.
player3_id character V2 PBP tertiary player ID (e.g. blocker).
player3_name character V2 PBP tertiary player name.
player3_team_id character Team ID of player3.
player3_team_city character Player3 team city.
player3_team_nickname character Player3 team nickname.
player3_team_abbreviation character Player3 team abbreviation.
video_available_flag character Video available flag.
team_leading character Team leading.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
points_total integer Running total of points scored.
shot_value integer Point value of the shot (2 or 3).
away_player1 numeric Away team's player1.
away_player2 numeric Away team's player2.
away_player3 numeric Away team's player3.
away_player4 numeric Away team's player4.
away_player5 numeric Away team's player5.
home_player1 numeric Home team's player1.
home_player2 numeric Home team's player2.
home_player3 numeric Home team's player3.
home_player4 numeric Home team's player4.
home_player5 numeric Home team's player5.

Author(s)

Jason Lee

See Also

Other NBA PBP Functions: nba_data_pbp(), nba_live_pbp(), nba_pbp(), nba_playbyplayv3(), nba_winprobabilitypbp()

Get NBA Stats API Play-by-Play V3

Description

Get NBA Stats API Play-by-Play V3

Get NBA Stats API Play-by-Play V3

Usage

nba_playbyplayv3(game_id, start_period = 0, end_period = 0, ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '0022201086')
start_period

Start period filter (default: 0 = all periods). Use 1-4 for regulation quarters, 5+ for overtime.
end_period

End period filter (default: 0 = all periods). Use 1-4 for regulation quarters, 5+ for overtime.
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playbyplayv3(game_id = "0022201086")

Value

Returns a named list of data frames: PlayByPlay, AvailableVideo

PlayByPlay

col_name types description
game_id character Unique game identifier.
action_number integer Sequential action number within a game (V3 PBP).
clock character Game clock value.
period integer Period of the game (1-4 quarters; 5+ for OT).
team_id integer Unique team identifier.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
person_id integer Unique player identifier (V3 endpoints).
player_name character Player name.
player_name_i character Player name i.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
score_home character Score home.
score_away character Score away.
points_total integer Running total of points scored.
location character Location.
description character Long-form description text.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
video_available integer Video available.
shot_value integer Point value of the shot (2 or 3).
action_id integer Unique action identifier within a game (V3 PBP).

AvailableVideo

col_name types description
video_available integer Video available.

Author(s)

Saiem Gilani

See Also

Other NBA PBP Functions: nba_data_pbp(), nba_live_pbp(), nba_pbp(), nba_pbps(), nba_winprobabilitypbp()

Get NBA Stats API Player Awards

Description

Get NBA Stats API Player Awards

Get NBA Stats API Player Awards

Usage

nba_playerawards(player_id, ...)

Arguments

player_id

Player ID
...

Additional arguments passed to an underlying function like httr.

Details

Player Awards 

 nba_playerawards(player_id = '2544')

Value

Return a named list of data frames: PlayerAwards

PlayerAwards

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
TEAM character Team-side label or team identifier.
DESCRIPTION character Long-form description text.
ALL_NBA_TEAM_NUMBER character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
MONTH character Month number.
WEEK character Week number within the season.
CONFERENCE character Conference.
TYPE character Record type / category.
SUBTYPE1 character
SUBTYPE2 character
SUBTYPE3 character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Career By College

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_playercareerbycollegerollup() instead.

Usage

nba_playercareerbycollege(
  college = "Florida State",
  league_id = "00",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

college

College Name
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playercareerbycollege(college = 'Florida State', per_mode = 'PerGame')

Value

Return a named list of data frames: PlayerCareerByCollege

PlayerCareerByCollege

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
COLLEGE character College or school attended.
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Career By College Rollup

Description

Get NBA Stats API Player Career By College Rollup

Get NBA Stats API Player Career By College Rollup

Usage

nba_playercareerbycollegerollup(
  league_id = "00",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playercareerbycollegerollup(per_mode = 'Totals')

Value

Return a named list of data frames: East, Midwest, South, West

East

col_name types description
REGION character Region label.
SEED character Tournament seed.
COLLEGE character College or school attended.
PLAYERS character
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

South

col_name types description
REGION character Region label.
SEED character Tournament seed.
COLLEGE character College or school attended.
PLAYERS character
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

Midwest

col_name types description
REGION character Region label.
SEED character Tournament seed.
COLLEGE character College or school attended.
PLAYERS character
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

West

col_name types description
REGION character Region label.
SEED character Tournament seed.
COLLEGE character College or school attended.
PLAYERS character
GP character Games played.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Career Stats

Description

Get NBA Stats API Player Career Stats

Get NBA Stats API Player Career Stats

Usage

nba_playercareerstats(
  league_id = "00",
  per_mode = "Totals",
  player_id = "2544",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode - PerGame, Totals
player_id

Player ID
...

Additional arguments passed to an underlying function like httr.

Details

Player Career Stats 

 nba_playercareerstats(player_id = '2544')

Value

Return a named list of data frames: CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsRegularSeason, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
Team_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
Team_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsAllStarSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsAllStarSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
Team_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsShowcaseSeason

CareerTotalsShowcaseSeason

SeasonRankingsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
RANK_MIN character
RANK_FGM character
RANK_FGA character
RANK_FG_PCT character
RANK_FG3M character
RANK_FG3A character
RANK_FG3_PCT character
RANK_FTM character
RANK_FTA character
RANK_FT_PCT character
RANK_OREB character
RANK_DREB character
RANK_REB character
RANK_AST character
RANK_STL character
RANK_BLK character
RANK_TOV character
RANK_PTS character
RANK_EFF character

SeasonRankingsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
RANK_MIN character
RANK_FGM character
RANK_FGA character
RANK_FG_PCT character
RANK_FG3M character
RANK_FG3A character
RANK_FG3_PCT character
RANK_FTM character
RANK_FTA character
RANK_FT_PCT character
RANK_OREB character
RANK_DREB character
RANK_REB character
RANK_AST character
RANK_STL character
RANK_BLK character
RANK_TOV character
RANK_PTS character
RANK_EFF character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Compare

Description

Get NBA Stats API Player Compare

Get NBA Stats API Player Compare

Usage

nba_playercompare(
  conference = "",
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id_list = "202681,203078,2544,201567,203954",
  plus_minus = "N",
  rank = "N",
  season = "2020-21",
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  vs_player_id_list = "201566,201939,201935,201142,203076",
  ...
)

Arguments

conference

conference
date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_id_list

Player ID
plus_minus

plus_minus
rank

rank
season

Season - format 2020-21
season_segment

season_segment
season_type

Season Type - Regular Season, Playoffs, All-Star
shot_clock_range

shot_clock_range
vs_conference

vs_conference
vs_division

vs_division
vs_player_id_list

vs_player_id_list
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playercompare(player_id_list = '202681,203078,2544,201567,203954', vs_player_id_list = '201566,201939,201935,201142,203076')

Value

Return a named list of data frames: Individual, OverallCompare

OverallCompare

col_name types description
GROUP_SET character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Individual

col_name types description
GROUP_SET character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Dashboard by Clutch Splits

Description

Get NBA Stats API Player Dashboard by Clutch Splits

Get NBA Stats API Player Dashboard by Game Splits

Get NBA Stats API Player Dashboard by General Splits

Get NBA Stats API Player Dashboard by Last N Games

Get NBA Stats API Player Dashboard by Opponent

Get NBA Stats API Player Dashboard by Shooting Splits

Get NBA Stats API Player Dashboard by Team Performance

Get NBA Stats API Player Dashboard Year over Year

Usage

nba_playerdashboardbyclutch(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbygamesplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbygeneralsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbylastngames(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbyopponent(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbyshootingsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbyteamperformance(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_playerdashboardbyyearoveryear(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_id

player_id
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Clutch Stats Dashboard 

 nba_playerdashboardbyclutch(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Game Splits 

 nba_playerdashboardbygamesplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by General Splits 

 nba_playerdashboardbygeneralsplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Last N Games 

 nba_playerdashboardbylastngames(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Opponent 

 nba_playerdashboardbyopponent(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Shooting Splits 

 nba_playerdashboardbyshootingsplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Team Performance 

 nba_playerdashboardbyteamperformance(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Stats Dashboard by Team Performance 

 nba_playerdashboardbyyearoveryear(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: Last10Sec3Point2PlayerDashboard, Last10Sec3PointPlayerDashboard, Last1Min5PointPlayerDashboard, Last1MinPlusMinus5PointPlayerDashboard, Last30Sec3Point2PlayerDashboard, Last30Sec3PointPlayerDashboard, Last3Min5PointPlayerDashboard, Last3MinPlusMinus5PointPlayerDashboard, Last5Min5PointPlayerDashboard, Last5MinPlusMinus5PointPlayerDashboard, OverallPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: ByActualMarginPlayerDashboard, ByHalfPlayerDashboard, ByPeriodPlayerDashboard, ByScoreMarginPlayerDashboard, OverallPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: DaysRestPlayerDashboard, LocationPlayerDashboard, MonthPlayerDashboard, OverallPlayerDashboard, PrePostAllStarPlayerDashboard, StartingPosition, WinsLossesPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: GameNumberPlayerDashboard, Last10PlayerDashboard, Last15PlayerDashboard, Last20PlayerDashboard, Last5PlayerDashboard, OverallPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: ConferencePlayerDashboard, DivisionPlayerDashboard, OpponentPlayerDashboard, OverallPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: AssistedBy, AssitedShotPlayerDashboard, OverallPlayerDashboard, Shot5FTPlayerDashboard, Shot8FTPlayerDashboard, ShotAreaPlayerDashboard, ShotTypePlayerDashboard, ShotTypeSummaryPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: OverallPlayerDashboard, PointsScoredPlayerDashboard, PointsAgainstPlayerDashboard, ScoreDifferentialPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Return a named list of data frames: ByYearPlayerDashboard, OverallPlayerDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Clutch Functions: nba_leaguedashteamclutch(), nba_teamdashboardbyclutch()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Dashboard Player Tracking - Passing

Description

Get NBA Stats API Player Dashboard Player Tracking - Passing

Get NBA Stats API Player Dashboard Player Tracking - Passing

Usage

nba_playerdashptpass(
  date_from = "",
  date_to = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "0",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
player_id

player_id
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Tracking (Second Spectrum) Stats - Passing 

 nba_playerdashptpass(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: PassesMade, PassesReceived

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Player Dashboard Player Tracking - Rebounding

Description

Get NBA Stats API Player Dashboard Player Tracking - Rebounding

Get NBA Stats API Player Dashboard Player Tracking - Rebounding

Usage

nba_playerdashptreb(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "0",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
period

period
player_id

player_id
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Tracking (Second Spectrum) Stats - Rebounding 

 nba_playerdashptreb(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: NumContestedRebounding, OverallRebounding, RebDistanceRebounding, ShotDistanceRebounding, ShotTypeRebounding

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Player Dashboard Player Tracking - Defense

Description

Get NBA Stats API Player Dashboard Player Tracking - Defense

Get NBA Stats API Player Dashboard Player Tracking - Defense

Usage

nba_playerdashptshotdefend(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "0",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
period

period
player_id

player_id
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Tracking (Second Spectrum) Stats - Defending 

 nba_playerdashptshotdefend(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: DefendingShots

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Player Dashboard Player Tracking - Shots

Description

Get NBA Stats API Player Dashboard Player Tracking - Shots

Get NBA Stats API Player Dashboard Player Tracking - Shots

Usage

nba_playerdashptshots(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "0",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
period

period
player_id

player_id
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Tracking (Second Spectrum) Stats - Shooting 

 nba_playerdashptshots(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: ClosestDefender10ftPlusShooting, ClosestDefenderShooting, DribbleShooting, GeneralShooting, Overall, ShotClockShooting, TouchTimeShooting

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Player Estimated Metrics

Description

Get NBA Stats API Player Estimated Metrics

Get NBA Stats API Player Estimated Metrics

Usage

nba_playerestimatedmetrics(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

Player Estimated Metrics 

 nba_playerestimatedmetrics()

Value

Return a named list of data frames: PlayerEstimatedMetrics

PlayerEstimatedMetrics

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
E_OFF_RATING character
E_DEF_RATING character
E_NET_RATING character
E_AST_RATIO character
E_OREB_PCT character
E_DREB_PCT character
E_REB_PCT character
E_TOV_PCT character
E_USG_PCT character
E_PACE character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
E_OFF_RATING_RANK character
E_DEF_RATING_RANK character
E_NET_RATING_RANK character
E_AST_RATIO_RANK character
E_OREB_PCT_RANK character
E_DREB_PCT_RANK character
E_REB_PCT_RANK character
E_TOV_PCT_RANK character
E_USG_PCT_RANK character
E_PACE_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Fantasy Profile

Description

Get NBA Stats API Player Fantasy Profile

Get NBA Stats API Player Fantasy Profile

Usage

nba_playerfantasyprofile(
  league_id = "00",
  measure_type = "Base",
  pace_adjust = "N",
  per_mode = "Totals",
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
measure_type

measure_type
pace_adjust

Pace Adjustment - Y/N
per_mode

Per Mode - PerGame, Totals
player_id

Player ID
plus_minus

Plus Minus - Y/N
rank

Rank - Y/N
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playerfantasyprofile(player_id = '2544')

Value

Return a named list of data frames: DaysRestModified, LastNGames, Location, Opponent, Overall

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

Location

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

LastNGames

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

DaysRestModified

col_name types description
GROUP_SET character
GROUP_VALUE character
SEASON_YEAR character Season year string ('YYYY-YY' format).
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

Opponent

col_name types description
GROUP_SET character
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
DD2 character
TD3 character
FAN_DUEL_PTS character
NBA_FANTASY_PTS character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Fantasy Functions: nba_fantasywidget(), nba_infographicfanduelplayer(), nba_playerfantasyprofilebargraph()

Get NBA Stats API Player Fantasy Profile Bar Graph

Description

Get NBA Stats API Player Fantasy Profile Bar Graph

Get NBA Stats API Player Fantasy Profile Bar Graph

Usage

nba_playerfantasyprofilebargraph(
  league_id = "00",
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
player_id

Player ID
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playerfantasyprofilebargraph(player_id = '2544')

Value

Return a named list of data frames: LastFiveGamesAvg, SeasonAvg

SeasonAvg

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
FG3M character Three-point field goals made.
FT_PCT character Free throw percentage (0-1).
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
FG_PCT character Field goal percentage (0-1).

LastFiveGamesAvg

col_name types description
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
FAN_DUEL_PTS character
NBA_FANTASY_PTS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
FG3M character Three-point field goals made.
FT_PCT character Free throw percentage (0-1).
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
FG_PCT character Field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Fantasy Functions: nba_fantasywidget(), nba_infographicfanduelplayer(), nba_playerfantasyprofile()

Get NBA Stats API Player Game Log

Description

Get NBA Stats API Player Game Log

Get NBA Stats API Player Game Log

Usage

nba_playergamelog(
  date_from = "",
  date_to = "",
  league_id = "00",
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

date_from

date_from
date_to

date_to
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
player_id

Player ID
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

Player Game Log 

 nba_playergamelog(player_id = '2544')

Value

Return a named list of data frames: PlayerGameLog

PlayerGameLog

col_name types description
SEASON_ID character Unique season identifier.
Player_ID character Unique player identifier.
Game_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
VIDEO_AVAILABLE character Video available.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Game Logs

Description

Get NBA Stats API Player Game Logs

Get NBA Stats API Player Game Logs

Usage

nba_playergamelogs(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
player_id

Player ID
season

Season - format 2020-21
season_segment

season_segment
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Player Game Logs 

 nba_playergamelogs(player_id = '2544')

Value

Return a named list of data frames: PlayerGameLogs

PlayerGameLogs

col_name types description
SEASON_YEAR character Season year string ('YYYY-YY' format).
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character
VIDEO_AVAILABLE_FLAG character Video available flag.

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Game Streak Finder

Description

Get NBA Stats API Player Game Streak Finder

Get NBA Stats API Player Game Streak Finder

Usage

nba_playergamestreakfinder(
  active_streaks_only = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  draft_year = "",
  draft_team_id = "",
  draft_round = "",
  draft_number = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  league_id = "00",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  min_games = "",
  outcome = "",
  po_round = "",
  player_id = "",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  starter_bench = "",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  years_experience = "",
  ...
)

Arguments

active_streaks_only

active_streaks_only
conference

conference
date_from

date_from
date_to

date_to
division

division
draft_year

draft_year
draft_team_id

draft_team_id
draft_round

draft_round
draft_number

draft_number
et_ast

et_ast
et_blk

et_blk
et_dd

et_dd
et_dreb

et_dreb
et_fg3a

et_fg3a
et_fg3m

et_fg3m
et_fg3_pct

et_fg3_pct
et_fga

et_fga
et_fgm

et_fgm
et_fg_pct

et_fg_pct
et_fta

et_fta
et_ftm

et_ftm
et_ft_pct

et_ft_pct
et_minutes

et_minutes
et_oreb

et_oreb
et_pf

et_pf
et_pts

et_pts
et_reb

et_reb
et_stl

et_stl
et_td

et_td
et_tov

et_tov
game_id

game_id
gt_ast

gt_ast
gt_blk

gt_blk
gt_dd

gt_dd
gt_dreb

gt_dreb
gt_fg3a

gt_fg3a
gt_fg3m

gt_fg3m
gt_fg3_pct

gt_fg3_pct
gt_fga

gt_fga
gt_fgm

gt_fgm
gt_fg_pct

gt_fg_pct
gt_fta

gt_fta
gt_ftm

gt_ftm
gt_ft_pct

gt_ft_pct
gt_minutes

gt_minutes
gt_oreb

gt_oreb
gt_pf

gt_pf
gt_pts

gt_pts
gt_reb

gt_reb
gt_stl

gt_stl
gt_td

gt_td
gt_tov

gt_tov
league_id

league_id
location

location
lt_ast

lt_ast
lt_blk

lt_blk
lt_dd

lt_dd
lt_dreb

lt_dreb
lt_fg3a

lt_fg3a
lt_fg3m

lt_fg3m
lt_fg3_pct

lt_fg3_pct
lt_fga

lt_fga
lt_fgm

lt_fgm
lt_fg_pct

lt_fg_pct
lt_fta

lt_fta
lt_ftm

lt_ftm
lt_ft_pct

lt_ft_pct
lt_minutes

lt_minutes
lt_oreb

lt_oreb
lt_pf

lt_pf
lt_pts

lt_pts
lt_reb

lt_reb
lt_stl

lt_stl
lt_td

lt_td
lt_tov

lt_tov
min_games

min_games
outcome

outcome
po_round

po_round
player_id

player_id
rookie_year

rookie_year
season

season
season_segment

season_segment
season_type

season_type
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_team_id

vs_team_id
years_experience

years_experience
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playergamestreakfinder()

Value

Return a named list of data frames: PlayerGameStreakFinderResults

PlayerGameStreakFinderResults

col_name types description
PLAYER_NAME_LAST_FIRST character
PLAYER_ID character Unique player identifier.
GAMESTREAK character
STARTDATE character
ENDDATE character
ACTIVESTREAK character
NUMSEASONS character
LASTSEASON character
FIRSTSEASON character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Other NBA Game Finder Functions: nba_leaguegamefinder(), nba_teamgamestreakfinder()

Get NBA Stats API Player Head-shot

Description

Get NBA Stats API Player Head-shot

Get NBA Stats API Player Head-shot

Usage

nba_playerheadshot(player_id = "2544", ...)

Arguments

player_id

Player ID
...

Additional arguments passed to an underlying function like httr.

Details

Player Headshot 

 nba_playerheadshot(player_id = '2544')

Value

Returns a url of the png for the player_id selected

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Index

Description

Get NBA Stats API Player Index

Get NBA Stats API Player Index

Usage

nba_playerindex(
  college = "",
  country = "",
  draft_pick = "",
  draft_round = "",
  draft_year = "",
  height = "",
  historical = 1,
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "0",
  weight = "",
  ...
)

Arguments

college

Player College
country

Player Country
draft_pick

Draft Pick
draft_round

Draft Round
draft_year

Draft Year
height

Player Height
historical

Whether to include only current players (0) or all historical (1).
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

Team ID. Default: 0 (all teams).
weight

Player weight
...

Additional arguments passed to an underlying function like httr.

Details

Player Index 

 nba_playerindex()

Value

Return a named list of data frames: PlayerIndex

PlayerIndex

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_LAST_NAME character
PLAYER_FIRST_NAME character
PLAYER_SLUG character URL-safe player identifier.
TEAM_ID character Unique team identifier.
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
IS_DEFUNCT character
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
JERSEY_NUMBER character
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
COLLEGE character College or school attended.
COUNTRY character Country (full name or code).
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
ROSTER_STATUS character
PTS character Points scored.
REB character Total rebounds.
AST character Assists.
STATS_TIMEFRAME character
FROM_YEAR character
TO_YEAR character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playernextngames(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Next N Games

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_playerprofilev2() instead.

Usage

nba_playernextngames(
  league_id = "",
  number_of_games = 2147483647,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
number_of_games

N in number of games
player_id

Player ID
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playernextngames(player_id = '2544')

Value

Return a named list of data frames: NextNGames

NextNGames

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
HOME_TEAM_NAME character Home team name.
VISITOR_TEAM_NAME character
HOME_TEAM_ABBREVIATION character
VISITOR_TEAM_ABBREVIATION character
HOME_TEAM_NICKNAME character
VISITOR_TEAM_NICKNAME character
GAME_TIME character Game start time.
HOME_WL character
VISITOR_WL character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playerprofilev2(), nba_playervsplayer()

Get NBA Stats API Player Profile V2

Description

Get NBA Stats API Player Profile V2

Get NBA Stats API Player Profile V2

Usage

nba_playerprofilev2(
  league_id = "",
  per_mode = "Totals",
  player_id = "2544",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Season - format 2020-21
player_id

Player ID
...

Additional arguments passed to an underlying function like httr.

Details

Player Profile 

 nba_playerprofilev2(player_id = '2544')

Value

Return a named list of data frames: CareerHighs, CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsPreseason, CareerTotalsRegularSeason, NextGame, SeasonHighs, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsPreseason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsAllStarSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsAllStarSeason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsPreseason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

CareerTotalsPreseason

col_name types description
PLAYER_ID character Unique player identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
GP character Games played.
GS character Games started.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

SeasonRankingsRegularSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
RANK_MIN character
RANK_FGM character
RANK_FGA character
RANK_FG_PCT character
RANK_FG3M character
RANK_FG3A character
RANK_FG3_PCT character
RANK_FTM character
RANK_FTA character
RANK_FT_PCT character
RANK_OREB character
RANK_DREB character
RANK_REB character
RANK_AST character
RANK_STL character
RANK_BLK character
RANK_TOV character
RANK_PTS character
RANK_EFF character

SeasonRankingsPostSeason

col_name types description
PLAYER_ID character Unique player identifier.
SEASON_ID character Unique season identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PLAYER_AGE character
GP character Games played.
GS character Games started.
RANK_MIN character
RANK_FGM character
RANK_FGA character
RANK_FG_PCT character
RANK_FG3M character
RANK_FG3A character
RANK_FG3_PCT character
RANK_FTM character
RANK_FTA character
RANK_FT_PCT character
RANK_OREB character
RANK_DREB character
RANK_REB character
RANK_AST character
RANK_STL character
RANK_BLK character
RANK_TOV character
RANK_PTS character
RANK_EFF character

SeasonHighs

col_name types description
PLAYER_ID character Unique player identifier.
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
VS_TEAM_ID character
VS_TEAM_CITY character
VS_TEAM_NAME character
VS_TEAM_ABBREVIATION character
STAT character Stat.
STAT_VALUE character
STAT_ORDER character
DATE_EST character

CareerHighs

col_name types description
PLAYER_ID character Unique player identifier.
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
VS_TEAM_ID character
VS_TEAM_CITY character
VS_TEAM_NAME character
VS_TEAM_ABBREVIATION character
STAT character Stat.
STAT_VALUE character
STAT_ORDER character
DATE_EST character

NextGame

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
GAME_TIME character Game start time.
LOCATION character Location.
PLAYER_TEAM_ID character
PLAYER_TEAM_CITY character
PLAYER_TEAM_NICKNAME character
PLAYER_TEAM_ABBREVIATION character
VS_TEAM_ID character
VS_TEAM_CITY character
VS_TEAM_NICKNAME character
VS_TEAM_ABBREVIATION character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playervsplayer()

Get NBA Stats API Player vs Player

Description

Get NBA Stats API Player vs Player

Get NBA Stats API Player vs Player

Usage

nba_playervsplayer(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "2544",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  vs_conference = "",
  vs_division = "",
  vs_player_id = "203076",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_id

Player ID
plus_minus

plus_minus
rank

rank
season

Season - format 2020-21
season_segment

season_segment
season_type

Season Type - Regular Season, Playoffs, All-Star
vs_conference

vs_conference
vs_division

vs_division
vs_player_id

vs_player_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playervsplayer(player_id = '2544', vs_player_id = '203076')

Value

Return a named list of data frames: OnOffCourt, Overall, PlayerInfo, ShotAreaOffCourt, ShotAreaOnCourt, ShotAreaOverall, ShotDistanceOffCourt, ShotDistanceOnCourt, ShotDistanceOverall, VsPlayerInfo

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character

OnOffCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character

ShotDistanceOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOnCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOffCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOnCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOffCourt

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

PlayerInfo

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
DISPLAY_FIRST_LAST character
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FI_LAST character
BIRTHDATE character
SCHOOL character Player's school / college (when distinct from 'college').
COUNTRY character Country (full name or code).
LAST_AFFILIATION character

VsPlayerInfo

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
FIRST_NAME character Player's first name.
LAST_NAME character Player's last name.
DISPLAY_FIRST_LAST character
DISPLAY_LAST_COMMA_FIRST character
DISPLAY_FI_LAST character
BIRTHDATE character
SCHOOL character Player's school / college (when distinct from 'college').
COUNTRY character Country (full name or code).
LAST_AFFILIATION character

Author(s)

Saiem Gilani

See Also

Other NBA Player Functions: nba_infographicfanduelplayer(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_matchupsrollup(), nba_playerawards(), nba_playercareerbycollege(), nba_playercareerbycollegerollup(), nba_playercareerstats(), nba_playercompare(), nba_playerdashboardbyclutch(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_playerestimatedmetrics(), nba_playerfantasyprofile(), nba_playerfantasyprofilebargraph(), nba_playergamelog(), nba_playergamelogs(), nba_playergamestreakfinder(), nba_playerheadshot(), nba_playerindex(), nba_playernextngames(), nba_playerprofilev2()

Get NBA Stats API Playoff Picture

Description

Get NBA Stats API Playoff Picture

Get NBA Stats API Playoff Picture

Usage

nba_playoffpicture(league_id = "00", season_id = "22022", ...)

Arguments

league_id

league_id
season_id

season_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_playoffpicture(league_id = '00', season_id = paste0(2, most_recent_nba_season() - 1))

Value

Return a named list of data frames: EastConfPlayoffPicture, EastConfRemainingGames, EastConfStandings, WestConfPlayoffPicture, WestConfRemainingGames, WestConfStandings

EastConfPlayoffPicture

col_name types description
CONFERENCE character Conference.
HIGH_SEED_RANK character
HIGH_SEED_TEAM character
HIGH_SEED_TEAM_ID character
LOW_SEED_RANK character
LOW_SEED_TEAM character
LOW_SEED_TEAM_ID character
HIGH_SEED_SERIES_W character
HIGH_SEED_SERIES_L character
HIGH_SEED_SERIES_REMAINING_G character
HIGH_SEED_SERIES_REMAINING_HOME_G character
HIGH_SEED_SERIES_REMAINING_AWAY_G character

WestConfPlayoffPicture

col_name types description
CONFERENCE character Conference.
HIGH_SEED_RANK character
HIGH_SEED_TEAM character
HIGH_SEED_TEAM_ID character
LOW_SEED_RANK character
LOW_SEED_TEAM character
LOW_SEED_TEAM_ID character
HIGH_SEED_SERIES_W character
HIGH_SEED_SERIES_L character
HIGH_SEED_SERIES_REMAINING_G character
HIGH_SEED_SERIES_REMAINING_HOME_G character
HIGH_SEED_SERIES_REMAINING_AWAY_G character

EastConfStandings

col_name types description
CONFERENCE character Conference.
RANK character Rank.
TEAM character Team-side label or team identifier.
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
TEAM_ID character Unique team identifier.
WINS character Total wins.
LOSSES character Total losses.
PCT character Pct.
DIV character
CONF character character.
HOME character Home.
AWAY character
GB character
GR_OVER_500 character
GR_OVER_500_HOME character
GR_OVER_500_AWAY character
GR_UNDER_500 character
GR_UNDER_500_HOME character
GR_UNDER_500_AWAY character
RANKING_CRITERIA character
CLINCHED_PLAYOFFS character
CLINCHED_CONFERENCE character
CLINCHED_DIVISION character
ELIMINATED_PLAYOFFS character
SOSA_REMAINING character

WestConfStandings

col_name types description
CONFERENCE character Conference.
RANK character Rank.
TEAM character Team-side label or team identifier.
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
TEAM_ID character Unique team identifier.
WINS character Total wins.
LOSSES character Total losses.
PCT character Pct.
DIV character
CONF character character.
HOME character Home.
AWAY character
GB character
GR_OVER_500 character
GR_OVER_500_HOME character
GR_OVER_500_AWAY character
GR_UNDER_500 character
GR_UNDER_500_HOME character
GR_UNDER_500_AWAY character
RANKING_CRITERIA character
CLINCHED_PLAYOFFS character
CLINCHED_CONFERENCE character
CLINCHED_DIVISION character
ELIMINATED_PLAYOFFS character
SOSA_REMAINING character

EastConfRemainingGames

col_name types description
TEAM character Team-side label or team identifier.
TEAM_ID character Unique team identifier.
REMAINING_G character
REMAINING_HOME_G character
REMAINING_AWAY_G character

WestConfRemainingGames

col_name types description
TEAM character Team-side label or team identifier.
TEAM_ID character Unique team identifier.
REMAINING_G character
REMAINING_HOME_G character
REMAINING_AWAY_G character

Author(s)

Saiem Gilani

See Also

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_shotchartleaguewide()

Get NBA Stats API Season Schedule

Description

Get NBA Stats API Season Schedule

Get NBA Stats API Season Schedule

Usage

nba_schedule(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season
...

Additional arguments passed to an underlying function like httr.

Details

 nba_schedule(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))
 nba_schedule(league_id = '20', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a tibble with the following columns:

col_name types description
game_date character Game date (YYYY-MM-DD).
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence integer Game sequence.
game_date_est character Game date est.
game_time_est character Game time est.
game_date_time_est character Game date time est.
game_date_utc character Game date utc.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_date_time_utc character Game date time utc.
away_team_time character Time / clock value.
home_team_time character Time / clock value.
day character Day number within the month.
month_num integer Month num.
week_number integer Week number.
week_name character Week name.
if_necessary character If necessary.
series_game_number character Series game number.
series_text character Series text.
arena_name character Arena name.
arena_state character Arena state.
arena_city character Arena city.
postponed_status character Postponed status.
branch_link character Branch link.
game_subtype character Game subtype.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_slug character Home team's team slug.
home_team_wins integer Home team's team wins.
home_team_losses integer Home team's team losses.
home_team_score integer Home team's score.
home_team_seed integer Home team's team seed.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_slug character Away team's team slug.
away_team_wins integer Away team's team wins.
away_team_losses integer Away team's team losses.
away_team_score integer Away team's score.
away_team_seed integer Away team's team seed.
season character Season identifier (4-digit year or 'YYYY-YY' string).
league_id character League identifier ('10' = WNBA).

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_scheduleleaguev2int(), nba_scoreboard(), nba_scoreboardv2(), nba_scoreboardv3(), nba_todays_scoreboard()

Get NBA Stats API International Schedule

Description

Get NBA Stats API International Schedule

Get NBA Stats API International Schedule

Usage

nba_scheduleleaguev2int(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format: '2023-24'
...

Additional arguments passed to an underlying function like httr.

Details

 nba_scheduleleaguev2int(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Returns a named list of data frames: SeasonGames, SeasonWeeks, BroadcasterList

SeasonGames

col_name types description
game_date character Game date (YYYY-MM-DD).
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status character Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence character Game sequence.
home_team_id character Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_slug character Home team's team slug.
home_team_wins character Home team's team wins.
home_team_losses character Home team's team losses.
home_team_score character Home team's score.
away_team_id character Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_slug character Away team's team slug.
away_team_wins character Away team's team wins.
away_team_losses character Away team's team losses.
away_team_score character Away team's score.
season character Season identifier (4-digit year or 'YYYY-YY' string).
league_id character League identifier ('10' = WNBA).

SeasonWeeks

col_name types description
league_id character League identifier ('10' = WNBA).
season_year character Season year string ('YYYY-YY' format).
week_number character Week number.
week_name character Week name.
start_date character Start date (YYYY-MM-DD).
end_date character End date (YYYY-MM-DD).

BroadcasterList

col_name types description
league_id character League identifier ('10' = WNBA).
season_year character Season year string ('YYYY-YY' format).
broadcaster_abbreviation character Broadcaster abbreviation.
broadcaster_display character Broadcaster display.
broadcaster_id character Unique identifier for broadcaster.
region_id character Unique identifier for region.

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_schedule(), nba_scoreboard(), nba_scoreboardv2(), nba_scoreboardv3(), nba_todays_scoreboard()

Get NBA Stats API Scoreboard

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_scoreboardv3() instead.

Usage

nba_scoreboard(league_id = "00", game_date = "2021-07-20", day_offset = 0, ...)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_date

Game Date
day_offset

Day Offset (integer 0,-1)
...

Additional arguments passed to an underlying function like httr.

Details

 nba_scoreboard(league_id = '00', game_date = '2021-07-20')

Value

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, WestConfStandingsByDay

GameHeader

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
GAME_STATUS_ID character Numeric game status identifier.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
GAMECODE character
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LIVE_PERIOD character
LIVE_PC_TIME character
NATL_TV_BROADCASTER_ABBREVIATION character
LIVE_PERIOD_TIME_BCAST character
WH_STATUS character Wh status.

LineScore

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME character
TEAM_WINS_LOSSES character
PTS_QTR1 character
PTS_QTR2 character
PTS_QTR3 character
PTS_QTR4 character
PTS_OT1 character
PTS_OT2 character
PTS_OT3 character
PTS_OT4 character
PTS_OT5 character
PTS_OT6 character
PTS_OT7 character
PTS_OT8 character
PTS_OT9 character
PTS_OT10 character
PTS character Points scored.
FG_PCT character Field goal percentage (0-1).
FT_PCT character Free throw percentage (0-1).
FG3_PCT character Three-point field goal percentage (0-1).
AST character Assists.
REB character Total rebounds.
TOV character Turnovers.

SeriesStandings

col_name types description
GAME_ID character Unique game identifier.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
GAME_DATE_EST character Game date est.
HOME_TEAM_WINS character Home team's team wins.
HOME_TEAM_LOSSES character Home team's team losses.
SERIES_LEADER character

LastMeeting

col_name types description
GAME_ID character Unique game identifier.
LAST_GAME_ID character
LAST_GAME_DATE_EST character
LAST_GAME_HOME_TEAM_ID character
LAST_GAME_HOME_TEAM_CITY character
LAST_GAME_HOME_TEAM_NAME character
LAST_GAME_HOME_TEAM_ABBREVIATION character
LAST_GAME_HOME_TEAM_POINTS character
LAST_GAME_VISITOR_TEAM_ID character
LAST_GAME_VISITOR_TEAM_CITY character
LAST_GAME_VISITOR_TEAM_NAME character
LAST_GAME_VISITOR_TEAM_CITY1 character
LAST_GAME_VISITOR_TEAM_POINTS character

EastConfStandingsByDay

col_name types description
TEAM_ID character Unique team identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
STANDINGSDATE character
CONFERENCE character Conference.
TEAM character Team-side label or team identifier.
G character Games played.
W character Wins.
L character Losses.
W_PCT character
HOME_RECORD character Home win-loss record.
ROAD_RECORD character

WestConfStandingsByDay

col_name types description
TEAM_ID character Unique team identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
STANDINGSDATE character
CONFERENCE character Conference.
TEAM character Team-side label or team identifier.
G character Games played.
W character Wins.
L character Losses.
W_PCT character
HOME_RECORD character Home win-loss record.
ROAD_RECORD character

Available

col_name types description
GAME_ID character Unique game identifier.
PT_AVAILABLE character Pt available.

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_schedule(), nba_scheduleleaguev2int(), nba_scoreboardv2(), nba_scoreboardv3(), nba_todays_scoreboard()

Get NBA Stats API Scoreboard V2

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/partial; use nba_scoreboardv3() instead.

Usage

nba_scoreboardv2(
  league_id = "00",
  game_date = "2021-07-20",
  day_offset = 0,
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_date

Game Date
day_offset

Day Offset (integer 0,-1)
...

Additional arguments passed to an underlying function like httr.

Details

 nba_scoreboardv2(league_id = '00', game_date = '2021-07-20')

Value

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, TeamLeaders, TicketLinks, WestConfStandingsByDay, WinProbability

GameHeader

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
GAME_STATUS_ID character Numeric game status identifier.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
GAMECODE character
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
SEASON character Season identifier (4-digit year or 'YYYY-YY' string).
LIVE_PERIOD character
LIVE_PC_TIME character
NATL_TV_BROADCASTER_ABBREVIATION character
HOME_TV_BROADCASTER_ABBREVIATION character
AWAY_TV_BROADCASTER_ABBREVIATION character
LIVE_PERIOD_TIME_BCAST character
ARENA_NAME character Arena name.
WH_STATUS character Wh status.
WNBA_COMMISSIONER_FLAG character

LineScore

col_name types description
GAME_DATE_EST character Game date est.
GAME_SEQUENCE character Game sequence.
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CITY_NAME character
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_WINS_LOSSES character
PTS_QTR1 character
PTS_QTR2 character
PTS_QTR3 character
PTS_QTR4 character
PTS_OT1 character
PTS_OT2 character
PTS_OT3 character
PTS_OT4 character
PTS_OT5 character
PTS_OT6 character
PTS_OT7 character
PTS_OT8 character
PTS_OT9 character
PTS_OT10 character
PTS character Points scored.
FG_PCT character Field goal percentage (0-1).
FT_PCT character Free throw percentage (0-1).
FG3_PCT character Three-point field goal percentage (0-1).
AST character Assists.
REB character Total rebounds.
TOV character Turnovers.

SeriesStandings

col_name types description
GAME_ID character Unique game identifier.
HOME_TEAM_ID character Unique identifier for the home team.
VISITOR_TEAM_ID character
GAME_DATE_EST character Game date est.
HOME_TEAM_WINS character Home team's team wins.
HOME_TEAM_LOSSES character Home team's team losses.
SERIES_LEADER character

LastMeeting

col_name types description
GAME_ID character Unique game identifier.
LAST_GAME_ID character
LAST_GAME_DATE_EST character
LAST_GAME_HOME_TEAM_ID character
LAST_GAME_HOME_TEAM_CITY character
LAST_GAME_HOME_TEAM_NAME character
LAST_GAME_HOME_TEAM_ABBREVIATION character
LAST_GAME_HOME_TEAM_POINTS character
LAST_GAME_VISITOR_TEAM_ID character
LAST_GAME_VISITOR_TEAM_CITY character
LAST_GAME_VISITOR_TEAM_NAME character
LAST_GAME_VISITOR_TEAM_CITY1 character
LAST_GAME_VISITOR_TEAM_POINTS character

EastConfStandingsByDay

col_name types description
TEAM_ID character Unique team identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
STANDINGSDATE character
CONFERENCE character Conference.
TEAM character Team-side label or team identifier.
G character Games played.
W character Wins.
L character Losses.
W_PCT character
HOME_RECORD character Home win-loss record.
ROAD_RECORD character

WestConfStandingsByDay

col_name types description
TEAM_ID character Unique team identifier.
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
STANDINGSDATE character
CONFERENCE character Conference.
TEAM character Team-side label or team identifier.
G character Games played.
W character Wins.
L character Losses.
W_PCT character
HOME_RECORD character Home win-loss record.
ROAD_RECORD character

Available

col_name types description
GAME_ID character Unique game identifier.
PT_AVAILABLE character Pt available.

TeamLeaders

col_name types description
GAME_ID character Unique game identifier.
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NICKNAME character Team nickname.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
PTS_PLAYER_ID character
PTS_PLAYER_NAME character
PTS character Points scored.
REB_PLAYER_ID character
REB_PLAYER_NAME character
REB character Total rebounds.
AST_PLAYER_ID character
AST_PLAYER_NAME character
AST character Assists.

TicketLinks

WinProbability

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_schedule(), nba_scheduleleaguev2int(), nba_scoreboard(), nba_scoreboardv3(), nba_todays_scoreboard()

Get NBA Stats API Scoreboard V3

Description

Get NBA Stats API Scoreboard V3

Get NBA Stats API Scoreboard V3

Usage

nba_scoreboardv3(league_id = "00", game_date = "2023-03-26", ...)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
game_date

Game Date
...

Additional arguments passed to an underlying function like httr.

Details

 nba_scoreboardv3(league_id = '00', game_date = '2023-03-26')

Value

Return a tibble with the following scoreboard data:

col_name types description
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_date character Game date (YYYY-MM-DD).
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_slug character Home team's team slug.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_slug character Away team's team slug.
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
regulation_periods integer Regulation periods.
series_game_number character Series game number.
series_text character Series text.
if_necessary logical If necessary.
series_conference character Series conference.
po_round_desc character Po round desc.
game_subtype character Game subtype.
game_home_leaders_person_id integer Unique identifier for game home leaders person.
game_home_leaders_name character Game home leaders name.
game_home_leaders_player_slug character Game home leaders player slug.
game_home_leaders_jersey_num character Game home leaders jersey num.
game_home_leaders_position character Game home leaders position.
game_home_leaders_team_tricode character Game home leaders team tricode.
game_home_leaders_points integer Game home leaders points.
game_home_leaders_rebounds integer Game home leaders rebounds.
game_home_leaders_assists integer Game home leaders assists.
game_away_leaders_person_id integer Unique identifier for game away leaders person.
game_away_leaders_name character Game away leaders name.
game_away_leaders_player_slug character Game away leaders player slug.
game_away_leaders_jersey_num character Game away leaders jersey num.
game_away_leaders_position character Game away leaders position.
game_away_leaders_team_tricode character Game away leaders team tricode.
game_away_leaders_points integer Game away leaders points.
game_away_leaders_rebounds integer Game away leaders rebounds.
game_away_leaders_assists integer Game away leaders assists.
team_home_leaders_person_id integer Unique identifier for team home leaders person.
team_home_leaders_name character Team home leaders name.
team_home_leaders_player_slug character Team home leaders player slug.
team_home_leaders_jersey_num character Team home leaders jersey num.
team_home_leaders_position character Team home leaders position.
team_home_leaders_team_tricode character Team home leaders team tricode.
team_home_leaders_points numeric Team home leaders points.
team_home_leaders_rebounds numeric Team home leaders rebounds.
team_home_leaders_assists numeric Team home leaders assists.
team_away_leaders_person_id integer Unique identifier for team away leaders person.
team_away_leaders_name character Team away leaders name.
team_away_leaders_player_slug character Team away leaders player slug.
team_away_leaders_jersey_num character Team away leaders jersey num.
team_away_leaders_position character Team away leaders position.
team_away_leaders_team_tricode character Team away leaders team tricode.
team_away_leaders_points numeric Team away leaders points.
team_away_leaders_rebounds numeric Team away leaders rebounds.
team_away_leaders_assists numeric Team away leaders assists.
team_season_leaders_flag integer Team season leaders flag.
home_wins integer Home team's wins.
home_losses integer Home team's losses.
home_score integer Home team score at the time of the play.
home_seed integer Home team's seed.
home_in_bonus logical Home team's in bonus.
home_timeouts_remaining integer Home team's timeouts remaining.
home_periods list Home team's periods.
away_wins integer Away team's wins.
away_losses integer Away team's losses.
away_score integer Away team score at the time of the play.
away_seed integer Away team's seed.
away_in_bonus logical Away team's in bonus.
away_timeouts_remaining integer Away team's timeouts remaining.
away_periods list Away team's periods.
league_id character League identifier ('10' = WNBA).
league character League.
broadcasters data.frame

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_schedule(), nba_scheduleleaguev2int(), nba_scoreboard(), nba_scoreboardv2(), nba_todays_scoreboard()

Get NBA Stats API Shot Chart Detail

Description

Get NBA Stats API Shot Chart Detail

Get NBA Stats API Shot Chart Detail

Usage

nba_shotchartdetail(
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  game_id = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  period = 0,
  player_id = "202696",
  player_position = "",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = 0,
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

context_measure

context_measure
date_from

date_from
date_to

date_to
game_id

game_id
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
period

period
player_id

player_id
player_position

player_position
rookie_year

rookie_year
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_shotchartdetail(league_id = '00', player_id = '202696', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: LeagueAverages, Shot_Chart_Detail

Shot_Chart_Detail

col_name types description
GRID_TYPE character
GAME_ID character Unique game identifier.
GAME_EVENT_ID character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERIOD character Period of the game (1-4 quarters; 5+ for OT).
MINUTES_REMAINING character
SECONDS_REMAINING character Seconds remaining in the period.
EVENT_TYPE character Event / play type code (V2 PBP).
ACTION_TYPE character Action type label (e.g. 'Made Shot', 'Substitution').
SHOT_TYPE character Shot type label (e.g. 'Jump Shot', 'Layup').
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
SHOT_DISTANCE character Shot distance from the basket, in feet.
LOC_X character X coordinate on the court (units of inches; 0 = basket center).
LOC_Y character Y coordinate on the court (units of inches; baseline at 0).
SHOT_ATTEMPTED_FLAG character 1 if a shot was attempted on this event.
SHOT_MADE_FLAG character 1 if the shot was made; 0 if missed.
GAME_DATE character Game date (YYYY-MM-DD).
HTM character
VTM character

LeagueAverages

col_name types description
GRID_TYPE character
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
FGA character Field goal attempts.
FGM character Field goals made.
FG_PCT character Field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartleaguewide(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Get NBA Stats API Shot Chart League-Wide

Description

Get NBA Stats API Shot Chart League-Wide

Get NBA Stats API Shot Chart League-Wide

Usage

nba_shotchartleaguewide(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

season
...

Additional arguments passed to an underlying function like httr.

Details

 nba_shotchartleaguewide(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: League_Wide

League_Wide

col_name types description
GRID_TYPE character
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
FGA character Field goal attempts.
FGM character Field goals made.
FG_PCT character Field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartlineupdetail(), nba_teamdashboardbyclutch()

Other NBA League Functions: nba_iststandings(), nba_leaguedashlineups(), nba_leaguedashoppptshot(), nba_leaguedashplayerbiostats(), nba_leaguedashplayerclutch(), nba_leaguedashplayerptshot(), nba_leaguedashplayershotlocations(), nba_leaguedashplayerstats(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamclutch(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_leaguedashteamstats(), nba_leaguegamefinder(), nba_leaguegamelog(), nba_leaguelineupviz(), nba_leagueplayerondetails(), nba_leagueseasonmatchups(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_matchupsrollup(), nba_playoffpicture()

Get NBA Stats API Shot Chart for Lineups

Description

Get NBA Stats API Shot Chart for Lineups

Get NBA Stats API Shot Chart for Lineups

Usage

nba_shotchartlineupdetail(
  ahead_behind = "",
  cfid = "",
  cfparams = "",
  clutch_time = "",
  conference = "",
  context_filter = "",
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  division = "",
  end_period = "10",
  end_range = "28800",
  group_id = "-202689-203493-203501-1626174-1627827-",
  game_event_id = "",
  game_id = "",
  game_segment = "",
  group_mode = "",
  group_quantity = "5",
  last_n_games = "0",
  league_id = "00",
  location = "",
  month = "0",
  on_off = "",
  opp_player_id = "",
  opponent_team_id = "0",
  outcome = "",
  po_round = "0",
  period = "0",
  player_id = "0",
  player_id1 = "",
  player_id2 = "",
  player_id3 = "",
  player_id4 = "",
  player_id5 = "",
  player_position = "",
  point_diff = "",
  position = "",
  range_type = "0",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  start_period = "1",
  start_range = "0",
  starter_bench = "",
  team_id = "1610612742",
  vs_conference = "",
  vs_division = "",
  vs_player_id1 = "",
  vs_player_id2 = "",
  vs_player_id3 = "",
  vs_player_id4 = "",
  vs_player_id5 = "",
  vs_team_id = "",
  ...
)

Arguments

ahead_behind

ahead_behind
cfid

cfid
cfparams

cfparams
clutch_time

clutch_time
conference

conference
context_filter

context_filter
context_measure

context_measure
date_from

date_from
date_to

date_to
division

division
end_period

end_period
end_range

end_range
group_id

group_id
game_event_id

game_event_id
game_id

game_id
game_segment

game_segment
group_mode

group_mode
group_quantity

group_quantity
last_n_games

last_n_games
league_id

league_id
location

location
month

month
on_off

on_off
opp_player_id

opp_player_id
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
period

period
player_id

player_id
player_id1

player_id1
player_id2

player_id2
player_id3

player_id3
player_id4

player_id4
player_id5

player_id5
player_position

player_position
point_diff

point_diff
position

position
range_type

range_type
rookie_year

rookie_year
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
start_period

start_period
start_range

start_range
starter_bench

starter_bench
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_player_id1

vs_player_id1
vs_player_id2

vs_player_id2
vs_player_id3

vs_player_id3
vs_player_id4

vs_player_id4
vs_player_id5

vs_player_id5
vs_team_id

vs_team_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_shotchartlineupdetail(group_id = '-202689-203493-203501-1626174-1627827-',
                           group_id2 = '-202689-203493-203501-1626174-1627827-',
                           season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: ShotChartLineupDetail, ShotChartLineupLeagueAverage

ShotChartLineupDetail

col_name types description
GRID_TYPE character
GAME_ID character Unique game identifier.
GAME_EVENT_ID character
GROUP_ID character Group identifier (e.g. conference group_id).
GROUP_NAME character Group name.
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
PERIOD character Period of the game (1-4 quarters; 5+ for OT).
MINUTES_REMAINING character
SECONDS_REMAINING character Seconds remaining in the period.
EVENT_TYPE character Event / play type code (V2 PBP).
ACTION_TYPE character Action type label (e.g. 'Made Shot', 'Substitution').
SHOT_TYPE character Shot type label (e.g. 'Jump Shot', 'Layup').
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
SHOT_DISTANCE character Shot distance from the basket, in feet.
LOC_X character X coordinate on the court (units of inches; 0 = basket center).
LOC_Y character Y coordinate on the court (units of inches; baseline at 0).
SHOT_ATTEMPTED_FLAG character 1 if a shot was attempted on this event.
SHOT_MADE_FLAG character 1 if the shot was made; 0 if missed.
GAME_DATE character Game date (YYYY-MM-DD).
HTM character
VTM character

ShotChartLineupLeagueAverage

col_name types description
GRID_TYPE character
SHOT_ZONE_BASIC character Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
SHOT_ZONE_AREA character Shot zone area ('Left Side', 'Right Side', 'Center').
SHOT_ZONE_RANGE character Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
FGA character Field goal attempts.
FGM character Field goals made.
FG_PCT character Field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_teamdashboardbyclutch()

Other NBA Lineup Functions: nba_gamerotation(), nba_leaguedashlineups(), nba_leaguelineupviz(), nba_teamdashlineups()

NBA Stats API Endpoint Overview

Description

Wrappers around the NBA Stats backend at stats.nba.com/stats/.... All requests go through request_with_proxy() (in utils_nba_stats.R) which sets the required NBA-side headers (x-nba-stats-origin: stats, x-nba-stats-token: true, ⁠Referer: https://www.nba.com/⁠) and threads a proxy via getOption("hoopR.proxy") / env vars / explicit ⁠proxy =⁠ arg.

Details

Boxscores (V2)

Tabular resultSets[] responses parsed via nba_stats_map_result_sets(). See nba_boxscoreadvancedv2(), nba_boxscoretraditionalv2(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv2(), nba_boxscorematchups(), nba_boxscoremiscv2(), nba_boxscoreplayertrackv2(), nba_boxscorescoringv2(), nba_boxscoresimilarityscore(), nba_boxscoresummaryv2(), nba_boxscoreusagev2(), nba_hustlestatsboxscore().

Boxscores (V3)

Nested JSON responses parsed via purrr::pluck(). See nba_boxscoreadvancedv3(), nba_boxscoredefensivev2(), nba_boxscorefourfactorsv3(), nba_boxscorehustlev2(), nba_boxscorematchupsv3(), nba_boxscoremiscv3(), nba_boxscoreplayertrackv3(), nba_boxscorescoringv3(), nba_boxscoretraditionalv3(), nba_boxscoreusagev3().

Play-by-play

Function Purpose
nba_pbp() V2 + V3 play-by-play (with V3-to-V2 conversion pipeline)
nba_pbps() Multi-game PBP loader
nba_playbyplayv3() V3-only PBP
nba_pbp_v2 V2-only PBP (legacy)
nba_data_pbp() Data.nba.com PBP scraper
nba_live_pbp() Live PBP (CDN feed)
nba_live_boxscore() Live boxscore (CDN feed)
nba_winprobabilitypbp() Win-probability PBP overlay

Leaders / standings / league

See nba_leagueleaders(), nba_leaguestandings(), nba_leaguestandingsv3(), nba_iststandings(), nba_dunkscoreleaders(), nba_gravityleaders(), nba_homepageleaders(), nba_leaderstiles().

Player + team season + game stats

Full per-mode / per-split families. Search the reference index for ⁠nba_playerdashboard*⁠, ⁠nba_teamdashboard*⁠, ⁠nba_playerprofile*⁠, nba_playergamelogs(), nba_teamgamelogs(), nba_leaguedashplayerstats(), nba_leaguedashteamstats().

Schedule + scoreboard

nba_schedule(), nba_scheduleleaguev2int(), nba_scoreboard(), nba_scoreboardv2(), nba_scoreboardv3(), nba_todays_scoreboard().

Draft + franchise + reference

nba_draftboard(), nba_drafthistory(), nba_draftcombinestats(), nba_draftcombinedrillresults(), nba_draftcombineplayeranthro(), nba_draftcombinenonstationaryshooting(), nba_draftcombinespotshooting(), nba_franchisehistory(), nba_franchiseleaders(), nba_franchiseleaderswrank(), nba_franchiseplayers().

Get NBA Stats API Synergy Play Type Stats

Description

Get NBA Stats API Synergy Play Type Stats

Get NBA Stats API Synergy Play Type Stats

Usage

nba_synergyplaytypes(
  league_id = "00",
  per_mode = "PerGame",
  play_type = "Isolation",
  player_or_team = "P",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  type_grouping = "Offensive",
  ...
)

Arguments

league_id

league_id
per_mode

per_mode
play_type

play_type - 'Isolation', 'Transition', 'PRBallHandler', 'PRRollman', 'Postup', 'Spotup', 'Handoff', 'Cut', 'OffScreen', 'OffRebound', 'Misc'
player_or_team

player_or_team ('P' or 'T')
season

season
season_type

season_type
type_grouping

type_grouping - Offensive, Defensive
...

Additional arguments passed to an underlying function like httr.

Details

Synergy Play Type Stats 

 nba_synergyplaytypes(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: SynergyPlayType

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_playerdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Team and Players vs Players

Description

Get NBA Stats API Team and Players vs Players

Get NBA Stats API Team and Players vs Players

Usage

nba_teamandplayersvsplayers(
  team_id,
  vs_team_id,
  player_id1,
  player_id2,
  player_id3,
  player_id4,
  player_id5,
  vs_player_id1,
  vs_player_id2,
  vs_player_id3,
  vs_player_id4,
  vs_player_id5,
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  measure_type = "Base",
  per_mode = "Totals",
  plus_minus = "N",
  pace_adjust = "N",
  rank = "N",
  league_id = "00",
  last_n_games = 0,
  month = 0,
  opponent_team_id = 0,
  period = 0,
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  game_segment = "",
  location = "",
  outcome = "",
  season_segment = "",
  shot_clock_range = "",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

team_id

Team ID
vs_team_id

Opponent Team ID to compare against
player_id1

Player ID 1 for team lineup
player_id2

Player ID 2 for team lineup
player_id3

Player ID 3 for team lineup
player_id4

Player ID 4 for team lineup
player_id5

Player ID 5 for team lineup
vs_player_id1

Opponent Player ID 1 for comparison lineup
vs_player_id2

Opponent Player ID 2 for comparison lineup
vs_player_id3

Opponent Player ID 3 for comparison lineup
vs_player_id4

Opponent Player ID 4 for comparison lineup
vs_player_id5

Opponent Player ID 5 for comparison lineup
season

Season - format: '2023-24'
season_type

Season Type - 'Regular Season', 'Playoffs'
measure_type

Measure Type - 'Base', 'Advanced', 'Misc', 'Scoring', 'Usage'
per_mode

Per Mode - 'Totals', 'PerGame', 'Per36', 'Per48'
plus_minus

Plus Minus - 'Y' or 'N'
pace_adjust

Pace Adjust - 'Y' or 'N'
rank

Rank - 'Y' or 'N'
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
last_n_games

Last N Games filter
month

Month filter (0 for all)
opponent_team_id

Opponent Team ID filter
period

Period filter (0 for all)
conference

Conference filter - 'East', 'West', or ”
date_from

Date From filter - format: 'MM/DD/YYYY'
date_to

Date To filter - format: 'MM/DD/YYYY'
division

Division filter
game_segment

Game Segment - 'First Half', 'Second Half', 'Overtime', or ”
location

Location filter - 'Home', 'Road', or ”
outcome

Outcome filter - 'W', 'L', or ”
season_segment

Season Segment - 'Pre All-Star', 'Post All-Star', or ”
shot_clock_range

Shot Clock Range filter
vs_conference

Opponent Conference filter
vs_division

Opponent Division filter
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamandplayersvsplayers(
   team_id = '1610612739',
   vs_team_id = '1610612765',
   player_id1 = '202681', player_id2 = '203078',
   player_id3 = '203507', player_id4 = '201567',
   player_id5 = '203954',
   vs_player_id1 = '201566', vs_player_id2 = '201939',
   vs_player_id3 = '201935', vs_player_id4 = '201142',
   vs_player_id5 = '203076',
   season = '2019-20')

Value

Returns a named list of data frames: PlayersVsPlayers, TeamPlayersVsPlayersOff, TeamPlayersVsPlayersOn, TeamVsPlayers, TeamVsPlayersOff

PlayersVsPlayers

col_name types description
GROUP_SET character
TITLE_DESCRIPTION character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamPlayersVsPlayersOn

col_name types description
GROUP_SET character
TITLE_DESCRIPTION character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamPlayersVsPlayersOff

col_name types description
GROUP_SET character
TITLE_DESCRIPTION character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamVsPlayers

col_name types description
GROUP_SET character
TITLE_DESCRIPTION character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

TeamVsPlayersOff

col_name types description
GROUP_SET character
TITLE_DESCRIPTION character
DESCRIPTION character Long-form description text.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Dashboard by Clutch Splits

Description

Get NBA Stats API Team Dashboard by Clutch Splits

Get NBA Stats API Team Dashboard by Game Splits

Get NBA Stats API Team Dashboard by General Splits

Get NBA Stats API Team Dashboard by Last N Games

Get NBA Stats API Team Dashboard by Opponent

Get NBA Stats API Team Dashboard by Shooting Splits

Get NBA Stats API Team Dashboard by Team Performance

Get NBA Stats API Team Dashboard Year over Year

Usage

nba_teamdashboardbyclutch(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbygamesplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbygeneralsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbylastngames(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbyopponent(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbyshootingsplits(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbyteamperformance(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

nba_teamdashboardbyyearoveryear(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
po_round

po_round
per_mode

per_mode
period

period
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Clutch Stats Dashboard 

 nba_teamdashboardbyclutch(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Game Splits 

 nba_teamdashboardbygamesplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by General Splits 

 nba_teamdashboardbygeneralsplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Last N Games 

 nba_teamdashboardbylastngames(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Opponent 

 nba_teamdashboardbyopponent(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Shooting Splits 

 nba_teamdashboardbyshootingsplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Team Performance 

 nba_teamdashboardbyteamperformance(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Dashboard by Year over Year 

 nba_teamdashboardbyyearoveryear(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: Last10Sec3Point2TeamDashboard, Last10Sec3PointTeamDashboard, Last1Min5PointTeamDashboard, Last1MinPlusMinus5PointTeamDashboard, Last30Sec3Point2TeamDashboard, Last30Sec3PointTeamDashboard, Last3Min5PointTeamDashboard, Last3MinPlusMinus5PointTeamDashboard, Last5Min5PointTeamDashboard, Last5MinPlusMinus5PointTeamDashboard, OverallTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: ByActualMarginTeamDashboard, ByHalfTeamDashboard, ByPeriodTeamDashboard, ByScoreMarginTeamDashboard, OverallTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: DaysRestTeamDashboard, LocationTeamDashboard, MonthTeamDashboard, OverallTeamDashboard, PrePostAllStarTeamDashboard, WinsLossesTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: GameNumberTeamDashboard, Last10TeamDashboard, Last15TeamDashboard, Last20TeamDashboard, Last5TeamDashboard, OverallTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: ConferenceTeamDashboard, DivisionTeamDashboard, OpponentTeamDashboard, OverallTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: AssistedBy, AssitedShotTeamDashboard, OverallTeamDashboard, Shot5FTTeamDashboard, Shot8FTTeamDashboard, ShotAreaTeamDashboard, ShotTypeTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: OverallTeamDashboard, PointsScoredTeamDashboard, PontsAgainstTeamDashboard, ScoreDifferentialTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Return a named list of data frames: ByYearTeamDashboard, OverallTeamDashboard

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Clutch Functions: nba_leaguedashteamclutch(), nba_playerdashboardbyclutch()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Shooting Functions: nba_leaguedashplayershotlocations(), nba_leaguedashteamptshot(), nba_leaguedashteamshotlocations(), nba_playerdashboardbyclutch(), nba_shotchartdetail(), nba_shotchartleaguewide(), nba_shotchartlineupdetail()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Dashboard - Lineups

Description

Get NBA Stats API Team Dashboard - Lineups

Get NBA Stats API Team Dashboard - Lineups

Usage

nba_teamdashlineups(
  date_from = "",
  date_to = "",
  game_id = "",
  game_segment = "",
  group_quantity = 5,
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_id

game_id
game_segment

game_segment
group_quantity

group_quantity
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
po_round

po_round
per_mode

per_mode
period

period
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Lineups Dashboard 

 nba_teamdashlineups(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: Lineups, Overall

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Lineup Functions: nba_gamerotation(), nba_leaguedashlineups(), nba_leaguelineupviz(), nba_shotchartlineupdetail()

Get NBA Stats API Team Dashboard Player Tracking - Passing

Description

Get NBA Stats API Team Dashboard Player Tracking - Passing

Get NBA Stats API Team Dashboard Player Tracking - Passing

Usage

nba_teamdashptpass(
  date_from = "",
  date_to = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Player Tracking (Second Spectrum) Stats - Passing 

 nba_teamdashptpass(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: PassesMade, PassesReceived

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptreb(), nba_teamdashptshots()

Get NBA Stats API Team Dashboard Player Tracking - Rebounding

Description

Get NBA Stats API Team Dashboard Player Tracking - Rebounding

Get NBA Stats API Team Dashboard Player Tracking - Rebounding

Usage

nba_teamdashptreb(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  period = 0,
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
period

period
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Player Tracking (Second Spectrum) Stats - Rebounds 

 nba_teamdashptreb(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: NumContestedRebounding, OverallRebounding, RebDistanceRebounding, ShotDistanceRebounding, ShotTypeRebounding

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptshots()

Get NBA Stats API Team Dashboard Player Tracking - Shots

Description

Get NBA Stats API Team Dashboard Player Tracking - Shots

Get NBA Stats API Team Dashboard Player Tracking - Shots

Usage

nba_teamdashptshots(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  per_mode = "Totals",
  period = 0,
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
per_mode

per_mode
period

period
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Team Player Tracking (Second Spectrum) Stats - Shooting 

 nba_teamdashptshots(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Value

Return a named list of data frames: ClosestDefender10ftPlusShooting, ClosestDefenderShooting, DribbleShooting, GeneralShooting, ShotClockShooting, TouchTimeShooting

Column schemas omitted from help to keep the package under the CRAN 5 MB installed-size limit. See the package source at tools/docs/nba_teamdashboard_columns.md for full column tables.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Player Tracking Functions: nba_boxscoreplayertrackv2(), nba_leaguedashoppptshot(), nba_leaguedashplayerptshot(), nba_leaguedashptdefend(), nba_leaguedashptstats(), nba_leaguedashptteamdefend(), nba_leaguedashteamptshot(), nba_playerdashptpass(), nba_playerdashptreb(), nba_playerdashptshotdefend(), nba_playerdashptshots(), nba_synergyplaytypes(), nba_teamdashptpass(), nba_teamdashptreb()

Get NBA Stats API Team Details

Description

Get NBA Stats API Team Details

Get NBA Stats API Team Details

Usage

nba_teamdetails(team_id = "1610612749", ...)

Arguments

team_id

Team ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamdetails(team_id = '1610612749')

Value

Return a named list of data frames: TeamAwardsChampionships, TeamAwardsConf, TeamAwardsDiv, TeamBackground, TeamHistory, TeamHof, TeamRetired, TeamSocialSites

TeamBackground

col_name types description
TEAM_ID character Unique team identifier.
ABBREVIATION character Short abbreviation.
NICKNAME character Team or athlete nickname.
YEARFOUNDED character
CITY character City.
ARENA character Arena.
ARENACAPACITY character
OWNER character
GENERALMANAGER character
HEADCOACH character
DLEAGUEAFFILIATION character

TeamHistory

col_name types description
TEAM_ID character Unique team identifier.
CITY character City.
NICKNAME character Team or athlete nickname.
YEARFOUNDED character
YEARACTIVETILL character

TeamSocialSites

col_name types description
ACCOUNTTYPE character
WEBSITE_LINK character

TeamAwardsChampionships

col_name types description
YEARAWARDED character
OPPOSITETEAM character

TeamAwardsConf

col_name types description
YEARAWARDED integer
OPPOSITETEAM integer

TeamAwardsDiv

col_name types description
YEARAWARDED integer
OPPOSITETEAM integer

TeamHof

col_name types description
PLAYERID character Playerid.
PLAYER character Player.
POSITION character Listed roster position (G, F, C, etc.).
JERSEY character Jersey number worn by the player.
SEASONSWITHTEAM character
YEAR character 4-digit year.

TeamRetired

col_name types description
PLAYERID character Playerid.
PLAYER character Player.
POSITION character Listed roster position (G, F, C, etc.).
JERSEY character Jersey number worn by the player.
SEASONSWITHTEAM character
YEAR character 4-digit year.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Estimated Metrics

Description

Get NBA Stats API Team Estimated Metrics

Get NBA Stats API Team Estimated Metrics

Usage

nba_teamestimatedmetrics(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
...

Additional arguments passed to an underlying function like httr.

Details

Team Estimated Metrics 

 nba_teamestimatedmetrics()

Value

Return a named list of data frames: TeamEstimatedMetrics

TeamEstimatedMetrics

col_name types description
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ID character Unique team identifier.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
E_OFF_RATING character
E_DEF_RATING character
E_NET_RATING character
E_PACE character
E_AST_RATIO character
E_OREB_PCT character
E_DREB_PCT character
E_REB_PCT character
E_TM_TOV_PCT character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
E_OFF_RATING_RANK character
E_DEF_RATING_RANK character
E_NET_RATING_RANK character
E_AST_RATIO_RANK character
E_OREB_PCT_RANK character
E_DREB_PCT_RANK character
E_REB_PCT_RANK character
E_TM_TOV_PCT_RANK character
E_PACE_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Game Log

Description

Get NBA Stats API Team Game Log

Get NBA Stats API Team Game Log

Usage

nba_teamgamelog(
  date_from = "",
  date_to = "",
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "1610612749",
  ...
)

Arguments

date_from

date_from
date_to

date_to
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

Team ID
...

Additional arguments passed to an underlying function like httr.

Details

Teams Game Log 

 nba_teamgamelog(team_id = '1610612749')

Value

Return a named list of data frames: TeamGameLog

TeamGameLog

col_name types description
Team_ID character Unique team identifier.
Game_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
STL character Steals.
BLK character Blocks.
TOV character Turnovers.
PF character Personal fouls.
PTS character Points scored.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Game Logs

Description

Get NBA Stats API Team Game Logs

Get NBA Stats API Team Game Logs

Usage

nba_teamgamelogs(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  player_id = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
per_mode

per_mode
period

period
player_id

Player ID
season

Season - format 2020-21
season_segment

season_segment
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

Teams Game Log 

 nba_teamgamelogs(team_id = '1610612749')

Value

Return a named list of data frames: TeamGameLogs

TeamGameLogs

col_name types description
SEASON_YEAR character Season year string ('YYYY-YY' format).
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
MATCHUP character Matchup.
WL character Wl.
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Game Streak Finder

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_teamgamelogs() instead.

Usage

nba_teamgamestreakfinder(
  active_streaks_only = "",
  active_teams_only = "",
  btr_opp_ast = "",
  btr_opp_blk = "",
  btr_opp_dreb = "",
  btr_opp_fg3a = "",
  btr_opp_fg3m = "",
  btr_opp_fg3_pct = "",
  btr_opp_fga = "",
  btr_opp_fgm = "",
  btr_opp_fg_pct = "",
  btr_opp_fta = "",
  btr_opp_ftm = "",
  btr_opp_ft_pct = "",
  btr_opp_oreb = "",
  btr_opp_pf = "",
  btr_opp_pts = "",
  btr_opp_pts2nd_chance = "",
  btr_opp_pts_fb = "",
  btr_opp_pts_off_tov = "",
  btr_opp_pts_paint = "",
  btr_opp_reb = "",
  btr_opp_stl = "",
  btr_opp_tov = "",
  conference = "",
  date_from = "",
  date_to = "",
  division = "",
  et_ast = "",
  et_blk = "",
  et_dd = "",
  et_dreb = "",
  et_fg3a = "",
  et_fg3m = "",
  et_fg3_pct = "",
  et_fga = "",
  et_fgm = "",
  et_fg_pct = "",
  et_fta = "",
  et_ftm = "",
  et_ft_pct = "",
  et_minutes = "",
  eq_opp_pts2nd_chance = "",
  eq_opp_pts_fb = "",
  eq_opp_pts_off_tov = "",
  eq_opp_pts_paint = "",
  et_oreb = "",
  et_pf = "",
  et_pts = "",
  eq_pts2nd_chance = "",
  eq_pts_fb = "",
  eq_pts_off_tov = "",
  eq_pts_paint = "",
  et_reb = "",
  et_stl = "",
  et_td = "",
  et_tov = "",
  game_id = "",
  gt_ast = "",
  gt_blk = "",
  gt_dd = "",
  gt_dreb = "",
  gt_fg3a = "",
  gt_fg3m = "",
  gt_fg3_pct = "",
  gt_fga = "",
  gt_fgm = "",
  gt_fg_pct = "",
  gt_fta = "",
  gt_ftm = "",
  gt_ft_pct = "",
  gt_minutes = "",
  gt_opp_ast = "",
  gt_opp_blk = "",
  gt_opp_dreb = "",
  gt_opp_fg3a = "",
  gt_opp_fg3m = "",
  gt_opp_fg3_pct = "",
  gt_opp_fga = "",
  gt_opp_fgm = "",
  gt_opp_fg_pct = "",
  gt_opp_fta = "",
  gt_opp_ftm = "",
  gt_opp_ft_pct = "",
  gt_opp_oreb = "",
  gt_opp_pf = "",
  gt_opp_pts = "",
  gt_opp_pts2nd_chance = "",
  gt_opp_pts_fb = "",
  gt_opp_pts_off_tov = "",
  gt_opp_pts_paint = "",
  gt_opp_reb = "",
  gt_opp_stl = "",
  gt_opp_tov = "",
  gt_oreb = "",
  gt_pf = "",
  gt_pts = "",
  gt_pts2nd_chance = "",
  gt_pts_fb = "",
  gt_pts_off_tov = "",
  gt_pts_paint = "",
  gt_reb = "",
  gt_stl = "",
  gt_td = "",
  gt_tov = "",
  lstreak = "",
  league_id = "00",
  location = "",
  lt_ast = "",
  lt_blk = "",
  lt_dd = "",
  lt_dreb = "",
  lt_fg3a = "",
  lt_fg3m = "",
  lt_fg3_pct = "",
  lt_fga = "",
  lt_fgm = "",
  lt_fg_pct = "",
  lt_fta = "",
  lt_ftm = "",
  lt_ft_pct = "",
  lt_minutes = "",
  lt_opp_ast = "",
  lt_opp_blk = "",
  lt_opp_dreb = "",
  lt_opp_fg3a = "",
  lt_opp_fg3m = "",
  lt_opp_fg3_pct = "",
  lt_opp_fga = "",
  lt_opp_fgm = "",
  lt_opp_fg_pct = "",
  lt_opp_fta = "",
  lt_opp_ftm = "",
  lt_opp_ft_pct = "",
  lt_opp_oreb = "",
  lt_opp_pf = "",
  lt_opp_pts = "",
  lt_opp_pts2nd_chance = "",
  lt_opp_pts_fb = "",
  lt_opp_pts_off_tov = "",
  lt_opp_pts_paint = "",
  lt_opp_reb = "",
  lt_opp_stl = "",
  lt_opp_tov = "",
  lt_oreb = "",
  lt_pf = "",
  lt_pts = "",
  lt_pts2nd_chance = "",
  lt_pts_fb = "",
  lt_pts_off_tov = "",
  lt_pts_paint = "",
  lt_reb = "",
  lt_stl = "",
  lt_td = "",
  lt_tov = "",
  min_games = "",
  outcome = "",
  po_round = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  team_id = "",
  vs_conference = "",
  vs_division = "",
  vs_team_id = "",
  wstreak = "",
  wrs_opp_ast = "",
  wrs_opp_blk = "",
  wrs_opp_dreb = "",
  wrs_opp_fg3a = "",
  wrs_opp_fg3m = "",
  wrs_opp_fg3_pct = "",
  wrs_opp_fga = "",
  wrs_opp_fgm = "",
  wrs_opp_fg_pct = "",
  wrs_opp_fta = "",
  wrs_opp_ftm = "",
  wrs_opp_ft_pct = "",
  wrs_opp_oreb = "",
  wrs_opp_pf = "",
  wrs_opp_pts = "",
  wrs_opp_pts2nd_chance = "",
  wrs_opp_pts_fb = "",
  wrs_opp_pts_off_tov = "",
  wrs_opp_pts_paint = "",
  wrs_opp_reb = "",
  wrs_opp_stl = "",
  wrs_opp_tov = "",
  ...
)

Arguments

active_streaks_only

active_streaks_only
active_teams_only

active_teams_only
btr_opp_ast

btr_opp_ast
btr_opp_blk

btr_opp_blk
btr_opp_dreb

btr_opp_dreb
btr_opp_fg3a

btr_opp_fg3a
btr_opp_fg3m

btr_opp_fg3m
btr_opp_fg3_pct

btr_opp_fg3_pct
btr_opp_fga

btr_opp_fga
btr_opp_fgm

btr_opp_fgm
btr_opp_fg_pct

btr_opp_fg_pct
btr_opp_fta

btr_opp_fta
btr_opp_ftm

btr_opp_ftm
btr_opp_ft_pct

btr_opp_ft_pct
btr_opp_oreb

btr_opp_oreb
btr_opp_pf

btr_opp_pf
btr_opp_pts

btr_opp_pts
btr_opp_pts2nd_chance

btr_opp_pts2nd_chance
btr_opp_pts_fb

btr_opp_pts_fb
btr_opp_pts_off_tov

btr_opp_pts_off_tov
btr_opp_pts_paint

btr_opp_pts_paint
btr_opp_reb

btr_opp_reb
btr_opp_stl

btr_opp_stl
btr_opp_tov

btr_opp_tov
conference

conference
date_from

date_from
date_to

date_to
division

division
et_ast

et_ast
et_blk

et_blk
et_dd

et_dd
et_dreb

et_dreb
et_fg3a

et_fg3a
et_fg3m

et_fg3m
et_fg3_pct

et_fg3_pct
et_fga

et_fga
et_fgm

et_fgm
et_fg_pct

et_fg_pct
et_fta

et_fta
et_ftm

et_ftm
et_ft_pct

et_ft_pct
et_minutes

et_minutes
eq_opp_pts2nd_chance

eq_opp_pts2nd_chance
eq_opp_pts_fb

eq_opp_pts_fb
eq_opp_pts_off_tov

eq_opp_pts_off_tov
eq_opp_pts_paint

eq_opp_pts_paint
et_oreb

et_oreb
et_pf

et_pf
et_pts

et_pts
eq_pts2nd_chance

eq_pts2nd_chance
eq_pts_fb

eq_pts_fb
eq_pts_off_tov

eq_pts_off_tov
eq_pts_paint

eq_pts_paint
et_reb

et_reb
et_stl

et_stl
et_td

et_td
et_tov

et_tov
game_id

game_id
gt_ast

gt_ast
gt_blk

gt_blk
gt_dd

gt_dd
gt_dreb

gt_dreb
gt_fg3a

gt_fg3a
gt_fg3m

gt_fg3m
gt_fg3_pct

gt_fg3_pct
gt_fga

gt_fga
gt_fgm

gt_fgm
gt_fg_pct

gt_fg_pct
gt_fta

gt_fta
gt_ftm

gt_ftm
gt_ft_pct

gt_ft_pct
gt_minutes

gt_minutes
gt_opp_ast

gt_opp_ast
gt_opp_blk

gt_opp_blk
gt_opp_dreb

gt_opp_dreb
gt_opp_fg3a

gt_opp_fg3a
gt_opp_fg3m

gt_opp_fg3m
gt_opp_fg3_pct

gt_opp_fg3_pct
gt_opp_fga

gt_opp_fga
gt_opp_fgm

gt_opp_fgm
gt_opp_fg_pct

gt_opp_fg_pct
gt_opp_fta

gt_opp_fta
gt_opp_ftm

gt_opp_ftm
gt_opp_ft_pct

gt_opp_ft_pct
gt_opp_oreb

gt_opp_oreb
gt_opp_pf

gt_opp_pf
gt_opp_pts

gt_opp_pts
gt_opp_pts2nd_chance

gt_opp_pts2nd_chance
gt_opp_pts_fb

gt_opp_pts_fb
gt_opp_pts_off_tov

gt_opp_pts_off_tov
gt_opp_pts_paint

gt_opp_pts_paint
gt_opp_reb

gt_opp_reb
gt_opp_stl

gt_opp_stl
gt_opp_tov

gt_opp_tov
gt_oreb

gt_oreb
gt_pf

gt_pf
gt_pts

gt_pts
gt_pts2nd_chance

gt_pts2nd_chance
gt_pts_fb

gt_pts_fb
gt_pts_off_tov

gt_pts_off_tov
gt_pts_paint

gt_pts_paint
gt_reb

gt_reb
gt_stl

gt_stl
gt_td

gt_td
gt_tov

gt_tov
lstreak

lstreak
league_id

league_id
location

location
lt_ast

lt_ast
lt_blk

lt_blk
lt_dd

lt_dd
lt_dreb

lt_dreb
lt_fg3a

lt_fg3a
lt_fg3m

lt_fg3m
lt_fg3_pct

lt_fg3_pct
lt_fga

lt_fga
lt_fgm

lt_fgm
lt_fg_pct

lt_fg_pct
lt_fta

lt_fta
lt_ftm

lt_ftm
lt_ft_pct

lt_ft_pct
lt_minutes

lt_minutes
lt_opp_ast

lt_opp_ast
lt_opp_blk

lt_opp_blk
lt_opp_dreb

lt_opp_dreb
lt_opp_fg3a

lt_opp_fg3a
lt_opp_fg3m

lt_opp_fg3m
lt_opp_fg3_pct

lt_opp_fg3_pct
lt_opp_fga

lt_opp_fga
lt_opp_fgm

lt_opp_fgm
lt_opp_fg_pct

lt_opp_fg_pct
lt_opp_fta

lt_opp_fta
lt_opp_ftm

lt_opp_ftm
lt_opp_ft_pct

lt_opp_ft_pct
lt_opp_oreb

lt_opp_oreb
lt_opp_pf

lt_opp_pf
lt_opp_pts

lt_opp_pts
lt_opp_pts2nd_chance

lt_opp_pts2nd_chance
lt_opp_pts_fb

lt_opp_pts_fb
lt_opp_pts_off_tov

lt_opp_pts_off_tov
lt_opp_pts_paint

lt_opp_pts_paint
lt_opp_reb

lt_opp_reb
lt_opp_stl

lt_opp_stl
lt_opp_tov

lt_opp_tov
lt_oreb

lt_oreb
lt_pf

lt_pf
lt_pts

lt_pts
lt_pts2nd_chance

lt_pts2nd_chance
lt_pts_fb

lt_pts_fb
lt_pts_off_tov

lt_pts_off_tov
lt_pts_paint

lt_pts_paint
lt_reb

lt_reb
lt_stl

lt_stl
lt_td

lt_td
lt_tov

lt_tov
min_games

min_games
outcome

outcome
po_round

po_round
season

season
season_segment

season_segment
season_type

season_type
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_team_id

vs_team_id
wstreak

wstreak
wrs_opp_ast

wrs_opp_ast
wrs_opp_blk

wrs_opp_blk
wrs_opp_dreb

wrs_opp_dreb
wrs_opp_fg3a

wrs_opp_fg3a
wrs_opp_fg3m

wrs_opp_fg3m
wrs_opp_fg3_pct

wrs_opp_fg3_pct
wrs_opp_fga

wrs_opp_fga
wrs_opp_fgm

wrs_opp_fgm
wrs_opp_fg_pct

wrs_opp_fg_pct
wrs_opp_fta

wrs_opp_fta
wrs_opp_ftm

wrs_opp_ftm
wrs_opp_ft_pct

wrs_opp_ft_pct
wrs_opp_oreb

wrs_opp_oreb
wrs_opp_pf

wrs_opp_pf
wrs_opp_pts

wrs_opp_pts
wrs_opp_pts2nd_chance

wrs_opp_pts2nd_chance
wrs_opp_pts_fb

wrs_opp_pts_fb
wrs_opp_pts_off_tov

wrs_opp_pts_off_tov
wrs_opp_pts_paint

wrs_opp_pts_paint
wrs_opp_reb

wrs_opp_reb
wrs_opp_stl

wrs_opp_stl
wrs_opp_tov

wrs_opp_tov
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamgamestreakfinder()

Value

Return a named list of data frames: TeamGameStreakFinderParametersResults

TeamGameStreakFinderParametersResults

col_name types description
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ID character Unique team identifier.
GAMESTREAK character
STARTDATE character
ENDDATE character
ACTIVESTREAK character
NUMSEASONS character
LASTSEASON character
FIRSTSEASON character
ABBREVIATION character Short abbreviation.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Other NBA Game Finder Functions: nba_leaguegamefinder(), nba_playergamestreakfinder()

Get NBA Stats API Team Historical Leaders

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_franchiseleaders() instead.

Usage

nba_teamhistoricalleaders(
  league_id = "00",
  season_id = "22022",
  team_id = "1610612749",
  ...
)

Arguments

league_id

league_id
season_id

season_id
team_id

team_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamhistoricalleaders(team_id = '1610612749')

Value

Return a named list of data frames: CareerLeadersByTeam

CareerLeadersByTeam

col_name types description
TEAM_ID character Unique team identifier.
PTS character Points scored.
PTS_PERSON_ID character
PTS_PLAYER character
AST character Assists.
AST_PERSON_ID character
AST_PLAYER character
REB character Total rebounds.
REB_PERSON_ID character
REB_PLAYER character
BLK character Blocks.
BLK_PERSON_ID character
BLK_PLAYER character
STL character Steals.
STL_PERSON_ID character
STL_PLAYER character
SEASON_YEAR character Season year string ('YYYY-YY' format).

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Common Info

Description

Get NBA Stats API Team Common Info

Get NBA Stats API Team Common Info

Usage

nba_teaminfocommon(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "1610612749",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
season

Season - format 2020-21
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

Team ID
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teaminfocommon(team_id = '1610612749')

Value

Return a named list of data frames: AvailableSeasons, TeamInfoCommon, TeamSeasonRanks

TeamInfoCommon

col_name types description
TEAM_ID character Unique team identifier.
SEASON_YEAR character Season year string ('YYYY-YY' format).
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_CONFERENCE character
TEAM_DIVISION character
TEAM_CODE character
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
W character Wins.
L character Losses.
PCT character Pct.
CONF_RANK character
DIV_RANK character
MIN_YEAR character
MAX_YEAR character

TeamSeasonRanks

col_name types description
LEAGUE_ID character League identifier ('10' = WNBA).
SEASON_ID character Unique season identifier.
TEAM_ID character Unique team identifier.
PTS_RANK character
PTS_PG character
REB_RANK character
REB_PG character
AST_RANK character
AST_PG character
OPP_PTS_RANK character
OPP_PTS_PG character

AvailableSeasons

col_name types description
SEASON_ID character Unique season identifier.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Player Dashboard

Description

Get NBA Stats API Team Player Dashboard

Get NBA Stats API Team Player Dashboard

Usage

nba_teamplayerdashboard(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
po_round

po_round
per_mode

per_mode
period

period
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamplayerdashboard(team_id = '1610612749')

Value

Return a named list of data frames: PlayersSeasonTotals, TeamOverall

TeamOverall

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GROUP_VALUE character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PlayersSeasonTotals

col_name types description
GROUP_SET character
PLAYER_ID character Unique player identifier.
PLAYER_NAME character Player name.
NICKNAME character Team or athlete nickname.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Player On/Off Details

Description

Get NBA Stats API Team Player On/Off Details

Get NBA Stats API Team Player On/Off Details

Usage

nba_teamplayeronoffdetails(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
po_round

po_round
per_mode

per_mode
period

period
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamplayeronoffdetails(team_id = '1610612749')

Value

Return a named list of data frames: OverallTeamPlayerOnOffDetails, PlayersOffCourtTeamPlayerOnOffDetails, PlayersOnCourtTeamPlayerOnOffDetails

OverallTeamPlayerOnOffDetails

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PlayersOnCourtTeamPlayerOnOffDetails

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PlayersOffCourtTeamPlayerOnOffDetails

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team Player On/Off Summary

Description

Get NBA Stats API Team Player On/Off Summary

Get NBA Stats API Team Player On/Off Summary

Usage

nba_teamplayeronoffsummary(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  pace_adjust = "N",
  plus_minus = "N",
  po_round = "",
  per_mode = "Totals",
  period = 0,
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
pace_adjust

pace_adjust
plus_minus

plus_minus
po_round

po_round
per_mode

per_mode
period

period
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamplayeronoffsummary(team_id = '1610612749')

Value

Return a named list of data frames: OverallTeamPlayerOnOffSummary, PlayersOffCourtTeamPlayerOnOffSummary, PlayersOnCourtTeamPlayerOnOffSummary

OverallTeamPlayerOnOffSummary

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

PlayersOnCourtTeamPlayerOnOffSummary

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
MIN character Minutes played.
PLUS_MINUS character Plus/minus point differential while on court.
OFF_RATING character Offensive rating (points produced per 100 possessions).
DEF_RATING character Defensive rating (points allowed per 100 possessions).
NET_RATING character Net rating (off rating - def rating).

PlayersOffCourtTeamPlayerOnOffSummary

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
MIN character Minutes played.
PLUS_MINUS character Plus/minus point differential while on court.
OFF_RATING character Offensive rating (points produced per 100 possessions).
DEF_RATING character Defensive rating (points allowed per 100 possessions).
NET_RATING character Net rating (off rating - def rating).

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teams(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Teams

Description

Get NBA Stats API Teams

Get NBA Stats API Teams

Usage

nba_teams(...)

Arguments

...

Additional arguments passed to an underlying function like httr.

Details

 nba_teams()

Value

Return a data frame with the following columns:

col_name types description
league_id character League identifier ('10' = WNBA).
season_id character Unique season identifier.
team_id character Unique team identifier.
team_city character Team city or region (e.g. 'Las Vegas').
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_slug character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
conference character Conference.
division character Team division.
team_abbreviation character Short team abbreviation (e.g. 'LAS').
team_name_full character Team name full.
season character Season identifier (4-digit year or 'YYYY-YY' string).
espn_team_id integer Unique identifier for espn team.
abbreviation character Short abbreviation.
display_name character Display name.
mascot character Team mascot.
nickname character Team or athlete nickname.
team character Team-side label or team identifier.
color character Primary color (hex without leading '#').
alternate_color character Alternate color (hex without leading '#').
logo character Team or league logo URL.
logo_dark character Logo dark.
logos_href_3 character Logos href 3.
logos_href_4 character Logos href 4.
nba_logo_svg character Nba logo svg.

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teamvsplayer(), nba_teamyearbyyearstats()

Get NBA Stats API Team vs Player

Description

Get NBA Stats API Team vs Player

Get NBA Stats API Team vs Player

Usage

nba_teamvsplayer(
  date_from = "",
  date_to = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  measure_type = "Base",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  po_round = "",
  pace_adjust = "N",
  per_mode = "Totals",
  period = 0,
  player_id = "",
  plus_minus = "N",
  rank = "N",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  shot_clock_range = "",
  team_id = "1610612749",
  vs_conference = "",
  vs_division = "",
  vs_player_id = "2544",
  ...
)

Arguments

date_from

date_from
date_to

date_to
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
measure_type

measure_type
month

month
opponent_team_id

opponent_team_id
outcome

outcome
po_round

po_round
pace_adjust

pace_adjust
per_mode

per_mode
period

period
player_id

Player ID
plus_minus

plus_minus
rank

rank
season

season
season_segment

season_segment
season_type

season_type
shot_clock_range

shot_clock_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
vs_player_id

vs_player_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_teamvsplayer(team_id = '1610612749', vs_player_id = '2544')

Value

Return a named list of data frames: OnOffCourt, Overall, ShotAreaOffCourt, ShotAreaOnCourt, ShotAreaOverall, ShotDistanceOffCourt, ShotDistanceOnCourt, ShotDistanceOverall, vsPlayerOverall

Overall

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

vsPlayerOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
PLAYER_ID character Unique player identifier.
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
NBA_FANTASY_PTS character
DD2 character
TD3 character
WNBA_FANTASY_PTS character
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character
NBA_FANTASY_PTS_RANK character
DD2_RANK character
TD3_RANK character
WNBA_FANTASY_PTS_RANK character

OnOffCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GP character Games played.
W character Wins.
L character Losses.
W_PCT character
MIN character Minutes played.
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
TOV character Turnovers.
STL character Steals.
BLK character Blocks.
BLKA character
PF character Personal fouls.
PFD character
PTS character Points scored.
PLUS_MINUS character Plus/minus point differential while on court.
GP_RANK character
W_RANK character
L_RANK character
W_PCT_RANK character
MIN_RANK character
FGM_RANK character
FGA_RANK character
FG_PCT_RANK character
FG3M_RANK character
FG3A_RANK character
FG3_PCT_RANK character
FTM_RANK character
FTA_RANK character
FT_PCT_RANK character
OREB_RANK character
DREB_RANK character
REB_RANK character
AST_RANK character
TOV_RANK character
STL_RANK character
BLK_RANK character
BLKA_RANK character
PF_RANK character
PFD_RANK character
PTS_RANK character
PLUS_MINUS_RANK character

ShotDistanceOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOnCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotDistanceOffCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOverall

col_name types description
GROUP_SET character
GROUP_VALUE character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOnCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

ShotAreaOffCourt

col_name types description
GROUP_SET character
TEAM_ID character Unique team identifier.
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
VS_PLAYER_ID character
VS_PLAYER_NAME character
COURT_STATUS character
GROUP_VALUE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamyearbyyearstats()

Get NBA Stats API Team Year by Year Stats

Description

Get NBA Stats API Team Year by Year Stats

Get NBA Stats API Team Year by Year Stats

Usage

nba_teamyearbyyearstats(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612749",
  ...
)

Arguments

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League
per_mode

Per Mode
season_type

Season Type - Regular Season, Playoffs, All-Star
team_id

Team ID
...

Additional arguments passed to an underlying function like httr.

Details

Team Year by Year Stats 

 nba_teamyearbyyearstats(team_id = '1610612749')

Value

Return a named list of data frames: TeamStats

TeamStats

col_name types description
TEAM_ID character Unique team identifier.
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
YEAR character 4-digit year.
GP character Games played.
WINS character Total wins.
LOSSES character Total losses.
WIN_PCT character
CONF_RANK character
DIV_RANK character
PO_WINS character
PO_LOSSES character
CONF_COUNT character
DIV_COUNT character
NBA_FINALS_APPEARANCE character
FGM character Field goals made.
FGA character Field goal attempts.
FG_PCT character Field goal percentage (0-1).
FG3M character Three-point field goals made.
FG3A character Three-point field goal attempts.
FG3_PCT character Three-point field goal percentage (0-1).
FTM character Free throws made.
FTA character Free throw attempts.
FT_PCT character Free throw percentage (0-1).
OREB character Offensive rebounds.
DREB character Defensive rebounds.
REB character Total rebounds.
AST character Assists.
PF character Personal fouls.
STL character Steals.
TOV character Turnovers.
BLK character Blocks.
PTS character Points scored.
PTS_RANK character

Author(s)

Saiem Gilani

See Also

Other NBA Team Functions: nba_leaguedashteamstats(), nba_teamandplayersvsplayers(), nba_teamdashboardbyclutch(), nba_teamdashlineups(), nba_teamdashptpass(), nba_teamdashptreb(), nba_teamdashptshots(), nba_teamdetails(), nba_teamestimatedmetrics(), nba_teamgamelog(), nba_teamgamelogs(), nba_teamgamestreakfinder(), nba_teamhistoricalleaders(), nba_teaminfocommon(), nba_teamplayerdashboard(), nba_teamplayeronoffdetails(), nba_teamplayeronoffsummary(), nba_teams(), nba_teamvsplayer()

Get NBA Stats API Today's Scoreboard

Description

Get NBA Stats API Today's Scoreboard

Get NBA Stats API Today's Scoreboard

Usage

nba_todays_scoreboard(...)

Arguments

...

Additional arguments passed to an underlying function like httr.

Details

 nba_todays_scoreboard()

Value

Return a data frame with the following columns:

col_name types description
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_et character Game et.
regulation_periods integer Regulation periods.
if_necessary logical If necessary.
series_game_number character Series game number.
series_text character Series text.
series_conference character Series conference.
po_round_desc character Po round desc.
game_subtype character Game subtype.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_wins integer Home team's wins.
home_losses integer Home team's losses.
home_score integer Home team score at the time of the play.
home_seed logical Home team's seed.
home_in_bonus character Home team's in bonus.
home_timeouts_remaining integer Home team's timeouts remaining.
home_periods list Home team's periods.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_wins integer Away team's wins.
away_losses integer Away team's losses.
away_score integer Away team score at the time of the play.
away_seed logical Away team's seed.
away_in_bonus character Away team's in bonus.
away_timeouts_remaining integer Away team's timeouts remaining.
away_periods list Away team's periods.
home_leaders_person_id integer Unique identifier for home leaders person.
home_leaders_name character Home leaders name.
home_leaders_jersey_num character Home team's leaders jersey num.
home_leaders_position character Home team's leaders position.
home_leaders_team_tricode character Home team's leaders team tricode.
home_leaders_player_slug character Home team's leaders player slug.
home_leaders_points integer Home team's leaders points.
home_leaders_rebounds integer Home team's leaders rebounds.
home_leaders_assists integer Home team's leaders assists.
away_leaders_person_id integer Unique identifier for away leaders person.
away_leaders_name character Away leaders name.
away_leaders_jersey_num character Away team's leaders jersey num.
away_leaders_position character Away team's leaders position.
away_leaders_team_tricode character Away team's leaders team tricode.
away_leaders_player_slug character Away team's leaders player slug.
away_leaders_points integer Away team's leaders points.
away_leaders_rebounds integer Away team's leaders rebounds.
away_leaders_assists integer Away team's leaders assists.
pb_odds_team logical Pb odds team.
pb_odds_odds numeric Pb odds odds.
pb_odds_suspended integer Pb odds suspended.

Author(s)

Saiem Gilani

See Also

Other NBA Schedule Functions: nba_schedule(), nba_scheduleleaguev2int(), nba_scoreboard(), nba_scoreboardv2(), nba_scoreboardv3()

Other NBA Live Functions: nba_live_boxscore(), nba_live_pbp()

Get NBA Stats API Video Details

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_videodetailsasset() instead.

Usage

nba_videodetails(
  ahead_behind = "",
  clutch_time = "",
  context_filter = "",
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  end_period = "",
  end_range = "",
  game_id = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  period = 0,
  player_id = "2544",
  point_diff = "",
  position = "",
  range_type = "",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  start_period = "",
  start_range = "",
  team_id = "1610612747",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

ahead_behind

ahead_behind
clutch_time

clutch_time
context_filter

context_filter
context_measure

context_measure
date_from

date_from
date_to

date_to
end_period

end_period
end_range

end_range
game_id

game_id
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
period

period
player_id

player_id
point_diff

point_diff
position

position
range_type

range_type
rookie_year

rookie_year
season

season
season_segment

season_segment
season_type

season_type
start_period

start_period
start_range

start_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_videodetails(player_id = '2544', team_id = '1610612747')

Value

Return a list of tibbles: videoUrls, playlist

videoUrls

col_name types description
uuid character Uuid.
dur logical Dur.
stt logical Stt.
stp logical Stp.
sth logical Sth.
stw logical Stw.
mtt logical Mtt.
mtp logical Mtp.
mth logical Mth.
mtw logical Mtw.
ltt logical Ltt.
ltp logical Ltp.
lth logical Lth.
ltw logical Ltw.

playlist

col_name types description
gi character Gi.
ei integer Ei.
y integer Y.
m character M.
d character D.
gc character Gc.
p integer P.
dsc character Dsc.
ha character Ha.
va character Va.
hpb integer Hpb.
hpa integer Hpa.
vpb integer Vpb.
vpa integer Vpa.
pta integer Pta.

Author(s)

Saiem Gilani

See Also

Other NBA Video Functions: nba_videodetailsasset(), nba_videoevents(), nba_videoeventsasset(), nba_videostatus()

Get NBA Stats API Video Details

Description

Get NBA Stats API Video Details

Get NBA Stats API Video Details

Usage

nba_videodetailsasset(
  ahead_behind = "",
  clutch_time = "",
  context_filter = "",
  context_measure = "FGA",
  date_from = "",
  date_to = "",
  end_period = "",
  end_range = "",
  game_id = "",
  game_segment = "",
  last_n_games = 0,
  league_id = "00",
  location = "",
  month = 0,
  opponent_team_id = 0,
  outcome = "",
  period = 0,
  player_id = "2544",
  point_diff = "",
  position = "",
  range_type = "",
  rookie_year = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_segment = "",
  season_type = "Regular Season",
  start_period = "",
  start_range = "",
  team_id = "1610612747",
  vs_conference = "",
  vs_division = "",
  ...
)

Arguments

ahead_behind

ahead_behind
clutch_time

clutch_time
context_filter

context_filter
context_measure

context_measure
date_from

date_from
date_to

date_to
end_period

end_period
end_range

end_range
game_id

game_id
game_segment

game_segment
last_n_games

last_n_games
league_id

league_id
location

location
month

month
opponent_team_id

opponent_team_id
outcome

outcome
period

period
player_id

player_id
point_diff

point_diff
position

position
range_type

range_type
rookie_year

rookie_year
season

season
season_segment

season_segment
season_type

season_type
start_period

start_period
start_range

start_range
team_id

team_id
vs_conference

vs_conference
vs_division

vs_division
...

Additional arguments passed to an underlying function like httr.

Details

 nba_videodetailsasset(player_id = '2544', team_id = '1610612747')

Value

Return a list of tibbles: videoUrls, playlist

videoUrls

col_name types description
uuid character Uuid.
sdur integer Sdur.
surl character Surl.
sth character Sth.
mdur integer Mdur.
murl character Murl.
mth character Mth.
ldur integer Ldur.
lurl character Lurl.
lth character Lth.
vtt character Vtt.
scc character Scc.
srt character Srt.

playlist

col_name types description
gi character Gi.
ei integer Ei.
y integer Y.
m character M.
d character D.
gc character Gc.
p integer P.
dsc character Dsc.
ha character Ha.
hid integer Hid.
va character Va.
vid integer Vid.
hpb integer Hpb.
hpa integer Hpa.
vpb integer Vpb.
vpa integer Vpa.
pta integer Pta.

Author(s)

Saiem Gilani

See Also

Other NBA Video Functions: nba_videodetails(), nba_videoevents(), nba_videoeventsasset(), nba_videostatus()

Get NBA Stats API Video Events

Description

Get NBA Stats API Video Events

Get NBA Stats API Video Events

Usage

nba_videoevents(game_id = "0021700807", game_event_id = "10", ...)

Arguments

game_id

game_id
game_event_id

game_event_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_videoevents(game_id = '0021700807', game_event_id = '10')

Value

Return a list of tibbles: videoUrls, playlist

Author(s)

Saiem Gilani

See Also

Other NBA Video Functions: nba_videodetails(), nba_videodetailsasset(), nba_videoeventsasset(), nba_videostatus()

Get NBA Stats API Video Events Asset

Description

Get NBA Stats API Video Events Asset

Get NBA Stats API Video Events Asset

Usage

nba_videoeventsasset(game_id, game_event_id = 0, ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '0021700807')
game_event_id

Game Event ID - event number from play-by-play data
...

Additional arguments passed to an underlying function like httr.

Details

 nba_videoeventsasset(game_id = '0021700807', game_event_id = 10)

Value

Returns a named list containing video event asset data (structure varies by response)

Author(s)

Saiem Gilani

See Also

Other NBA Video Functions: nba_videodetails(), nba_videodetailsasset(), nba_videoevents(), nba_videostatus()

Get NBA Stats API Video Status

Description

Get NBA Stats API Video Status

Get NBA Stats API Video Status

Usage

nba_videostatus(game_date = "2023-03-10", league_id = "00", ...)

Arguments

game_date

game_date
league_id

league_id
...

Additional arguments passed to an underlying function like httr.

Details

 nba_videostatus(game_date = '2023-03-10', league_id = '00')

Value

Return a list of tibbles: VideoStatus

VideoStatus

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
VISITOR_TEAM_ID character
VISITOR_TEAM_CITY character
VISITOR_TEAM_NAME character
VISITOR_TEAM_ABBREVIATION character
HOME_TEAM_ID character Unique identifier for the home team.
HOME_TEAM_CITY character Home team city / location.
HOME_TEAM_NAME character Home team name.
HOME_TEAM_ABBREVIATION character
GAME_STATUS character Game status label.
GAME_STATUS_TEXT character Game status display text (e.g. 'Final', '4:32 - 4th').
IS_AVAILABLE character
PT_XYZ_AVAILABLE character Pt xyz available.

Author(s)

Saiem Gilani

See Also

Other NBA Video Functions: nba_videodetails(), nba_videodetailsasset(), nba_videoevents(), nba_videoeventsasset()

Get NBA Stats API Win Probability PBP

Description

[Deprecated]

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_playbyplayv3() instead.

Usage

nba_winprobabilitypbp(game_id = "0021700807", run_type = "each second", ...)

Arguments

game_id

Game ID
run_type

Run Type
...

Additional arguments passed to an underlying function like httr.

Details

 nba_winprobabilitypbp(game_id = '0021700807', run_type = 'each second')

Value

Return a named list of data frames: WinProbPBP, GameInfo

WinProbPBP

col_name types description
GAME_ID character Unique game identifier.
EVENT_NUM character Sequential event number within the game (V2 PBP).
HOME_PCT character
VISITOR_PCT character
HOME_PTS character
VISITOR_PTS character
HOME_SCORE_MARGIN character
PERIOD character Period of the game (1-4 quarters; 5+ for OT).
SECONDS_REMAINING character Seconds remaining in the period.
HOME_POSS_IND character
HOME_G character
DESCRIPTION character Long-form description text.
LOCATION character Location.
PCTIMESTRING character
ISVISIBLE character

GameInfo

col_name types description
GAME_ID character Unique game identifier.
GAME_DATE character Game date (YYYY-MM-DD).
HOME_TEAM_ID character Unique identifier for the home team.
HOME_TEAM_ABR character
HOME_TEAM_PTS character
VISITOR_TEAM_ID character
VISITOR_TEAM_ABR character
VISITOR_TEAM_PTS character

Author(s)

Saiem Gilani

See Also

Other NBA PBP Functions: nba_data_pbp(), nba_live_pbp(), nba_pbp(), nba_pbps(), nba_playbyplayv3()

Get NBA G-League Stats API Live Boxscore

Description

Get NBA G-League Stats API Live Boxscore

Get NBA G-League Stats API Live Boxscore

Usage

nbagl_live_boxscore(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_live_boxscore(game_id = "2052500034")

Value

Returns a named list of data frames: game_details, arena, officials, home_team_boxscore, away_team_boxscore, home_team_player_boxscore, away_team_player_boxscore, home_team_linescores, away_team_linescores

game_details

col_name types description
game_id character Unique game identifier.
game_time_local character Game time local.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
game_time_home character Game time home.
game_time_away character Game time away.
game_et character Game et.
duration integer Duration.
game_code character ESPN game code (numeric identifier).
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_status integer Game status label.
regulation_periods integer Regulation periods.
period integer Period of the game (1-4 quarters; 5+ for OT).
game_clock character Game clock.
attendance integer Reported attendance.
sellout character Sellout.
home_team_id integer Unique identifier for the home team.
home_team_name character Home team name.
home_team_city character Home team city / location.
home_team_tricode character Home team three-letter code.
home_team_score integer Home team's score.
home_team_in_bonus character Home team's team in bonus.
home_team_timeouts_remaining integer Home team's team timeouts remaining.
away_team_id integer Unique identifier for the away team.
away_team_name character Away team name.
away_team_city character Away team city / location.
away_team_tricode character Away team three-letter code.
away_team_score integer Away team's score.
away_team_in_bonus character Away team's team in bonus.
away_team_timeouts_remaining integer Away team's team timeouts remaining.

arena

col_name types description
arena_id integer Unique identifier for arena.
arena_name character Arena name.
arena_city character Arena city.
arena_state character Arena state.
arena_country character Arena country.
arena_timezone character Arena timezone.

officials

col_name types description
person_id integer Unique player identifier (V3 endpoints).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
jersey_num character Jersey number worn by the player.
assignment character Assignment.

home_team_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
assists integer Total assists.
assists_turnover_ratio numeric Assists turnover ratio.
bench_points integer Points scored by the bench.
biggest_lead integer Biggest lead.
biggest_lead_score character Biggest lead score.
biggest_scoring_run integer Biggest scoring run.
biggest_scoring_run_score character Biggest scoring run score.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
fast_break_points_attempted integer Number of fast break points attempted.
fast_break_points_made integer Number of fast break points made.
fast_break_points_percentage numeric Fast break points percentage (0-1 decimal).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_effective_adjusted numeric Field goals effective adjusted.
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_team integer Fouls team.
fouls_technical integer Technical fouls.
fouls_team_technical integer Fouls team technical.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
lead_changes integer Lead changes.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
points integer Points scored.
points_against integer Points allowed.
points_fast_break integer Fast-break points scored.
points_from_turnovers integer Points from turnovers.
points_in_the_paint integer Points in the paint.
points_in_the_paint_attempted integer Number of points in the paint attempted.
points_in_the_paint_made integer Number of points in the paint made.
points_in_the_paint_percentage numeric Points in the paint percentage (0-1 decimal).
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_personal integer Rebounds personal.
rebounds_team integer Rebounds team.
rebounds_team_defensive integer Rebounds team defensive.
rebounds_team_offensive integer Rebounds team offensive.
rebounds_total integer Total rebounds.
second_chance_points_attempted integer Number of second chance points attempted.
second_chance_points_made integer Number of second chance points made.
second_chance_points_percentage numeric Second chance points percentage (0-1 decimal).
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
time_leading character Time leading.
times_tied integer Times tied.
true_shooting_attempts numeric Number of true shooting attempted.
true_shooting_percentage numeric True shooting percentage (0-1).
turnovers integer Total turnovers.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).

away_team_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
assists integer Total assists.
assists_turnover_ratio numeric Assists turnover ratio.
bench_points integer Points scored by the bench.
biggest_lead integer Biggest lead.
biggest_lead_score character Biggest lead score.
biggest_scoring_run integer Biggest scoring run.
biggest_scoring_run_score character Biggest scoring run score.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
fast_break_points_attempted integer Number of fast break points attempted.
fast_break_points_made integer Number of fast break points made.
fast_break_points_percentage numeric Fast break points percentage (0-1 decimal).
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_effective_adjusted numeric Field goals effective adjusted.
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_team integer Fouls team.
fouls_technical integer Technical fouls.
fouls_team_technical integer Fouls team technical.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
lead_changes integer Lead changes.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
points integer Points scored.
points_against integer Points allowed.
points_fast_break integer Fast-break points scored.
points_from_turnovers integer Points from turnovers.
points_in_the_paint integer Points in the paint.
points_in_the_paint_attempted integer Number of points in the paint attempted.
points_in_the_paint_made integer Number of points in the paint made.
points_in_the_paint_percentage numeric Points in the paint percentage (0-1 decimal).
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_personal integer Rebounds personal.
rebounds_team integer Rebounds team.
rebounds_team_defensive integer Rebounds team defensive.
rebounds_team_offensive integer Rebounds team offensive.
rebounds_total integer Total rebounds.
second_chance_points_attempted integer Number of second chance points attempted.
second_chance_points_made integer Number of second chance points made.
second_chance_points_percentage numeric Second chance points percentage (0-1 decimal).
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
time_leading character Time leading.
times_tied integer Times tied.
true_shooting_attempts numeric Number of true shooting attempted.
true_shooting_percentage numeric True shooting percentage (0-1).
turnovers integer Total turnovers.
turnovers_team integer Turnovers team.
turnovers_total integer Turnovers total.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).

home_team_player_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
status character Status label.
order integer Display order within the result set.
person_id integer Unique player identifier (V3 endpoints).
jersey_num character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
starter character TRUE if the player was in the starting lineup; FALSE otherwise.
oncourt character Oncourt.
played character Played.
assists integer Total assists.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_technical integer Technical fouls.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
minus numeric Minus.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
plus numeric Plus.
plus_minus_points numeric Plus/minus point differential while on court.
points integer Points scored.
points_fast_break integer Fast-break points scored.
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_total integer Total rebounds.
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
turnovers integer Total turnovers.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
not_playing_reason character Not playing reason.
not_playing_description character Not playing description.

away_team_player_boxscore

col_name types description
team_id integer Unique team identifier.
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_city character Team city or region (e.g. 'Las Vegas').
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
team_score integer Team's score / final score.
team_in_bonus character Team in bonus.
team_timeouts_remaining integer Team timeouts remaining.
status character Status label.
order integer Display order within the result set.
person_id integer Unique player identifier (V3 endpoints).
jersey_num character Jersey number worn by the player.
position character Listed roster position (G, F, C, etc.).
starter character TRUE if the player was in the starting lineup; FALSE otherwise.
oncourt character Oncourt.
played character Played.
assists integer Total assists.
blocks integer Total blocks.
blocks_received integer Shots blocked by opponents while attempting.
field_goals_attempted integer Field goal attempts (2-pt + 3-pt).
field_goals_made integer Field goals made (2-pt + 3-pt).
field_goals_percentage numeric Field goal percentage (0-1 decimal).
fouls_offensive integer Offensive fouls.
fouls_drawn integer Personal fouls drawn (by opponent's actions).
fouls_personal integer Personal fouls.
fouls_technical integer Technical fouls.
free_throws_attempted integer Free throw attempts.
free_throws_made integer Free throws made.
free_throws_percentage numeric Free throw percentage (0-1 decimal).
minus numeric Minus.
minutes character Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
minutes_calculated character Minutes calculated from game-clock differences.
plus numeric Plus.
plus_minus_points numeric Plus/minus point differential while on court.
points integer Points scored.
points_fast_break integer Fast-break points scored.
points_in_the_paint integer Points in the paint.
points_second_chance integer Second-chance points scored.
rebounds_defensive integer Defensive rebounds.
rebounds_offensive integer Offensive rebounds.
rebounds_total integer Total rebounds.
steals integer Total steals.
three_pointers_attempted integer Three-point field goal attempts.
three_pointers_made integer Three-point field goals made.
three_pointers_percentage numeric Three-point field goal percentage (0-1 decimal).
turnovers integer Total turnovers.
two_pointers_attempted integer Number of two pointers attempted.
two_pointers_made integer Number of two pointers made.
two_pointers_percentage numeric Two pointers percentage (0-1 decimal).
name character Display name.
name_i character Initialed name (e.g. 'A. Wilson').
first_name character Player's first name.
family_name character Player's family / last name.
not_playing_reason character Not playing reason.
not_playing_description character Not playing description.

home_team_linescores

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
score integer Final score.

away_team_linescores

col_name types description
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
score integer Final score.

Author(s)

Saiem Gilani

See Also

Other NBA G-League Functions: nbagl_live_pbp(), nbagl_pbp(), nbagl_players(), nbagl_schedule(), nbagl_standings()

Get NBA G-League Stats API Live play-by-play

Description

Get NBA G-League Stats API Live play-by-play

Get NBA G-League Stats API Live play-by-play

Usage

nbagl_live_pbp(game_id, ...)

Arguments

game_id

Game ID
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_live_pbp(game_id = '2052500034')

Value

Returns a data frame: PlayByPlay

col_name types description
event_num integer Sequential event number within the game (V2 PBP).
clock character Game clock value.
time_actual character Time actual.
period integer Period of the game (1-4 quarters; 5+ for OT).
period_type character Period type.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
qualifiers list Qualifiers.
player1_id integer V2 PBP primary player ID (e.g. shooter / fouler).
x numeric X.
y numeric Y.
offense_team_id integer Unique identifier for offense team.
home_score character Home team score at the time of the play.
away_score character Away team score at the time of the play.
edited character Edited.
order integer Display order within the result set.
is_target_score_last_period logical Is target score last period.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
side character Side label (e.g. 'home', 'away', or 'overUnder').
description character Long-form description text.
person_ids_filter list Person ids filter.
team_id integer Unique team identifier.
team_tricode character Three-letter team code (e.g. 'LAS' / 'NYL').
descriptor character Descriptor.
jump_ball_recovered_name character Jump ball recovered name.
jump_ball_recoverd_person_id integer Unique identifier for jump ball recoverd person.
player_name character Player name.
player_name_i character Player name i.
jump_ball_won_player_name character Jump ball won player name.
jump_ball_won_person_id integer Unique identifier for jump ball won person.
jump_ball_lost_player_name character Jump ball lost player name.
jump_ball_lost_person_id integer Unique identifier for jump ball lost person.
area character Area.
area_detail character Area detail.
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
points_total integer Running total of points scored.
assist_player_name_initial character Assist player name initial.
assist_person_id integer Unique identifier for assist person.
assist_total integer Assist total.
shot_action_number integer Shot action number.
rebound_total integer Rebound total.
rebound_defensive_total integer Rebound defensive total.
rebound_offensive_total integer Rebound offensive total.
official_id integer Unique official / referee identifier.
foul_personal_total integer Foul personal total.
foul_technical_total integer Foul technical total.
foul_drawn_player_name character Foul drawn player name.
foul_drawn_person_id integer Unique identifier for foul drawn person.
block_player_name character Block player name.
block_person_id integer Unique identifier for block person.
turnover_total integer Turnover total.
steal_player_name character Steal player name.
steal_person_id integer Unique identifier for steal person.
player2_id integer V2 PBP secondary player ID (e.g. assister / fouled-by).
player3_id integer V2 PBP tertiary player ID (e.g. blocker).

Author(s)

Saiem Gilani

See Also

Other NBA G-League Functions: nbagl_live_boxscore(), nbagl_pbp(), nbagl_players(), nbagl_schedule(), nbagl_standings()

Get NBA Data API Play-by-Play for G-League Games

Description

Retrieves G-League play-by-play using the NBA Stats play-by-play pipeline.

Usage

nbagl_pbp(game_id, on_court = TRUE, ...)

Arguments

game_id

Game ID - 10 digits, i.e. 0021900001
on_court

If TRUE (default), on-court player IDs are added for each play event.
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_pbp(game_id = "2052500034")

Value

Returns a data frame of play-by-play with core columns: When on_court = TRUE, lineup columns are included and may be NA when lineup inference data is unavailable for a given game.

col_name types description
game_id character Unique game identifier.
action_number integer Sequential action number within a game (V3 PBP).
clock character Game clock value.
period integer Period of the game (1-4 quarters; 5+ for OT).
team_id integer Unique team identifier.
person_id integer Unique player identifier (V3 endpoints).
player_name character Player name.
x_legacy integer V2-format X coordinate (preserved for V3-to-V2 compatibility).
y_legacy integer V2-format Y coordinate (preserved for V3-to-V2 compatibility).
shot_distance numeric Shot distance from the basket, in feet.
shot_result character Shot result ('Made' / 'Missed').
is_field_goal integer 1 if the action was a field goal; 0 otherwise.
score_home character Score home.
score_away character Score away.
points_total integer Running total of points scored.
location character Location.
description character Long-form description text.
action_type character Action type label (e.g. 'Made Shot', 'Substitution').
sub_type character Action sub-type label.
video_available logical Video available.
shot_value integer Point value of the shot (2 or 3).
action_id integer Unique action identifier within a game (V3 PBP).
away_player1 numeric Away team's player1.
away_player2 numeric Away team's player2.
away_player3 numeric Away team's player3.
away_player4 numeric Away team's player4.
away_player5 numeric Away team's player5.
home_player1 numeric Home team's player1.
home_player2 numeric Home team's player2.
home_player3 numeric Home team's player3.
home_player4 numeric Home team's player4.
home_player5 numeric Home team's player5.

Author(s)

Billy Fryer

See Also

Other NBA G-League Functions: nbagl_live_boxscore(), nbagl_live_pbp(), nbagl_players(), nbagl_schedule(), nbagl_standings()

Get G League Player Data Base from NBA API

Description

Retrieves G-League player index data via the NBA Stats API player index endpoint.

Usage

nbagl_players(
  college = "",
  country = "",
  draft_pick = "",
  draft_round = "",
  draft_year = "",
  height = "",
  historical = 1,
  league_id = "20",
  player_position = "",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "0",
  weight = "",
  active = "",
  all_star = "",
  ...
)

Arguments

college

College filter.
country

Country filter.
draft_pick

Draft pick filter.
draft_round

Draft round filter.
draft_year

Draft year filter.
height

Height filter.
historical

Historical flag.
league_id

League - default: '20' (G-League).
player_position

Player position filter.
season

Season - format 2020-21.
season_type

Season Type - Regular Season, Playoffs, All-Star.
team_id

Team ID filter.
weight

Weight filter.
active

Active status filter.
all_star

All-Star filter.
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_players()

Value

Returns a named list of data frames: PlayerIndex

PlayerIndex

col_name types description
PERSON_ID character Unique player identifier (V3 endpoints).
PLAYER_LAST_NAME character
PLAYER_FIRST_NAME character
PLAYER_SLUG character URL-safe player identifier.
TEAM_ID character Unique team identifier.
TEAM_SLUG character URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
TEAM_CITY character Team city or region (e.g. 'Las Vegas').
TEAM_NAME character Full team display name (e.g. 'Las Vegas Aces').
TEAM_ABBREVIATION character Short team abbreviation (e.g. 'LAS').
JERSEY_NUMBER character
POSITION character Listed roster position (G, F, C, etc.).
HEIGHT character Player height (string e.g. '6-2' or inches).
WEIGHT character Player weight in pounds.
COLLEGE character College or school attended.
COUNTRY character Country (full name or code).
DRAFT_YEAR character Draft year (4-digit).
DRAFT_ROUND character Round of the draft selection.
DRAFT_NUMBER character
ROSTER_STATUS character

Author(s)

Billy Fryer

See Also

Other NBA G-League Functions: nbagl_live_boxscore(), nbagl_live_pbp(), nbagl_pbp(), nbagl_schedule(), nbagl_standings()

Get G League Schedule from NBA API

Description

Retrieves G-League schedule data via the NBA Stats API schedule endpoint.

Usage

nbagl_schedule(
  league_id = "20",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

Arguments

league_id

League - default: '20' (G-League).
season

Season - format 2020-21.
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_schedule(season = most_recent_nba_season() - 1)

Value

Returns a data frame of the G League Season Schedule

col_name types description
game_date date Game date (YYYY-MM-DD).
game_id character Unique game identifier.
game_code character ESPN game code (numeric identifier).
game_status integer Game status label.
game_status_text character Game status display text (e.g. 'Final', '4:32 - 4th').
game_sequence integer Game sequence.
game_date_est character Game date est.
game_time_est character Game time est.
game_date_utc character Game date utc.
game_time_utc character Game start time in UTC (ISO 8601 timestamp).
arena_name character Arena name.
arena_state character Arena state.
arena_city character Arena city.
home_team_id character Unique identifier for the home team.
home_team_name character Home team name.
home_team_tricode character Home team three-letter code.
home_team_score character Home team's score.
away_team_id character Unique identifier for the away team.
away_team_name character Away team name.
away_team_tricode character Away team three-letter code.
away_team_score character Away team's score.
season character Season identifier (4-digit year or 'YYYY-YY' string).
league_id character League identifier ('10' = WNBA).
season_type_id character Unique identifier for season type.
season_type_description character Season type description.

Author(s)

Billy Fryer

See Also

Other NBA G-League Functions: nbagl_live_boxscore(), nbagl_live_pbp(), nbagl_pbp(), nbagl_players(), nbagl_standings()

Get Current G League Standings from NBA API

Description

Retrieves G-League standings via the NBA Stats API standings endpoint.

Usage

nbagl_standings(
  league_id = "20",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  season_year = "",
  ...
)

Arguments

league_id

League - default: '20' (G-League).
season

Season - format 2020-21.
season_type

Season Type - Regular Season, Playoffs, All-Star.
season_year

Season year filter (optional).
...

Additional arguments passed to an underlying function like httr.

Details

 nbagl_standings(season = most_recent_nba_season() - 1)

Value

Returns a named list of data frames: Standings

Standings

col_name types description
LeagueID character
SeasonID character
TeamID character Teamid.
TeamCity character Teamcity.
TeamName character Teamname.
TeamSlug character
Conference character Conference.
ConferenceRecord character
PlayoffRank character
Division character Team division.
WINS character Total wins.
LOSSES character Total losses.
WinPCT character
LeagueRank character
Record character Record string (e.g. '12-4').
HOME character Home.
ROAD character Road.
CurrentStreak character
strCurrentStreak character
ConferenceGamesBack character
DivisionGamesBack character
LeagueGamesBack character
ClinchedPostSeason character
NEUTRAL character

Author(s)

Billy Fryer

See Also

Other NBA G-League Functions: nbagl_live_boxscore(), nbagl_live_pbp(), nbagl_pbp(), nbagl_players(), nbagl_schedule()

Get men's college basketball NET rankings for the current date from the NCAA website

Description

Get men's college basketball NET rankings for the current date from the NCAA website

Usage

ncaa_mbb_NET_rankings()

Value

Returns a tibble

Author(s)

Saiem Gilani

Examples

# Get current NCAA NET rankings

try(ncaa_mbb_NET_rankings())

Scrape NCAA Men's Baskebtall Teams (Division I, II, and III)

Description

This function allows the user to obtain NCAA teams by year and division

Usage

ncaa_mbb_teams(year = most_recent_mbb_season(), division = 1, ...)

Arguments

year

The season for which data should be returned, in the form of "YYYY". Years currently available: 2002 onward.
division

Division - 1, 2, 3
...

Additional arguments passed to an underlying function like httr.

Details

  ncaa_mbb_teams(year = 2023, division = 1)

Value

A data frame with the following variables

col_name types description
team_id character Franchise team id (legacy ⁠/team/{id}/...⁠ urls).
team_name character Full team display name (e.g. 'Las Vegas Aces').
team_url character URL for team.
conference_id character Conference identifier.
conference character Conference.
division numeric Team division.
year numeric 4-digit year.
season_id character Season id (legacy urls).
season_team_id character Season-team id (modern ⁠/teams/{id}⁠ urls).

Progressively

Description

This function helps add progress-reporting to any function - given function f() and progressor p(), it will return a new function that calls f() and then (on-exiting) will call p() after every iteration.

Usage

progressively(f, p = NULL)

Arguments

f

a function to add progressr functionality to.
p

a progressor function as created by progressr::progressor()

Details

This is inspired by purrr's safely, quietly, and possibly function decorators.

Value

a function that does the same as f but it calls p() after iteration.

Load .rds file from a remote connection

Description

Load .rds file from a remote connection

Usage

rds_from_url(url)

Arguments

url

a character url

Value

a dataframe as created by readRDS()

rejoin schedules (when used from league game finder)

Description

rejoin schedules (when used from league game finder)

Usage

rejoin_schedules(df)

Arguments

df

data frame pulled from nba_leaguegamefinder()

Men's College Basketball KenPom Teams Dictionary Team link KenPom reference lookup for the package

Description

Men's College Basketball KenPom Teams Dictionary Team link KenPom reference lookup for the package

Usage

teams_links

Format

A data frame with 357 rows and 6 variables:

col_name description
Team character.
Team.link character.
team.link.ref character.
Year double.
Conf character.
Conf.link character.
conf.link.ref character.

Update or create a hoopR MBB play-by-play database

Description

update_mbb_db() updates or creates a database with hoopR play by play data of all completed and available games since 2006.

Usage

update_mbb_db(
  dbdir = ".",
  dbname = "hoopR_db",
  tblname = "hoopR_mbb_pbp",
  force_rebuild = FALSE,
  db_connection = NULL
)

Arguments

dbdir

Directory in which the database is or shall be located
dbname

File name of an existing or desired SQLite database within dbdir
tblname

The name of the play by play data table within the database
force_rebuild

Hybrid parameter (logical or numeric) to rebuild parts of or the complete play by play data table within the database (please see details for further information)
db_connection

A DBIConnection object, as returned by DBI::dbConnect() (please see details for further information)

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2006 season and adds the most recent completed games as soon as they are available for hoopR.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole hoopR era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

  • force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

  • force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Returns a logical value (TRUE/FALSE)

See Also

Other hoopR Database Functions: update_nba_db()

Update or create a hoopR NBA play-by-play database

Description

update_nba_db() updates or creates a database with hoopR play by play data of all completed and available games since 2002.

Usage

update_nba_db(
  dbdir = ".",
  dbname = "hoopR_db",
  tblname = "hoopR_nba_pbp",
  force_rebuild = FALSE,
  db_connection = NULL
)

Arguments

dbdir

Directory in which the database is or shall be located
dbname

File name of an existing or desired SQLite database within dbdir
tblname

The name of the play by play data table within the database
force_rebuild

Hybrid parameter (logical or numeric) to rebuild parts of or the complete play by play data table within the database (please see details for further information)
db_connection

A DBIConnection object, as returned by DBI::dbConnect() (please see details for further information)

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2002 season and adds the most recent completed games as soon as they are available for hoopR.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole hoopR era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

  • force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

  • force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Returns a logical value (TRUE/FALSE)

See Also

Other hoopR Database Functions: update_mbb_db()

year to season (XXXX -> XXXX-YY)

Description

year to season (XXXX -> XXXX-YY)

Usage

year_to_season(year)

Arguments

year

Four digit year (XXXX)