Repository Mirror for your Cloud Server and Webhosting

Title:

Access Men's Basketball Play by Play Data

Version:

3.1.0

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 ESPNhttps://www.espn.com with shot locations when available. It is also a full NBA Stats APIhttps://www.nba.com/stats/ wrapper. It is also a scraping and aggregating interface for Ken Pomeroy's men's college basketball statistics websitehttps://kenpom.com. It provides users with an active subscription the capability to scrape the website tables and analyze the data for themselves.

License:

MIT + file LICENSE

URL:

https://github.com/sportsdataverse/hoopR, https://hoopR.sportsdataverse.org/

BugReports:

https://github.com/sportsdataverse/hoopR/issues

Depends:

R (≥ 4.1.0)

Imports:

cli (≥ 1.1.0), data.table (≥ 1.14.0), dplyr, glmnet, httr2 (≥ 1.0.0), janitor, jsonlite, lifecycle, lubridate, magrittr, Matrix, progressr (≥ 0.6.0), purrr (≥ 1.0.0), Rcpp (≥ 1.0.7), RcppParallel (≥ 5.1.4), rlang (≥ 0.4.0), rvest (≥ 1.0.0), stringdist (≥ 0.9.0), stringi (≥ 1.7.0), stringr (≥ 1.3.0), tidyr (≥ 1.0.0)

Suggests:

arrow (≥ 6.0.0), chromote, crayon (≥ 1.3.4), curl, DBI, furrr (≥ 0.3.0), future (≥ 1.24.0), ggplot2, ggrepel, glue, rmarkdown, RSQLite, stats, testthat, tibble (≥ 3.0), usethis (≥ 1.6.0), xml2 (≥ 1.3), yaml

Encoding:

UTF-8

LazyData:

true

SystemRequirements:

pandoc (>= 1.12.3), pandoc-citeproc

Config/roxygen2/version:

8.1.0

NeedsCompilation:

Packaged:

2026-08-25 04:47:41 UTC; saiem

Author:

Saiem Gilani

[aut, cre, cph], Jason Lee [ctb], Billy Fryer [ctb], Ross Drucker [ctb], Vladislav Shufinskiy [ctb]

Maintainer:

Saiem Gilani <saiem.gilani@gmail.com>

Repository:

CRAN

Date/Publication:

2026-08-25 08:00:02 UTC

hoopR: Access Men's Basketball Play by Play Data

Description

Details

stats.nba.com / stats.wnba.com blocking (#142): the NBA Stats API family (⁠nba_*⁠ wrappers targeting stats.nba.com) blocks requests from datacenter/cloud IP ranges outright – calls that work from a residential connection will fail (timeout, empty body, or an HTML error page instead of JSON) from CI runners, most VPS/cloud hosts, and many corporate networks. If you're hitting this from a blocked network, route requests through a proxy on a residential/unblocked IP via options(hoopR.proxy = "http://host:port") (or the http_proxy / https_proxy environment variables, or a per-call ⁠proxy = ⁠ argument where the wrapper threads ... through to the request layer).

Author(s)

Maintainer: Saiem Gilani saiem.gilani@gmail.com (ORCID) [copyright holder]

Authors:

Saiem Gilani saiem.gilani@gmail.com (ORCID) [copyright holder]

Other contributors:

Jason Lee Jason@aisportsfirm.com [contributor]
Billy Fryer billyfryer@att.net [contributor]
Ross Drucker ross.a.drucker@gmail.com [contributor]
Vladislav Shufinskiy hollywood.90210@mail.ru [contributor]

Deterministic blocked fuzzy matcher (greedy within block)

Description

Deterministic blocked fuzzy matcher (greedy within block)

Usage

.bb_fuzzy_match(left, right, min_confidence = 0.92)

Arguments

left, right

data.frames with columns .block, .id, .name_key (and optional .jersey, .dob).

min_confidence

Jaro-Winkler similarity floor for a fuzzy match.

Value

data.frame: .block, left_id, right_id, match_method (exact_name / fuzzy_jw / unmatched), match_confidence.

Normalize a college team name for cross-source matching (contracting form)

Description

Collapses "state"/"saint"/"st." to a single "st" token and "&" to "and" so that terse Torvik/KenPom names ("Missouri St.") and ESPN's spelled-out names ("Missouri State") resolve to the same key. The canonical form is lossy but CONSISTENT across sources, which is what matters for matching.

Usage

.bb_normalize_college_team(x)

Normalize a person name for cross-source matching

Description

Normalize a person name for cross-source matching

Usage

.bb_normalize_name(x)

Normalize a team name for cross-source matching

Description

Normalize a team name for cross-source matching

Usage

.bb_normalize_team(x)

Reduce a timestamp (UTC datetime, ISO string, or Date) to the local ET date

Description

Reduce a timestamp (UTC datetime, ISO string, or Date) to the local ET date

Usage

.bb_to_eastern(x)

Internal: parse a Basketball-Reference HTML table by id using data-stat keys

Description

Un-comments the page (so comment-hidden tables are reachable), selects the table (by id, or the first table when table_id is NULL), drops mid-table header-repeat rows, and builds a data.frame whose columns are the cells' data-stat attributes.

Usage

.bref_table(html, table_id = NULL)

Arguments

html

Raw page HTML (character).

table_id

Optional table id (e.g. "per_game_stats"); NULL = first table.

Value

A data.frame (character columns), or an empty data.frame if not found.

Internal: GET a Basketball-Reference page and return the response body text

Description

Internal: GET a Basketball-Reference page and return the response body text

Usage

.bref_text(path)

Arguments

path

Page path beginning with / (e.g. "/leagues/NBA_2024_per_game.html").

Value

The response body as a character string.

Build player roster lookup from boxscore data

Description

Build player roster lookup from boxscore data

Capture the calling function's formal arguments

Description

Returns a named list of the bound formal arguments (excluding ...) of the calling function, suitable for passing to .report_api_error() / .report_api_warning(). Tolerates functions with empty or ...-only formals (where names(formals()) is NULL), unlike the inline mget(setdiff(names(formals()), "...")) pattern that errors with ⁠mget: invalid first argument⁠ for arg-less wrappers.

Usage

.capture_args()

Details

Caller usage:

some_wrapper <- function(...) {
  .args <- .capture_args()
  ...
}

Value

Named list. Empty list if the caller has no non-... formals.

Internal: perform a GET against the CollegeBasketballData API

Description

Attaches the ⁠Authorization: Bearer <CBBD_API_KEY>⁠ header, routes through hoopR's shared .retry_request() (which handles retries, timeouts and proxy resolution), and parses the JSON body. NULL query values are dropped automatically by httr2::req_url_query(), so optional parameters can be threaded through unconditionally.

Usage

.cbbd_get(path, query = list())

Arguments

path

Endpoint path beginning with / (e.g. "/teams").

query

Named list of query parameters. NULL elements are omitted.

Value

The parsed JSON body (a data.frame for list endpoints).

Internal: fetch a URL and return the parsed HTML document

Description

Internal: fetch a URL and return the parsed HTML document

Usage

.ext_html(url)

Arguments

url

Full URL.

Value

An xml_document (rvest).

Minimal brace-template interpolator

Description

Replaces {expr} tokens in template by evaluating expr in envir. Used in .report_api_error() / .report_api_warning() so callers can write hints like "No data for {game_id}" and have {game_id} resolve against the function's frame at the call-site.

Usage

.interp_braces(template, envir = parent.frame())

Arguments

template

character(1).

envir

environment to evaluate expressions against.

Details

Per-token failures (unbound name, parse error) leave the literal {expr} in place rather than erroring, so partial interpolation still produces a useful message.

Value

character(1).

Fetch a KenPom page as parsed HTML using an authenticated cookie jar

Description

Fetch a KenPom page as parsed HTML using an authenticated cookie jar

Usage

.kp_get_page(jar, url)

Arguments

jar

Path to the httr2 cookie jar file (returned by login())

url

The KenPom URL to fetch

Value

A parsed HTML document (xml_document)

KenPom headers as a named list (for httr2 req_headers)

Description

KenPom headers as a named list (for httr2 req_headers)

Usage

.kp_headers_list()

Build an httr2 request with KenPom headers and cookie jar

Description

Build an httr2 request with KenPom headers and cookie jar

Usage

.kp_request(url, jar)

Arguments

url

The URL to request

jar

Path to the httr2 cookie jar file

Value

An httr2 request object

Internal: extract and parse the Next.js `⁠__NEXT_DATA__⁠` JSON from a page

Description

Sites built on Next.js (e.g. HoopsHype) embed their hydrated data in a ⁠<script id="__NEXT_DATA__">⁠ JSON blob. This returns that parsed list.

Usage

.next_data(doc)

Arguments

doc

An xml_document from .ext_html().

Value

The parsed ⁠__NEXT_DATA__⁠ as a list, or NULL if absent.

Internal: coerce a currency-formatted character vector to numeric

Description

Internal: coerce a currency-formatted character vector to numeric

Usage

.parse_currency(x)

Arguments

x

Character vector (e.g. "$59,606,817").

Value

Numeric vector.

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

Internal: fetch a RealGM page and parse it into an `xml_document`

Description

Internal: fetch a RealGM page and parse it into an xml_document

Usage

.realgm_doc(path, wait = 25)

Arguments

path

Page path beginning with /.

wait

Maximum seconds to wait for the Cloudflare challenge to clear.

Value

An xml_document (from rvest::read_html()).

Internal: finalize a RealGM table as a `hoopR_data` tibble

Description

Coerces numeric-looking columns (via .bref_type_convert()), converts to a tibble, and attaches the hoopR_data class + metadata.

Usage

.realgm_finish(df, description)

Arguments

df

A parsed RealGM data.frame.

description

Provenance string stored on the result.

Value

A hoopR_data tibble.

Internal: fetch a RealGM page through headless Chrome (clears Cloudflare)

Description

Navigates headless Chrome to the page, waits for the Cloudflare challenge to resolve (the page title stops being "Just a moment..."), and returns the fully rendered HTML for rvest parsing.

Usage

.realgm_html(path, wait = 25)

Arguments

path

Page path beginning with / (e.g. "/nba/players").

wait

Maximum seconds to wait for the challenge to clear.

Value

The rendered page HTML as a character string.

Internal: pick the best data table from a list of RealGM tables

Description

Chooses the table containing all must_have columns (when supplied) with the most rows; otherwise the table with the most rows.

Usage

.realgm_pick(tables, must_have = NULL)

Arguments

tables

A list of data.frames, e.g. from .realgm_tables().

must_have

Optional character vector of required column names.

Value

A single data.frame, or NULL if tables is empty.

Internal: extract every parseable HTML table from a RealGM document

Description

RealGM pages usually carry a small nav / filter / legend table ahead of the real data table. This returns all tables that parse and clear min_rows, janitor::clean_names()-ed, so a caller can pick or combine them.

Usage

.realgm_tables(doc, min_rows = 1)

Arguments

doc

An xml_document from .realgm_doc().

min_rows

Minimum row count for a table to be kept (drops nav/legend).

Value

A list of cleaned data.frames.

Report an API-call error with full context

Description

Internal helper that standardizes the message every NBA / ESPN / NCAA wrapper emits inside its tryCatch(error = ...) block. Always emits, in order:

Usage

.report_api_error(e, hint = NULL, args = list())

Arguments

e

error condition (the e from ⁠function(e)⁠ in tryCatch).

hint

character. A friendly message with optional {name} tokens that resolve against the caller's environment (so {game_id} etc. pull from the wrapper's formals). If NULL, defaults to "Request failed".

args

optional named list of caller arguments to dump (typically mget(setdiff(names(formals()), "...")) captured at function entry).

Details

A timestamped friendly hint (brace-interpolated against the caller env),
A dump of the function call's arguments,
The actual error message (conditionMessage(e)).

Functions opt in by capturing their formals once near the top – .args <- mget(setdiff(names(formals()), "...")) – and then calling .report_api_error(e, hint = "...", args = .args) from the error handler.

Value

Invisibly NULL. Called for its side effects.

Report an API-call warning with full context

Description

Mirrors .report_api_error() but for tryCatch(warning = ...) handlers. Emits, in order:

Usage

.report_api_warning(w, hint = NULL, args = list())

Arguments

w

warning condition (the w from ⁠function(w)⁠ in tryCatch).

hint

character. Same semantics as .report_api_error()'s hint. If NULL, defaults to "Request emitted a warning".

args

optional named list of caller arguments to dump.

Details

A timestamped friendly hint (brace-interpolated against the caller env),
A dump of the function call's arguments,
The actual warning message (conditionMessage(w)).

Value

Invisibly NULL. Called for its side effects.

Extract response body as text

Description

Replaces the httr::content(as = "text", encoding = "UTF-8") pattern.

Usage

.resp_text(resp)

Arguments

resp

An httr2 response object

Value

Character string of response body

Perform an HTTP GET request with retry logic

Description

Thin wrapper around httr2 that replaces httr::RETRY("GET", ...). Supports optional query parameters and custom headers.

Usage

.retry_request(
  url,
  params = list(),
  headers = NULL,
  timeout = 60,
  proxy = NULL
)

Arguments

url

The URL to request

params

Named list of query parameters (default: empty list)

headers

Named character vector of headers (default: NULL)

timeout

Timeout in seconds (default: 60)

Value

An httr2 response object

Internal: GET a barttorvik.com resource and return the response body text

Description

Routes through hoopR's shared .retry_request() (retries, timeouts, proxy resolution) with a browser User-Agent, and returns the raw response body as a string for downstream CSV / JSON / HTML parsing.

Usage

.torvik_text(path)

Arguments

path

Endpoint path beginning with / (e.g. "/2024_team_results.csv").

Value

The response body as a character string.

Convert V3 PBP columns to V2-compatible format

Description

Convert V3 PBP columns to V2-compatible format

Basketball-Reference Awards Voting

Description

Get end-of-season award voting from Basketball-Reference.

Returns the voting results for the major end-of-season awards (MVP, Rookie of the Year, Defensive Player of the Year, Sixth Man, Most Improved, Clutch Player, Coach of the Year) in one tidy tibble, one row per candidate per award. No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_awards(season = most_recent_nba_season())

Arguments

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per award candidate:

col_name	types	description
award	character	Award slug (`mvp`, `roy`, `dpoy`, `smoy`, `mip`, `clutch_poy`, `coy`).
rank	integer	Finish in the voting.
player	character	Player (or coach) name.
age	integer	Age.
team	character	Team abbreviation.
votes_first	numeric	First-place votes.
points_won	numeric	Voting points won.
points_max	numeric	Maximum possible voting points.
award_share	numeric	Share of the maximum voting points.
season	integer	Season (echoes the `season` argument).

Examples


  try(bref_awards(season = 2024))

Basketball-Reference Draft

Description

Get NBA draft results with career stats from Basketball-Reference.

Returns every pick of a draft, paired with the player's career totals and advanced metrics. No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_draft(season = most_recent_nba_season())

Arguments

season

(integer required): Draft year (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per draft pick (career columns shown – column names are Basketball-Reference data-stat keys):

col_name	types	description
pick_overall	integer	Overall draft pick number.
round	integer	Draft round.
team	character	Drafting team abbreviation.
player	character	Player name.
college_name	character	College / pre-draft team.
seasons	integer	NBA seasons played.
g	integer	Career games.
pts	numeric	Career points.
trb	numeric	Career total rebounds.
ast	numeric	Career assists.
ws	numeric	Career win shares.
bpm	numeric	Career box plus/minus.
vorp	numeric	Career value over replacement player.
season	integer	Draft year (echoes the `season` argument).

Examples


  try(bref_draft(season = 2024))

Basketball-Reference NBA Injury Report

Description

Get the current NBA injury report from Basketball-Reference.

One row per injured player with team, the date the status was last updated and the injury note (status + description). No API key is required.

Note on RotoWorld: RotoWorld was a long-standing NBA injuries source, but NBC shut it down (it now redirects to nbcsports.com/fantasy and the injuries tool is gone). This function uses Basketball-Reference's live injury report instead, which is maintained and carries the same player / team / status / note fields.

Usage

bref_injuries()

Value

A hoopR_data tibble with one row per injured player:

col_name	types	description
player	character	Player name.
team_name	character	Team name.
date_update	character	Date the status was last updated.
note	character	Injury status and description.

Examples


  try(bref_injuries())

Basketball-Reference Player Bios / Index

Description

Get the Basketball-Reference player index for a starting letter, with bios, from Basketball-Reference.

Returns every player whose last name begins with letter, with career span, position, listed height/weight, birth date, college(s) and the player's Basketball-Reference id slug (the key used by bref_player_game_log() and the other player-level ⁠bref_*()⁠ functions). This doubles as a Basketball-Reference player dictionary. No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_player_bios(letter = "a")

Arguments

letter

(character required): Single letter a-z (last-name initial). Defaults to "a".

Value

A hoopR_data tibble with one row per player:

col_name	types	description
player	character	Player name.
player_id	character	Basketball-Reference id slug (e.g. `jamesle01`).
year_min	integer	First season played.
year_max	integer	Last season played.
pos	character	Position(s).
height	character	Listed height (e.g. `6-9`).
weight	integer	Listed weight (lbs).
birth_date	character	Birth date.
colleges	character	College(s).
letter	character	Last-name initial (echoes the `letter` argument).

Examples


  try(bref_player_bios(letter = "a"))

Basketball-Reference Player Game Log

Description

Get a player's game-by-game log for a season from Basketball-Reference.

No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_player_game_log(player_id, season = most_recent_nba_season())

Arguments

player_id

(character required): Basketball-Reference player id slug (e.g. jokicni01 for Nikola Jokić, jamesle01 for LeBron James). This is the id in the player's BREF URL (⁠/players/j/jokicni01.html⁠).

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per regular-season game (column names are Basketball-Reference data-stat keys):

col_name	types	description
ranker	integer	Season game number.
player_game_num_career	integer	Career game number.
date	character	Game date.
team	character	Team abbreviation.
location	character	`@` for away games, empty for home.
opp	character	Opponent abbreviation.
result	character	Result with final score (e.g. `W (+12)`).
is_starter	integer	1 if the player started.
mp	character	Minutes played.
pts	numeric	Points.
trb	numeric	Total rebounds.
ast	numeric	Assists.
game_score	numeric	Hollinger game score.
plus_minus	numeric	Plus/minus.
player_id	character	Player id (echoes the `player_id` argument).
season	integer	Season (echoes the `season` argument).

Full shooting / box columns (fg, fga, fg_pct, fg3, ft, orb, drb, stl, blk, tov, pf, ...) are also returned.

Examples


  try(bref_player_game_log(player_id = "jokicni01", season = 2024))

Basketball-Reference Player Season Stats

Description

Get player season statistics from Basketball-Reference.

Scrapes the league-wide player stat table for a season. No API key is required. Choose the stat table with table. Data is available back to the 1947 (BAA) season for most tables.

Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_players_stats(season = most_recent_nba_season(), table = "per_game")

Arguments

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024 for the 2023-24 season). Defaults to most_recent_nba_season().

table

(character optional): Which stat table to return. One of per_game (default), totals, advanced, per_minute (per 36 minutes), or per_poss (per 100 possessions).

Value

A hoopR_data tibble with one row per player (columns vary by table; common identifying columns shown – column names are Basketball-Reference data-stat keys):

col_name	types	description
ranker	integer	Row rank.
player	character	Player name.
age	integer	Player age on Feb 1 of the season.
team_id	character	Team abbreviation (`TOT` for players on >1 team).
pos	character	Position.
g	integer	Games played.
gs	integer	Games started.
mp_per_g	numeric	Minutes (per_game table) / `mp` total (totals table).
pts_per_g	numeric	Points (scaled to the chosen `table`).
season	integer	Season (echoes the `season` argument).

The advanced table adds per, ts_pct, usg_pct, ws, bpm, vorp, etc.; totals/per_minute/per_poss return the same box categories scaled accordingly.

Examples


  try(bref_players_stats(season = 2024, table = "per_game"))

Basketball-Reference Standings

Description

Get end-of-season conference standings from Basketball-Reference.

No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_standings(season = most_recent_nba_season())

Arguments

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per team:

col_name	types	description
conference	character	Conference (`E` or `W`).
team	character	Team name (with playoff-seed marker stripped).
wins	integer	Wins.
losses	integer	Losses.
win_loss_pct	numeric	Win-loss percentage.
gb	character	Games behind the conference leader.
pts_per_g	numeric	Points scored per game.
opp_pts_per_g	numeric	Opponent points per game.
srs	numeric	Simple Rating System (point margin + SOS).
playoffs	logical	`TRUE` if the team made the playoffs (`*` marker).
season	integer	Season (echoes the `season` argument).

Examples


  try(bref_standings(season = 2024))

Basketball-Reference Team Roster

Description

Get a team's season roster from Basketball-Reference.

No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_team_roster(team, season = most_recent_nba_season())

Arguments

team

(character required): Basketball-Reference team abbreviation (e.g. BOS, LAL, GSW). Historical franchises use their era code (e.g. NJN, SEA).

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per player on the roster:

col_name	types	description
number	character	Jersey number.
player	character	Player name.
pos	character	Position.
height	character	Height.
weight	integer	Weight (lbs).
birth_date	character	Birth date.
years_experience	character	Years of NBA experience (`R` for rookies).
college	character	College.
team	character	Team abbreviation (echoes the `team` argument).
season	integer	Season (echoes the `season` argument).

Examples


  try(bref_team_roster(team = "BOS", season = 2024))

Basketball-Reference Team Season Stats

Description

Get team season statistics from Basketball-Reference.

Scrapes a team stat table from the league season page. No API key is required. Basketball-Reference rate-limits aggressive scraping (~20 requests/minute) – space repeated calls with Sys.sleep().

Usage

bref_teams_stats(season = most_recent_nba_season(), table = "per_game")

Arguments

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

table

(character optional): Which team table to return. One of per_game (default, team per-game), totals, per_poss (per 100 poss), advanced, or opponent (opponent per-game).

Value

A hoopR_data tibble with one row per team (columns vary by table; common identifying columns shown – names are Basketball-Reference data-stat keys):

col_name	types	description
ranker	integer	Row rank.
team	character	Team name.
g	integer	Games played.
mp	numeric	Minutes played.
pts	numeric	Points (scaled to the chosen `table`).
season	integer	Season (echoes the `season` argument).

Examples


  try(bref_teams_stats(season = 2024, table = "per_game"))

CBD Conferences

Description

Get college basketball conferences from the CollegeBasketballData API.

Get historical conference membership from the CollegeBasketballData API.

Usage

cbbd_conferences()

cbbd_conferences_history(conference = NULL)

Arguments

conference

(character optional): Conference abbreviation filter (e.g. B1G). See cbbd_conferences() for valid values.

Value

A hoopR_data tibble with one row per conference:

col_name	types	description
id	integer	CollegeBasketballData conference id.
source_id	character	Source (ESPN) conference id.
name	character	Conference name (e.g. `⁠Big Ten⁠`).
abbreviation	character	Conference abbreviation (e.g. `B1G`).
short_name	character	Conference short name.

A hoopR_data tibble with one row per conference. The teams column is a nested list of per-team membership spans:

col_name	types	description
id	integer	CollegeBasketballData conference id.
source_id	character	Source (ESPN) conference id.
name	character	Conference name.
abbreviation	character	Conference abbreviation.
short_name	character	Conference short name.
teams	list	Nested list of member-team membership spans.

Examples


  try(cbbd_conferences())


  try(cbbd_conferences_history(conference = "B1G"))

CBD Draft Teams

Description

Get NBA draft teams from the CollegeBasketballData API.

Get NBA draft positions from the CollegeBasketballData API.

Get NBA draft picks from the CollegeBasketballData API.

Usage

cbbd_draft_teams()

cbbd_draft_positions()

cbbd_draft_picks(
  year = NULL,
  draft_team = NULL,
  source_team = NULL,
  position = NULL
)

Arguments

year

(integer optional): Draft year (e.g. 2024).

draft_team

(character optional): NBA team filter.

source_team

(character optional): College team filter.

position

(character optional): Position filter.

Value

A hoopR_data tibble with one row per NBA team:

col_name	types	description
id	integer	NBA team id.
source_id	character	Source (ESPN) team id.
location	character	Team location (city).
name	character	Team name.
display_name	character	Full team display name.
abbreviation	character	Team abbreviation.

A hoopR_data tibble with one row per draft position:

col_name	types	description
name	character	Position name.
abbreviation	character	Position abbreviation.

A hoopR_data tibble with one row per draft pick:

col_name	types	description
athlete_id	integer	Athlete id.
source_team_id	integer	College team id.
source_team_location	character	College team location.
source_team_name	character	College team name.
source_team_league_affiliation	character	College team league affiliation.
source_team_college_id	numeric	College id.
draft_team_id	numeric	NBA team id.
draft_team	character	NBA team name.
year	integer	Draft year.
overall	integer	Overall pick number.
round	integer	Draft round.
pick	integer	Pick number within the round.
name	character	Player name.
overall_rank	integer	Pre-draft overall rank.
position_rank	integer	Pre-draft position rank.
height	numeric	Player height.
weight	integer	Player weight (lbs).

Examples


  try(cbbd_draft_teams())


  try(cbbd_draft_positions())


  try(cbbd_draft_picks(year = 2024))

CBD Games

Description

Get college basketball games from the CollegeBasketballData API.

Get game broadcast media information from the CollegeBasketballData API.

Get team box score statistics from the CollegeBasketballData API.

Get player box score statistics from the CollegeBasketballData API.

Get the current scoreboard from the CollegeBasketballData API.

Usage

cbbd_games(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  status = NULL,
  tournament = NULL
)

cbbd_games_media(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_games_teams(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_games_players(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_scoreboard(conference = NULL)

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

season_type

(character optional): One of regular, postseason, preseason.

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

start_date_range

(character optional): ISO 8601 start of date range.

end_date_range

(character optional): ISO 8601 end of date range.

status

(character optional): One of scheduled, in_progress, final, postponed, cancelled.

tournament

(character optional): Tournament filter.

Value

A hoopR_data tibble with one row per game (key columns; period-point arrays are returned as list-columns):

col_name	types	description
id	integer	CollegeBasketballData game id.
source_id	character	Source (ESPN) game id.
season	integer	Season (4-digit ending-year).
season_type	character	Season type.
start_date	character	Game start date (ISO 8601).
neutral_site	logical	Whether the game was at a neutral site.
conference_game	logical	Whether the game was a conference game.
status	character	Game status.
home_team_id	integer	Home team id.
home_team	character	Home team name.
home_points	integer	Home team points.
home_winner	logical	Whether the home team won.
away_team_id	integer	Away team id.
away_team	character	Away team name.
away_points	integer	Away team points.
away_winner	logical	Whether the away team won.
venue_id	integer	Venue id.
venue	character	Venue name.

A hoopR_data tibble with one row per game. The broadcasts column is a nested list of broadcast outlets:

col_name	types	description
game_id	integer	CollegeBasketballData game id.
season	integer	Season (4-digit ending-year).
season_type	character	Season type.
start_date	character	Game start date (ISO 8601).
home_team_id	integer	Home team id.
home_team	character	Home team name.
away_team_id	integer	Away team id.
away_team	character	Away team name.
neutral_site	logical	Whether the game was at a neutral site.
conference_game	logical	Whether the game was a conference game.
broadcasts	list	Nested list of broadcast outlets.

A hoopR_data tibble with one row per team-game. Per-team statistic objects (team_stats, opponent_stats) are flattened into ⁠team_stats_*⁠ / ⁠opponent_stats_*⁠ columns. Key identifying columns:

col_name	types	description
game_id	integer	CollegeBasketballData game id.
season	integer	Season (4-digit ending-year).
start_date	character	Game start date (ISO 8601).
team_id	integer	Team id.
team	character	Team name.
conference	character	Team conference.
opponent_id	integer	Opponent team id.
opponent	character	Opponent team name.
is_home	logical	Whether the team was home.
neutral_site	logical	Whether the game was at a neutral site.
game_minutes	numeric	Total team minutes.
pace	numeric	Game pace (possessions).

A hoopR_data tibble with one row per team-game. The players column is a nested list of per-player box scores. Key identifying columns:

col_name	types	description
game_id	integer	CollegeBasketballData game id.
season	integer	Season (4-digit ending-year).
start_date	character	Game start date (ISO 8601).
team_id	integer	Team id.
team	character	Team name.
conference	character	Team conference.
opponent_id	integer	Opponent team id.
opponent	character	Opponent team name.
is_home	logical	Whether the team was home.
game_minutes	numeric	Total team minutes.
game_pace	numeric	Game pace (possessions).
players	list	Nested list of per-player box scores.

A hoopR_data tibble with one row per game. The home_team, away_team and betting objects are flattened into ⁠home_team_*⁠, ⁠away_team_*⁠ and ⁠betting_*⁠ columns. Key identifying columns:

col_name	types	description
id	integer	CollegeBasketballData game id.
start_date	character	Game start date (ISO 8601).
tv	character	Broadcast TV network.
neutral_site	logical	Whether the game is at a neutral site.
conference_game	logical	Whether the game is a conference game.
status	character	Game status.
period	integer	Current period.
clock	character	Game clock.
venue	character	Venue name.

Examples


  try(cbbd_games(season = 2024, team = "Duke"))


  try(cbbd_games_media(season = 2024, team = "Duke"))


  try(cbbd_games_teams(season = 2024, team = "Duke"))


  try(cbbd_games_players(season = 2024, team = "Duke"))


  try(cbbd_scoreboard(conference = "ACC"))

CBD Betting Lines

Description

Get game betting lines from the CollegeBasketballData API.

Get betting line providers from the CollegeBasketballData API.

Usage

cbbd_lines(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL
)

cbbd_lines_providers()

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

start_date_range

(character optional): ISO 8601 start of date range.

end_date_range

(character optional): ISO 8601 end of date range.

Value

A hoopR_data tibble with one row per game. The lines column is a nested list of per-provider lines:

col_name	types	description
game_id	integer	CollegeBasketballData game id.
season	integer	Season (4-digit ending-year).
season_type	character	Season type.
start_date	character	Game start date (ISO 8601).
home_team_id	integer	Home team id.
home_team	character	Home team name.
home_conference	character	Home team conference.
home_score	numeric	Home team final score.
away_team_id	integer	Away team id.
away_team	character	Away team name.
away_conference	character	Away team conference.
away_score	numeric	Away team final score.
lines	list	Nested list of per-provider betting lines.

A hoopR_data tibble with one row per line provider:

col_name	types	description
id	integer	Line provider id.
name	character	Line provider name.

Examples


  try(cbbd_lines(season = 2024, team = "Duke"))


  try(cbbd_lines_providers())

CBD Team Lineups

Description

Get lineup statistics for a team-season from the CollegeBasketballData API.

Get lineup statistics for a single game from the CollegeBasketballData API.

Usage

cbbd_lineups_team(
  season = most_recent_mbb_season(),
  team,
  start_date_range = NULL,
  end_date_range = NULL
)

cbbd_lineups_game(game_id)

Arguments

season

(integer required): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

team

(character required): Team name (e.g. Duke).

start_date_range

(character optional): ISO 8601 start of date range.

end_date_range

(character optional): ISO 8601 end of date range.

game_id

(integer required): CollegeBasketballData game id. See cbbd_games().

Value

A hoopR_data tibble with one row per lineup. The athletes column is a list of lineup members; team_stats/opponent_stats are flattened into prefixed columns. Key identifying columns:

col_name	types	description
team_id	integer	Team id.
team	character	Team name.
conference	character	Conference name.
id_hash	character	Unique hash identifying the lineup.
athletes	list	List of athletes in the lineup.
total_seconds	numeric	Total seconds the lineup played.
pace	numeric	Lineup pace (possessions).
offense_rating	numeric	Lineup offensive rating.
defense_rating	numeric	Lineup defensive rating.
net_rating	numeric	Lineup net rating.

A hoopR_data tibble with one row per lineup (same columns as cbbd_lineups_team()).

Examples


  try(cbbd_lineups_team(season = 2024, team = "Duke"))


  try(cbbd_lineups_game(game_id = 5881))

CBD Plays by Game

Description

Get play-by-play data for a single game from the CollegeBasketballData API.

Get play-by-play data for a single player from the CollegeBasketballData API.

Get play-by-play data for a team-season from the CollegeBasketballData API.

Get play-by-play data for all games on a date from the CollegeBasketballData API.

Get play-by-play data for a tournament from the CollegeBasketballData API.

Get the list of play types from the CollegeBasketballData API.

Usage

cbbd_plays_game(game_id, shooting_plays_only = FALSE)

cbbd_plays_player(
  player_id,
  season = most_recent_mbb_season(),
  shooting_plays_only = FALSE
)

cbbd_plays_team(
  season = most_recent_mbb_season(),
  team,
  shooting_plays_only = FALSE
)

cbbd_plays_date(date, shooting_plays_only = FALSE, utc_offset = NULL)

cbbd_plays_tournament(
  tournament,
  season = most_recent_mbb_season(),
  shooting_plays_only = FALSE
)

cbbd_play_types()

Arguments

game_id

(integer required): CollegeBasketballData game id. See cbbd_games().

shooting_plays_only

(logical optional): If TRUE, return only shooting plays. Defaults to FALSE.

player_id

(integer required): Athlete id.

season

(integer required): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

team

(character required): Team name (e.g. Duke).

date

(character required): Date-time in ISO 8601 format (e.g. ⁠2024-02-01T00:00:00.000Z⁠).

utc_offset

(numeric optional): UTC offset (hours) for the date.

tournament

(character required): Tournament name (e.g. NCAA).

Value

A hoopR_data tibble with one row per play (key columns; shot_info is flattened to ⁠shot_info_*⁠, participants/on_floor are list-columns):

col_name	types	description
id	integer	Play id.
game_id	integer	Game id.
season	numeric	Season (4-digit ending-year).
play_type	character	Play type description.
team_id	integer	Team id of the team on the play.
team	character	Team on the play.
period	integer	Period number.
clock	character	Game clock.
seconds_remaining	integer	Seconds remaining in the period.
home_score	integer	Home score after the play.
away_score	integer	Away score after the play.
scoring_play	logical	Whether the play scored.
shooting_play	logical	Whether the play was a shot.
score_value	numeric	Point value of the play.
play_text	character	Play description text.

A hoopR_data tibble with one row per play (same columns as cbbd_plays_game()).

A hoopR_data tibble with one row per play type:

col_name	types	description
id	integer	Play type id.
name	character	Play type name.

Examples


  try(cbbd_plays_game(game_id = 5881))


  try(cbbd_plays_player(player_id = 160, season = 2024))


  try(cbbd_plays_team(season = 2024, team = "Duke"))


  try(cbbd_plays_date(date = "2024-02-01T00:00:00.000Z"))


  try(cbbd_plays_tournament(tournament = "NCAA", season = 2024))


  try(cbbd_play_types())

CBD Rankings

Description

Get poll rankings (AP / Coaches) from the CollegeBasketballData API.

Usage

cbbd_rankings(
  season = most_recent_mbb_season(),
  season_type = NULL,
  week = NULL,
  poll_type = NULL,
  team = NULL,
  conference = NULL
)

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

season_type

(character optional): One of regular, postseason, preseason.

week

(integer optional): Poll week filter.

poll_type

(character optional): One of ap, coaches.

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

Value

A hoopR_data tibble with one row per ranked team per poll:

col_name	types	description
season	integer	Season (4-digit ending-year).
season_type	character	Season type.
week	integer	Poll week.
poll_date	character	Date the poll was released.
poll_type	character	Poll type (`ap` or `coaches`).
team_id	integer	CollegeBasketballData team id.
team	character	Team name.
conference	character	Conference name.
ranking	integer	Poll rank.
points	numeric	Poll points received.
first_place_votes	numeric	Number of first-place votes.

Examples


  try(cbbd_rankings(season = 2024, poll_type = "ap"))

CBD SRS Ratings

Description

Get Simple Rating System (SRS) ratings from the CollegeBasketballData API.

Get adjusted efficiency ratings from the CollegeBasketballData API.

Get Elo ratings from the CollegeBasketballData API.

Usage

cbbd_ratings_srs(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL
)

cbbd_ratings_adjusted(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL
)

cbbd_ratings_elo(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL
)

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

team

(character optional): Team name filter (e.g. Duke).

conference

(character optional): Conference abbreviation filter.

Value

A hoopR_data tibble with one row per team-season:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	CollegeBasketballData team id.
team	character	Team name.
conference	character	Conference name.
rating	numeric	Simple Rating System (SRS) value.

A hoopR_data tibble with one row per team-season. ⁠rankings_*⁠ columns are flattened from the nested rankings object:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	CollegeBasketballData team id.
team	character	Team name.
conference	character	Conference name.
offensive_rating	numeric	Adjusted offensive efficiency rating.
defensive_rating	numeric	Adjusted defensive efficiency rating.
net_rating	numeric	Adjusted net efficiency rating.

A hoopR_data tibble with one row per team-season:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	CollegeBasketballData team id.
team	character	Team name.
conference	character	Conference name.
elo	integer	End-of-season Elo rating.

Examples


  try(cbbd_ratings_srs(season = 2024))


  try(cbbd_ratings_adjusted(season = 2024))


  try(cbbd_ratings_elo(season = 2024))

CBD Recruiting Players

Description

Get player recruiting rankings from the CollegeBasketballData API.

Get team recruiting rankings from the CollegeBasketballData API.

Get transfer portal data from the CollegeBasketballData API.

Usage

cbbd_recruiting_players(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL
)

cbbd_recruiting_teams(year = NULL, team = NULL, conference = NULL)

cbbd_recruiting_portal(
  year = NULL,
  source_team = NULL,
  destination_team = NULL,
  source_conference = NULL,
  destination_conference = NULL,
  position = NULL
)

Arguments

year

(integer optional): Recruiting class year (e.g. 2024).

team

(character optional): Committed team filter.

conference

(character optional): Conference abbreviation filter.

position

(character optional): Position filter.

source_team

(character optional): Origin team filter.

destination_team

(character optional): Destination team filter.

source_conference

(character optional): Origin conference filter.

destination_conference

(character optional): Destination conference filter.

Value

A hoopR_data tibble with one row per recruit. The hometown and committed_to objects are flattened into prefixed columns:

col_name	types	description
id	integer	Recruit id.
source_id	character	Source (ESPN) recruit id.
position	character	Recruit position.
school_id	integer	High school / club id.
school	character	High school / club name.
athlete_id	integer	Athlete id (once enrolled).
year	integer	Recruiting class year.
name	character	Recruit name.
height_inches	numeric	Height in inches.
weight_pounds	integer	Weight in pounds.
stars	integer	Star rating.
rating	numeric	Numeric recruit rating.
ranking	integer	Overall ranking.

A hoopR_data tibble with one row per team:

col_name	types	description
team_id	integer	CollegeBasketballData team id.
team	character	Team name.
conference	character	Conference name.
year	integer	Recruiting class year.
ranking	integer	Team recruiting ranking.
rating	numeric	Team recruiting rating.

A hoopR_data tibble with one row per transfer. The origin and destination objects are flattened into prefixed columns:

col_name	types	description
id	integer	Transfer id.
source_id	character	Source (ESPN) athlete id.
year	integer	Transfer class year.
first_name	character	Player first name.
last_name	character	Player last name.
position	character	Player position.
eligibility	character	Eligibility status.
years_remaining	integer	Years of eligibility remaining.
stars	integer	Star rating.
rating	numeric	Numeric rating.

Examples


  try(cbbd_recruiting_players(year = 2024))


  try(cbbd_recruiting_teams(year = 2024))


  try(cbbd_recruiting_portal(year = 2024))

CBD Team Season Stats

Description

Get team season statistics from the CollegeBasketballData API.

Get the team statistics leaderboard from the CollegeBasketballData API.

Get team season shooting statistics from the CollegeBasketballData API.

Get player season statistics from the CollegeBasketballData API.

Get player season shooting statistics from the CollegeBasketballData API.

Usage

cbbd_stats_team_season(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL
)

cbbd_stats_team_leaderboard(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL
)

cbbd_stats_team_shooting_season(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL
)

cbbd_stats_player_season(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL
)

cbbd_stats_player_shooting_season(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL
)

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

season_type

(character optional): One of regular, postseason, preseason.

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

start_date_range

(character optional): ISO 8601 start of date range.

end_date_range

(character optional): ISO 8601 end of date range.

Value

A hoopR_data tibble with one row per team-season. The team_stats and opponent_stats objects are flattened into ⁠team_stats_*⁠ / ⁠opponent_stats_*⁠ columns. Key identifying columns:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	Team id.
team	character	Team name.
conference	character	Conference name.
games	integer	Games played.
wins	numeric	Wins.
losses	numeric	Losses.
total_minutes	numeric	Total minutes played.
pace	numeric	Average pace (possessions).

A hoopR_data tibble with one row per team. Nested statistic objects (record, summary, team_stats, opponent_stats, shot_profile, adjusted_efficiency) are flattened into prefixed columns. Key identifying columns:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	Team id.
team	character	Team name.

A hoopR_data tibble with one row per team-season. Shot-type objects (dunks, layups, tip_ins, two_point_jumpers, three_point_jumpers, free_throws, attempts_breakdown) are flattened into prefixed columns. Key identifying columns:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	Team id.
team	character	Team name.
conference	character	Conference name.
tracked_shots	integer	Number of tracked shots.
assisted_pct	numeric	Assisted field-goal percentage.

A hoopR_data tibble with one row per player-season. Nested statistic objects (field_goals, two_point_field_goals, three_point_field_goals, free_throws, rebounds, win_shares) are flattened into prefixed columns. Key identifying columns:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	Team id.
team	character	Team name.
conference	character	Conference name.
athlete_id	integer	Athlete id.
name	character	Player name.
position	character	Player position.
games	numeric	Games played.
minutes	numeric	Minutes played.
points	numeric	Total points.

A hoopR_data tibble with one row per player-season. Shot-type objects are flattened into prefixed columns. Key identifying columns:

col_name	types	description
season	integer	Season (4-digit ending-year).
team_id	integer	Team id.
team	character	Team name.
conference	character	Conference name.
athlete_id	integer	Athlete id.
athlete_name	character	Player name.
tracked_shots	integer	Number of tracked shots.
assisted_pct	numeric	Assisted field-goal percentage.

Examples


  try(cbbd_stats_team_season(season = 2024, team = "Duke"))


  try(cbbd_stats_team_leaderboard(season = 2024))


  try(cbbd_stats_team_shooting_season(season = 2024, team = "Duke"))


  try(cbbd_stats_player_season(season = 2024, team = "Duke"))


  try(cbbd_stats_player_shooting_season(season = 2024, team = "Duke"))

CBD Substitutions by Game

Description

Get substitution data for a single game from the CollegeBasketballData API.

Get substitution data for a single player from the CollegeBasketballData API.

Get substitution data for a team-season from the CollegeBasketballData API.

Usage

cbbd_substitutions_game(game_id)

cbbd_substitutions_player(player_id, season = most_recent_mbb_season())

cbbd_substitutions_team(season = most_recent_mbb_season(), team)

Arguments

game_id

(integer required): CollegeBasketballData game id. See cbbd_games().

player_id

(integer required): Athlete id.

season

(integer required): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

team

(character required): Team name (e.g. Duke).

Value

A hoopR_data tibble with one row per substitution. sub_in and sub_out objects are flattened to ⁠sub_in_*⁠ / ⁠sub_out_*⁠ columns:

col_name	types	description
game_id	integer	Game id.
start_date	character	Game start date (ISO 8601).
team_id	integer	Team id.
team	character	Team name.
conference	character	Team conference.
athlete_id	integer	Athlete id.
athlete	character	Athlete name.
position	character	Athlete position.
opponent_id	integer	Opponent team id.
opponent	character	Opponent team name.
opponent_conference	character	Opponent conference.

A hoopR_data tibble with one row per substitution (same columns as cbbd_substitutions_game()).

Examples


  try(cbbd_substitutions_game(game_id = 5881))


  try(cbbd_substitutions_player(player_id = 160, season = 2024))


  try(cbbd_substitutions_team(season = 2024, team = "Duke"))

CBD Teams

Description

Get college basketball teams from the CollegeBasketballData API.

Get a college basketball team roster from the CollegeBasketballData API.

Usage

cbbd_teams(conference = NULL, season = most_recent_mbb_season())

cbbd_teams_roster(season = most_recent_mbb_season(), team = NULL)

Arguments

conference

(character optional): Conference abbreviation filter (e.g. ACC). See cbbd_conferences() for valid values.

season

(integer optional): Season, in 4-digit format ending-year (e.g. 2024 for the 2023-24 season). Defaults to most_recent_mbb_season().

team

(character optional): Team name filter (e.g. Duke).

Value

A hoopR_data tibble with one row per team:

col_name	types	description
id	integer	CollegeBasketballData team id.
source_id	character	Source (ESPN) team id.
school	character	School name.
mascot	character	Team mascot.
abbreviation	character	Team abbreviation.
display_name	character	Full team display name.
short_display_name	character	Short team display name.
primary_color	character	Primary team color (hex).
secondary_color	character	Secondary team color (hex).
current_venue_id	integer	Current home venue id.
current_venue	character	Current home venue name.
current_city	character	Current home venue city.
current_state	character	Current home venue state.
conference_id	integer	Conference id.
conference	character	Conference name.

A hoopR_data tibble with one row per team. The players column is a nested list of roster players:

col_name	types	description
team_id	integer	CollegeBasketballData team id.
team_source_id	character	Source (ESPN) team id.
team	character	Team name.
conference	character	Conference name.
season	integer	Season (4-digit ending-year).
players	list	Nested list of roster players.

Examples


  try(cbbd_teams(conference = "ACC"))


  try(cbbd_teams_roster(season = 2024, team = "Duke"))

CBD Venues

Description

Get college basketball venues from the CollegeBasketballData API.

Usage

cbbd_venues()

Value

A hoopR_data tibble with one row per venue:

col_name	types	description
id	integer	CollegeBasketballData venue id.
source_id	character	Source (ESPN) venue id.
name	character	Venue name.
city	character	Venue city.
state	character	Venue state.
country	character	Venue country.

Examples


  try(cbbd_venues())

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.

Project an ESPN core-v2 athlete record into a `player_core` row

Description

Turns one ESPN core-v2 ⁠/athletes/{id}⁠ payload into the single tidy row released as the player_core dataset.

This is a pure projection: it takes an already-fetched payload and never performs I/O. That is deliberate — the compile stages in hoopR-nba-data / hoopR-mbb-data read the payload from the sibling -raw tree, and re-fetching here would both break the one-way raw -> data boundary and mean the R and Python pipelines read different bytes, so a value divergence could not be attributed to method.

Ids for college and current team are parsed out of the payload's ⁠$ref⁠ URLs (⁠/colleges/{id}⁠, ⁠/teams/{id}⁠). The ⁠$ref⁠ is never followed.

Usage

espn_basketball_player_core(payload, athlete_id)

Arguments

payload

list. One athlete's core-v2 ⁠/athletes/{athlete_id}⁠ payload, as returned by jsonlite::fromJSON(..., simplifyVector = FALSE). An empty or non-list value yields a zero-row tibble rather than an error.

athlete_id

numeric or character. The ESPN athlete id. Required and never inferred from the payload — callers pass the id from the file path, so a payload missing its own id still produces a joinable row.

Details

What the row means. current_team_id is the athlete's team today, not their team in any past season — the season a released row is filed under is participation (who appeared that year, taken from player_box), not the vintage of the bio. Height, weight and jersey are likewise a current snapshot: ESPN overwrites them in place, so era-correct bio is not obtainable from this endpoint.

Parity. This is a port of sportsdataverse.nba.helper_nba_player_core (sdv-py 0.0.75), which produces the released dataset today. The two are held to byte-parity by tests/testthat/test-espn_basketball_player_core.R against a golden fixture captured from that function; see tests/testthat/fixtures/player_core/README.md for provenance. Neither implementation is authoritative — a divergence is a review item.

Value

A one-row tibble carrying the full 35-column set (absent fields are NA), so callers see a stable schema regardless of payload completeness:

col_name	types
athlete_id	integer
guid	character
uid	character
slug	character
type	character
first_name	character
last_name	character
full_name	character
display_name	character
short_name	character
height	numeric
display_height	character
weight	numeric
display_weight	character
age	integer
date_of_birth	character
birth_city	character
birth_state	character
birth_country	character
jersey	character
position_id	integer
position_name	character
position_abbreviation	character
position_display_name	character
college_id	integer
current_team_id	integer
headshot_href	character
experience_years	integer
status_id	integer
status_name	character
status_type	character
draft_year	integer
draft_round	integer
draft_selection	integer
active	logical

Twin

wehoop::espn_basketball_player_core() is the identical function for the women's leagues. The core-v2 athlete resource is the same payload shape for nba/wnba/mbb/wbb, so the projection is league-agnostic – sdv-py implements it once and re-exports it per league. hoopR and wehoop are independently published and neither depends on the other, so here it is duplicated: a change to one must land in the other in the same session, verified.

Author(s)

Saiem Gilani

Examples


  # Split across lines to keep the Rd under the line-width limit; the
  # core-v2 $ref URLs are long enough to be truncated in the PDF manual.
  team_ref <- paste0(
    "http://sports.core.api.espn.com/v2/sports/basketball/",
    "leagues/nba/seasons/2025/teams/22"
  )
  payload <- list(
    guid = "abc", fullName = "Jane Doe", jersey = "23",
    position = list(id = "5", abbreviation = "G"),
    team = list(`$ref` = team_ref)
  )
  espn_basketball_player_core(payload, athlete_id = 1966)

Get ESPN Women's College Basketball Athletes Index

Description

Get ESPN Women's College Basketball Athletes Index

Get ESPN NBA Athletes Index

Usage

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

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

Columns as documented in the shared espn_mbb_athletes_index_schema table.

A single hoopR_data tibble with one row per athlete.

Columns as documented in the shared espn_mbb_athletes_index_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_athletes_index(season = 2025, limit = 50)


  espn_nba_athletes_index(season = 2025, limit = 50)

Shared column schema: espn mbb athletes index schema

Description

Columns shared verbatim across: espn_mbb_athletes_index, espn_nba_athletes_index.

Details

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

Get ESPN MBB Season Award Detail

Description

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

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_mbb_award(award_id, season = most_recent_mbb_season(), ...)

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

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

Examples


  espn_mbb_award(award_id = 344, season = 2024)


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

Shared column schema: espn mbb betting againstthespread schema

Description

Columns shared verbatim across: espn_mbb_betting, espn_nba_betting.

Details

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.

Shared column schema: espn mbb betting pickcenter schema

Description

Columns shared verbatim across: espn_mbb_betting, espn_nba_betting.

Details

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.

Shared column schema: espn mbb betting predictor schema

Description

Columns shared verbatim across: espn_mbb_betting, espn_nba_betting.

Details

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.

Get ESPN MBB Calendar

Description

Get ESPN MBB Calendar

Get ESPN Women's College Basketball Calendar

Get ESPN NBA Calendar

Usage

espn_mbb_calendar(season = most_recent_mbb_season())

espn_nba_calendar(season = most_recent_nba_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).

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.

Columns as documented in the shared espn_mbb_calendar_schema table.

Returns a tibble of calendar entries.

Columns as documented in the shared espn_mbb_calendar_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_calendar(season = 2025)


  espn_nba_calendar(season = 2025)

Shared column schema: espn mbb calendar schema

Description

Columns shared verbatim across: espn_mbb_calendar, espn_nba_calendar.

Details

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

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.

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_mbb_coach(coach_id, ...)

espn_nba_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.

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

Examples


  espn_mbb_coach(coach_id = 32116)


  espn_nba_coach(coach_id = 52120)

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

espn_nba_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

Examples


  espn_mbb_coach_record(coach_id = 32116, record_type = 2)


  espn_nba_coach_record(coach_id = 52120, 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(), ...)

espn_nba_coach_season(coach_id, season = most_recent_nba_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

Get ESPN NBA Coach-in-Season Detail

Value

A single-row tibble.

Columns as documented in the shared espn_mbb_coach_season_schema table.

A single-row tibble.

Columns as documented in the shared espn_mbb_coach_season_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_coach_season(coach_id = 32116, season = 2025)


  espn_nba_coach_season(coach_id = 52120, season = 2025)

Shared column schema: espn mbb coach season schema

Description

Columns shared verbatim across: espn_mbb_coach_season, espn_nba_coach_season.

Details

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.

Get ESPN Women's College Basketball Coaches

Description

Get ESPN Women's College Basketball Coaches

Get ESPN NBA Coaches

Usage

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

espn_nba_coaches(season = most_recent_nba_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.

Columns as documented in the shared espn_mbb_coaches_schema table.

A single hoopR_data tibble with one row per coach.

Columns as documented in the shared espn_mbb_coaches_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_coaches(season = 2025)


  espn_nba_coaches(season = 2025)

Shared column schema: espn mbb coaches schema

Description

Columns shared verbatim across: espn_mbb_coaches, espn_nba_coaches.

Details

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.

Get ESPN conference names and IDs

Description

Get ESPN conference names and IDs

Get ESPN NBA Conferences

Usage

espn_mbb_conferences()

espn_nba_conferences()

Value

A conferences data frame

Columns as documented in the shared espn_mbb_conferences_schema table.

A hoopR_data tibble with one row per conference:

Columns as documented in the shared espn_mbb_conferences_schema table.

Author(s)

Saiem Gilani

Examples


try(espn_mbb_conferences())


  try(espn_nba_conferences())

Shared column schema: espn mbb conferences schema

Description

Columns shared verbatim across: espn_mbb_conferences, espn_nba_conferences.

Details

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.

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.

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_mbb_franchise(franchise_id, ...)

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

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

Examples


  espn_mbb_franchise(franchise_id = 150)


  espn_nba_franchise(franchise_id = 13)

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.

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_mbb_franchises(...)

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 (`"mens-college-basketball"`).

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

Examples


  espn_mbb_franchises()


  espn_nba_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.

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_mbb_futures(season = most_recent_mbb_season(), ...)

espn_nba_futures(season = most_recent_nba_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.

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

Examples


  espn_mbb_futures(season = 2025)


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

Get ESPN men's college basketball PBP data

Get ESPN men's college basketball team box scores

Get ESPN men's college basketball player box scores

Get ESPN men's college basketball game rosters

Get ESPN MBB's Betting information

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

Get ESPN NBA PBP data

Get ESPN NBA team box scores

Get ESPN NBA player box scores

Get ESPN NBA game rosters

Get ESPN NBA's Betting information

Usage

espn_mbb_game_all(game_id)

espn_mbb_pbp(game_id)

espn_mbb_team_box(game_id)

espn_mbb_player_box(game_id)

espn_mbb_game_rosters(game_id)

espn_mbb_betting(game_id)

espn_nba_game_all(game_id)

espn_nba_pbp(game_id)

espn_nba_team_box(game_id)

espn_nba_player_box(game_id)

espn_nba_game_rosters(game_id)

espn_nba_betting(game_id)

Arguments

game_id

Game ID

Value

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

Plays

Columns as documented in the shared espn_mbb_game_all_plays_schema table.

Team

Columns as documented in the shared espn_mbb_game_all_team_schema table.

Player

Columns as documented in the shared espn_mbb_game_all_player_schema table.

A play-by-play data frame.

Plays

Columns as documented in the shared espn_mbb_game_all_plays_schema table.

A team boxscore data frame

Team

Columns as documented in the shared espn_mbb_game_all_team_schema table.

A player boxscore data frame

Player

Columns as documented in the shared espn_mbb_game_all_player_schema table.

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.

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

pickcenter

Columns as documented in the shared espn_mbb_betting_pickcenter_schema table.

againstTheSpread

Columns as documented in the shared espn_mbb_betting_againstthespread_schema table.

predictor

Columns as documented in the shared espn_mbb_betting_predictor_schema table.

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

Plays

Columns as documented in the shared espn_nba_game_all_plays_schema table.

Team

Columns as documented in the shared espn_nba_game_all_team_schema table.

Player

Columns as documented in the shared espn_nba_game_all_player_schema table.

A play-by-play data frame.

Plays

Columns as documented in the shared espn_nba_game_all_plays_schema table.

A team boxscore data frame

Team

Columns as documented in the shared espn_nba_game_all_team_schema table.

A player boxscore data frame

Player

Columns as documented in the shared espn_nba_game_all_player_schema table.

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.

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

pickcenter

Columns as documented in the shared espn_mbb_betting_pickcenter_schema table.

againstTheSpread

Columns as documented in the shared espn_mbb_betting_againstthespread_schema table.

predictor

Columns as documented in the shared espn_mbb_betting_predictor_schema table.

Author(s)

Saiem Gilani

Examples


try(espn_mbb_game_all(game_id = 401479672))


try(espn_mbb_pbp(game_id = 401479672))



try(espn_mbb_team_box(game_id = 401479672))


try(espn_mbb_player_box(game_id = 401479672))


try(espn_mbb_game_rosters(game_id = 401256760))


try(espn_mbb_betting(game_id = 401256760))


try(espn_nba_game_all(game_id = 401283399))



try(espn_nba_pbp(game_id = 401071880))



try(espn_nba_team_box(game_id = 401071880))



try(espn_nba_player_box(game_id = 401071880))



try(espn_nba_game_rosters(game_id = 401283399))


try(espn_nba_betting(game_id = 401283399))

Shared column schema: espn mbb game all player schema

Description

Columns shared verbatim across: espn_mbb_game_all, espn_mbb_player_box, load_mbb_player_box.

Details

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.

Shared column schema: espn mbb game all plays schema

Description

Columns shared verbatim across: espn_mbb_game_all, espn_mbb_pbp.

Details

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

Shared column schema: espn mbb game all team schema

Description

Columns shared verbatim across: espn_mbb_game_all, espn_mbb_team_box.

Details

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.

Shared column schema: espn mbb game broadcasts schema

Description

Columns shared verbatim across: espn_mbb_game_broadcasts, espn_nba_game_broadcasts.

Details

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.

Get ESPN Women's College Basketball Event Odds

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.

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

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

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.

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

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

Usage

espn_mbb_game_odds(event_id, ...)

espn_mbb_game_officials(event_id, ...)

espn_mbb_game_broadcasts(event_id, ...)

espn_mbb_game_situation(event_id, ...)

espn_mbb_game_predictor(event_id, ...)

espn_mbb_game_powerindex(event_id, ...)

espn_nba_game_odds(event_id, ...)

espn_nba_game_officials(event_id, ...)

espn_nba_game_broadcasts(event_id, ...)

espn_nba_game_situation(event_id, ...)

espn_nba_game_predictor(event_id, ...)

espn_nba_game_powerindex(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.

Details

Get ESPN MBB Event Predictor (Pre-game)

Get ESPN MBB Event Power Index Index

Get ESPN NBA Event Predictor (Pre-game)

Get ESPN NBA Event Power Index Index

Value

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

Columns as documented in the shared espn_mbb_game_odds_schema table.

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

Columns as documented in the shared espn_mbb_game_officials_schema table.

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

Columns as documented in the shared espn_mbb_game_broadcasts_schema table.

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

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

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

A tibble with one row per odds provider.

Columns as documented in the shared espn_mbb_game_odds_schema table.

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

Columns as documented in the shared espn_mbb_game_officials_schema table.

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

Columns as documented in the shared espn_mbb_game_broadcasts_schema table.

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

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

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

Author(s)

Saiem Gilani

Examples


  espn_mbb_game_odds(event_id = "401256760")


  espn_mbb_game_officials(event_id = "401256760")


  espn_mbb_game_broadcasts(event_id = "401256760")


  espn_mbb_game_situation(event_id = 401256760)


  espn_mbb_game_predictor(event_id = 401256760)


  espn_mbb_game_powerindex(event_id = 401256760)


  espn_nba_game_odds(event_id = "401283399")


  espn_nba_game_officials(event_id = "401283399")


  espn_nba_game_broadcasts(event_id = "401283399")


  espn_nba_game_situation(event_id = 401283399)


  espn_nba_game_predictor(event_id = 401283399)


  espn_nba_game_powerindex(event_id = 401283399)

Shared column schema: espn mbb game odds schema

Description

Columns shared verbatim across: espn_mbb_game_odds, espn_nba_game_odds.

Details

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

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.

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_mbb_game_official_detail(event_id, order, ...)

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

Examples


  espn_mbb_game_official_detail(event_id = 401256760, order = 1)


  espn_nba_game_official_detail(event_id = 401283399, order = 1)

Shared column schema: espn mbb game officials schema

Description

Columns shared verbatim across: espn_mbb_game_officials, espn_nba_game_officials.

Details

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.

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.

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_mbb_game_play(event_id, play_id, ...)

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

Examples


  espn_mbb_game_play(event_id = 401256760, play_id = 401256760101805901)


  espn_nba_game_play(event_id = 401283399, play_id = 4012833994)

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.

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_mbb_game_play_personnel(event_id, play_id, ...)

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

Examples


  espn_mbb_game_play_personnel(event_id = 401256760, play_id = 401256760101805901)


  espn_nba_game_play_personnel(event_id = 401283399, play_id = 4012833994)

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

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_mbb_game_player_box(event_id, team_id, athlete_id, stat_type = 0L, ...)

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

Examples


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


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

Get ESPN Women's College Basketball Event Win Probabilities

Description

Get ESPN Women's College Basketball Event Win Probabilities

Get ESPN NBA Event Win Probabilities

Usage

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

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.

Columns as documented in the shared espn_mbb_game_probabilities_schema table.

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

Columns as documented in the shared espn_mbb_game_probabilities_schema table.

Author(s)

Saiem Gilani

Examples


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


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

Shared column schema: espn mbb game probabilities schema

Description

Columns shared verbatim across: espn_mbb_game_probabilities, espn_nba_game_probabilities.

Details

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

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.

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_mbb_game_propbets(event_id, provider_id, ...)

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_mbb_game_odds().

...

Additional arguments; currently unused.

Details

Get ESPN MBB Event Prop Bets (Long Format)

Get ESPN NBA Event Prop Bets (Long Format)

Value

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

Author(s)

Saiem Gilani

Examples


  espn_mbb_game_propbets(event_id = 401256760, provider_id = 58)


  espn_nba_game_propbets(event_id = 401283399, provider_id = 58)

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

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.

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.

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.

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

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.

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

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.

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.

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.

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

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_mbb_game_team_linescores(event_id, team_id, ...)

espn_mbb_game_team_leaders(event_id, team_id, ...)

espn_mbb_game_team_roster(event_id, team_id, ...)

espn_mbb_game_team_statistics(event_id, team_id, ...)

espn_mbb_game_team_records(event_id, team_id, ...)

espn_mbb_game_team_score(event_id, team_id, ...)

espn_nba_game_team_linescores(event_id, team_id, ...)

espn_nba_game_team_leaders(event_id, team_id, ...)

espn_nba_game_team_roster(event_id, team_id, ...)

espn_nba_game_team_statistics(event_id, team_id, ...)

espn_nba_game_team_records(event_id, team_id, ...)

espn_nba_game_team_score(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.

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

A tibble with one row per active athlete.

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

A tibble with one row per record type.

A single-row tibble.

A tibble with one row per period.

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

A tibble with one row per active athlete.

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

A tibble with one row per record type.

A single-row tibble.

Author(s)

Saiem Gilani

Examples


  espn_mbb_game_team_linescores(event_id = 401256760, team_id = 52)


  espn_mbb_game_team_leaders(event_id = 401256760, team_id = 52)


  espn_mbb_game_team_roster(event_id = 401256760, team_id = 52)


  espn_mbb_game_team_statistics(event_id = 401256760, team_id = 52)


  espn_mbb_game_team_records(event_id = 401256760, team_id = 52)


  espn_mbb_game_team_score(event_id = 401256760, team_id = 52)


  espn_nba_game_team_linescores(event_id = 401283399, team_id = 29)


  espn_nba_game_team_leaders(event_id = 401283399, team_id = 29)


  espn_nba_game_team_roster(event_id = 401283399, team_id = 29)


  espn_nba_game_team_statistics(event_id = 401283399, team_id = 29)


  espn_nba_game_team_records(event_id = 401283399, team_id = 29)


  espn_nba_game_team_score(event_id = 401283399, team_id = 29)

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.

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_mbb_game_team_roster_entry(event_id, team_id, athlete_id, ...)

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

Examples


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


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

Get ESPN Women's College Basketball Injuries

Description

Get ESPN Women's College Basketball Injuries

Get ESPN NBA Injuries

Usage

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

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

Columns as documented in the shared espn_mbb_injuries_injuries_schema table.

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

Injuries

Columns as documented in the shared espn_mbb_injuries_injuries_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_injuries()


  espn_nba_injuries()

Shared column schema: espn mbb injuries injuries schema

Description

Columns shared verbatim across: espn_mbb_injuries, espn_nba_injuries.

Details

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

Get ESPN Women's College Basketball League Leaders

Description

Get ESPN Women's College Basketball League Leaders

Get ESPN NBA League Leaders

Usage

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

espn_nba_leaders(season = most_recent_nba_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.

Columns as documented in the shared espn_mbb_leaders_schema table.

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

Columns as documented in the shared espn_mbb_leaders_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_leaders(season = 2025, season_type = 2)


  espn_nba_leaders(season = 2024, season_type = 2)

Shared column schema: espn mbb leaders schema

Description

Columns shared verbatim across: espn_mbb_leaders, espn_nba_leaders.

Details

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.

Get ESPN MBB News

Description

Get ESPN MBB News

Get ESPN Women's College Basketball News

Get ESPN NBA News

Usage

espn_mbb_news(limit = 50)

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

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.

Columns as documented in the shared espn_mbb_news_schema table.

Returns a tibble of news articles.

Columns as documented in the shared espn_mbb_news_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_news(limit = 5)


  espn_nba_news(limit = 5)

Shared column schema: espn mbb news schema

Description

Columns shared verbatim across: espn_mbb_news, espn_mbb_team_news, espn_nba_news, espn_nba_team_news.

Details

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

Get ESPN Women's College Basketball Athlete Awards

Description

Get ESPN Women's College Basketball Athlete Awards

Get ESPN NBA Athlete Awards

Usage

espn_mbb_player_awards(athlete_id, ...)

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.

Columns as documented in the shared espn_mbb_player_awards_schema table.

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

Columns as documented in the shared espn_mbb_player_awards_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_player_awards(athlete_id = "4593919")


  espn_nba_player_awards(athlete_id = "1966")

Shared column schema: espn mbb player awards schema

Description

Columns shared verbatim across: espn_mbb_player_awards, espn_nba_player_awards.

Details

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.

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.

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_mbb_player_career_stats(athlete_id, stat_type = 0L, ...)

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 MBB Athlete Career Stats (Long Format)

Get ESPN NBA Athlete Career Stats (Long Format)

Value

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

Columns as documented in the shared espn_mbb_player_career_stats_schema table.

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

Columns as documented in the shared espn_mbb_player_career_stats_schema table.

Author(s)

Saiem Gilani

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)


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

Shared column schema: espn mbb player career stats schema

Description

Columns shared verbatim across: espn_mbb_player_career_stats, espn_nba_player_career_stats.

Details

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.

Shared column schema: espn mbb player eventlog schema

Description

Columns shared verbatim across: espn_mbb_player_eventlog, espn_nba_player_eventlog.

Details

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

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.

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_mbb_player_eventlog_v2(athlete_id, season = most_recent_mbb_season(), ...)

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 MBB season.

...

Additional arguments; currently unused.

Value

A tibble with one row per event appearance.

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

Author(s)

Saiem Gilani

Examples


  espn_mbb_player_eventlog_v2(athlete_id = 4683735, season = 2025)


  espn_nba_player_eventlog_v2(athlete_id = 1966, season = 2025)

Get ESPN Women's College Basketball Athlete Info

Description

Get ESPN Women's College Basketball Athlete Info

Get ESPN NBA Athlete Info

Usage

espn_mbb_player_info(athlete_id, ...)

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

Columns as documented in the shared espn_mbb_player_info_bio_schema table.

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

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

Bio

Columns as documented in the shared espn_mbb_player_info_bio_schema table.

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

Examples


  espn_mbb_player_info(athlete_id = "4593919")


  espn_nba_player_info(athlete_id = "1966")

Shared column schema: espn mbb player info bio schema

Description

Columns shared verbatim across: espn_mbb_player_info, espn_nba_player_info.

Details

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.

Get ESPN Women's College Basketball Athlete Overview

Description

Get ESPN Women's College Basketball Athlete Overview

Get ESPN Women's College Basketball Athlete Stats

Get ESPN Women's College Basketball Athlete Gamelog

Get ESPN Women's College Basketball Athlete Splits

Get ESPN Women's College Basketball Athlete Eventlog

Get ESPN Women's College Basketball Athlete Statisticslog

Get ESPN NBA Athlete Overview

Get ESPN NBA Athlete Stats

Get ESPN NBA Athlete Gamelog

Get ESPN NBA Athlete Splits

Get ESPN NBA Athlete Eventlog

Get ESPN NBA Athlete Statisticslog

Usage

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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.

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.

Columns as documented in the shared espn_mbb_player_eventlog_schema table.

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

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

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

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.

Columns as documented in the shared espn_mbb_player_eventlog_schema table.

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

Author(s)

Saiem Gilani

Examples


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


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


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


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


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


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


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


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


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


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


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


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

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.

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

Usage

espn_mbb_player_seasons(athlete_id, ...)

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.

Columns as documented in the shared espn_mbb_player_seasons_schema table.

A tibble with one row per career season.

Columns as documented in the shared espn_mbb_player_seasons_schema table.

Author(s)

Saiem Gilani

Examples


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


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

Shared column schema: espn mbb player seasons schema

Description

Columns shared verbatim across: espn_mbb_player_seasons, espn_nba_player_seasons.

Details

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.

Get ESPN men's college basketball player stats data

Description

Get ESPN men's college basketball player stats data

Get ESPN NBA player stats data

Usage

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

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

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

Examples


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


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

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.

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_mbb_position(position_id, ...)

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

Examples


  espn_mbb_position(position_id = 1)


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

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_mbb_positions(...)

espn_nba_positions(...)

Arguments

...

Additional arguments; currently unused.

Value

A tibble with one row per position.

Author(s)

Saiem Gilani

Examples


  espn_mbb_positions()


  espn_nba_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.

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_mbb_powerindex(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

espn_nba_powerindex(
  season = most_recent_nba_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.

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

Examples


  espn_mbb_powerindex(season = 2025)


  espn_nba_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

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

Get ESPN NBA schedule for a specific year

Usage

espn_mbb_scoreboard(season)

espn_nba_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.

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.

Examples


# Get schedule from date 2022-11-17

try(espn_mbb_scoreboard(season = "20221117"))


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

try(espn_nba_scoreboard(season = 20230423))

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.

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_mbb_season_awards(season = most_recent_mbb_season(), ...)

espn_nba_season_awards(season = most_recent_nba_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"`).

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

Examples


  espn_mbb_season_awards(season = 2024)


  espn_nba_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.

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

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

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.

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

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

Usage

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

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

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

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

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

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 MBB season.

season_type

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

...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Group Detail

Get ESPN MBB Season Group Children Index

Get ESPN MBB Season Group Teams Index

Get ESPN NBA Season Group Detail

Get ESPN NBA Season Group Children Index

Get ESPN NBA Season Group Teams Index

Value

A single-row tibble.

Columns as documented in the shared espn_mbb_season_group_schema table.

A tibble with one row per child group.

Columns as documented in the shared espn_mbb_season_group_children_schema table.

A tibble with one row per team in the group.

Columns as documented in the shared espn_mbb_season_group_teams_schema table.

A single-row tibble.

Columns as documented in the shared espn_mbb_season_group_schema table.

A tibble with one row per child group.

Columns as documented in the shared espn_mbb_season_group_children_schema table.

A tibble with one row per team in the group.

Columns as documented in the shared espn_mbb_season_group_teams_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_group(group_id = 5, season = 2025)


  espn_mbb_season_group_children(group_id = 5, season = 2025)


  espn_mbb_season_group_teams(group_id = 5, season = 2025)


  espn_nba_season_group(group_id = 5, season = 2025)


  espn_nba_season_group_children(group_id = 5, season = 2025)


  espn_nba_season_group_teams(group_id = 5, season = 2025)

Shared column schema: espn mbb season group children schema

Description

Columns shared verbatim across: espn_mbb_season_group_children, espn_nba_season_group_children.

Details

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.

Shared column schema: espn mbb season group schema

Description

Columns shared verbatim across: espn_mbb_season_group, espn_nba_season_group.

Details

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.

Shared column schema: espn mbb season group teams schema

Description

Columns shared verbatim across: espn_mbb_season_group_teams, espn_nba_season_group_teams.

Details

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.

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⁠.

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_mbb_season_groups(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

espn_nba_season_groups(
  season = most_recent_nba_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.

Columns as documented in the shared espn_mbb_season_groups_schema table.

A tibble with one row per group.

Columns as documented in the shared espn_mbb_season_groups_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_groups(season = 2025)


  espn_nba_season_groups(season = 2025)

Shared column schema: espn mbb season groups schema

Description

Columns shared verbatim across: espn_mbb_season_groups, espn_nba_season_groups.

Details

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.

Get ESPN Women's College Basketball Season Info

Description

Get ESPN Women's College Basketball Season Info

Get ESPN NBA Season Info

Usage

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

espn_nba_season_info(season = most_recent_nba_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

Columns as documented in the shared espn_mbb_season_info_info_schema table.

Types / Athletes / Coaches / Teams / Awards

col_name	types	description
count	integer	Count of count.
ref	character

Info

Columns as documented in the shared espn_mbb_season_info_info_schema table.

Types / Athletes / Coaches / Teams / Awards

col_name	types	description
count	integer	Count of count.
ref	character

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_info(season = 2025)


  espn_nba_season_info(season = 2025)

Shared column schema: espn mbb season info info schema

Description

Columns shared verbatim across: espn_mbb_season_info, espn_nba_season_info.

Details

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

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".

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_mbb_season_leaders(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

espn_nba_season_leaders(
  season = most_recent_nba_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)

Get ESPN NBA Season Leaders (Long Format)

Value

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

Columns as documented in the shared espn_mbb_season_leaders_schema table.

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

Columns as documented in the shared espn_mbb_season_leaders_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_leaders(season = 2025)


  espn_nba_season_leaders(season = 2025)

Shared column schema: espn mbb season leaders schema

Description

Columns shared verbatim across: espn_mbb_season_leaders, espn_nba_season_leaders.

Details

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.

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(), ...)

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 MBB season.

...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Ranking Detail

Get ESPN NBA Season Ranking Detail

Value

A tibble with one row per weekly snapshot.

Columns as documented in the shared espn_mbb_season_ranking_schema table.

A tibble with one row per weekly snapshot.

Columns as documented in the shared espn_mbb_season_ranking_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_ranking(ranking_id = 1, season = 2025)


  espn_nba_season_ranking(ranking_id = 1, season = 2025)

Shared column schema: espn mbb season ranking schema

Description

Columns shared verbatim across: espn_mbb_season_ranking, espn_nba_season_ranking.

Details

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.

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.

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_mbb_season_rankings(season = most_recent_mbb_season(), ...)

espn_nba_season_rankings(season = most_recent_nba_season(), ...)

Arguments

season

Season year. Defaults to most recent MBB season.

...

Additional arguments; currently unused.

Details

Get ESPN MBB Season Rankings Index

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.

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

Examples


  espn_mbb_season_rankings(season = 2025)


  espn_nba_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.

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_mbb_season_type(season_type = 2L, season = most_recent_mbb_season(), ...)

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 MBB season.

...

Additional arguments; currently unused.

Details

Get ESPN MBB Season-Type Detail

Get ESPN NBA Season-Type Detail

Value

A single-row tibble.

Columns as documented in the shared espn_mbb_season_type_schema table.

A single-row tibble.

Columns as documented in the shared espn_mbb_season_type_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_type(season_type = 2, season = 2025)


  espn_nba_season_type(season_type = 2, season = 2025)

Shared column schema: espn mbb season type schema

Description

Columns shared verbatim across: espn_mbb_season_type, espn_nba_season_type.

Details

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.

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.

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_mbb_season_types(season = most_recent_mbb_season(), ...)

espn_nba_season_types(season = most_recent_nba_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.

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

Examples


  espn_mbb_season_types(season = 2025)


  espn_nba_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,
  ...
)

espn_nba_season_week(
  week,
  season = most_recent_nba_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

Get ESPN NBA Season-Week Detail

Value

A single-row tibble.

Columns as documented in the shared espn_mbb_season_week_schema table.

A single-row tibble.

Columns as documented in the shared espn_mbb_season_week_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_week(week = 5, season = 2025)


  espn_nba_season_week(week = 5, season = 2025)

Shared column schema: espn mbb season week schema

Description

Columns shared verbatim across: espn_mbb_season_week, espn_nba_season_week.

Details

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.

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

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_mbb_season_weeks(
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

espn_nba_season_weeks(
  season = most_recent_nba_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.

Columns as documented in the shared espn_mbb_season_weeks_schema table.

A tibble with one row per week.

Columns as documented in the shared espn_mbb_season_weeks_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_season_weeks(season = 2025)


  espn_nba_season_weeks(season = 2025)

Shared column schema: espn mbb season weeks schema

Description

Columns shared verbatim across: espn_mbb_season_weeks, espn_nba_season_weeks.

Details

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.

Get ESPN Women's College Basketball Seasons

Description

Get ESPN Women's College Basketball Seasons

Get ESPN NBA Seasons

Usage

espn_mbb_seasons(...)

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.

Columns as documented in the shared espn_mbb_seasons_schema table.

A single hoopR_data tibble with one row per season.

Columns as documented in the shared espn_mbb_seasons_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_seasons()


  espn_nba_seasons()

Shared column schema: espn mbb seasons schema

Description

Columns shared verbatim across: espn_mbb_seasons, espn_nba_seasons.

Details

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

Get ESPN men's college basketball standings

Description

Get ESPN men's college basketball standings

Get ESPN NBA's Standings

Usage

espn_mbb_standings(year = most_recent_mbb_season())

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.
conference	character	Conference group name from ESPN standings.
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.

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.

Examples


try(espn_mbb_standings(2021))


try(espn_nba_standings(year = 2021))

Get ESPN Women's College Basketball Team Detail

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.

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_mbb_team(team_id, season = most_recent_mbb_season(), ...)

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

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

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

espn_nba_team(team_id, season = most_recent_nba_season(), ...)

espn_nba_team_roster(team_id, season = most_recent_nba_season(), ...)

espn_nba_team_leaders(team_id, season = most_recent_nba_season(), ...)

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

Columns as documented in the shared espn_mbb_team_info_schema table.

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.

A single tibble with one row per athlete.

Columns as documented in the shared espn_mbb_team_roster_schema table.

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

Columns as documented in the shared espn_mbb_team_leaders_schema table.

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.

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

Info

Columns as documented in the shared espn_mbb_team_info_schema table.

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.

A single tibble with one row per athlete.

Columns as documented in the shared espn_mbb_team_roster_schema table.

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

Columns as documented in the shared espn_mbb_team_leaders_schema table.

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

Examples


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


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


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


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


  espn_nba_team(team_id = "13", season = 2025)


  espn_nba_team_roster(team_id = "13", season = 2025)


  espn_nba_team_leaders(team_id = "13", season = 2025)


  espn_nba_team_season_profile(team_id = "13", season = 2025)

Get ESPN men's college basketball current team roster

Description

Get ESPN men's college basketball current team roster

Get ESPN NBA current team roster

Usage

espn_mbb_team_current_roster(team_id)

espn_nba_team_current_roster(team_id)

Arguments

team_id

Either numeric or character (YYYY)

Value

A teams data frame

Author(s)

Saiem Gilani

Examples


try(espn_mbb_team_current_roster(team_id = 150))


try(espn_nba_team_current_roster(team_id = 13))

Shared column schema: espn mbb team info schema

Description

Columns shared verbatim across: espn_mbb_team, espn_nba_team.

Details

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.

Get ESPN Women's College Basketball Team Injuries

Description

Get ESPN Women's College Basketball Team Injuries

Get ESPN NBA Team Injuries

Usage

espn_mbb_team_injuries(team_id, ...)

espn_nba_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

Columns as documented in the shared espn_mbb_team_injuries_injuries_schema table.

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

Columns as documented in the shared espn_mbb_team_injuries_injuries_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_team_injuries(team_id = "150")


  espn_nba_team_injuries(team_id = "13")

Shared column schema: espn mbb team injuries injuries schema

Description

Columns shared verbatim across: espn_mbb_team_injuries, espn_nba_team_injuries.

Details

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.

Shared column schema: espn mbb team leaders schema

Description

Columns shared verbatim across: espn_mbb_team_leaders, espn_nba_team_leaders.

Details

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.

Get ESPN MBB Team News

Description

Get ESPN MBB Team News

Get ESPN Women's College Basketball Team News

Get ESPN NBA Team News

Usage

espn_mbb_team_news(team_id, limit = 25)

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

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.

Columns as documented in the shared espn_mbb_news_schema table.

Returns a tibble of team news articles.

Columns as documented in the shared espn_mbb_news_schema table.

Author(s)

Saiem Gilani

Examples


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


  espn_nba_team_news(team_id = "13", 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,
  ...
)

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

Columns as documented in the shared espn_mbb_team_odds_records_schema table.

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

Columns as documented in the shared espn_mbb_team_odds_records_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_team_odds_records(team_id = 150, season = 2026)


  espn_nba_team_odds_records(team_id = 13, season = 2026)

Shared column schema: espn mbb team odds records schema

Description

Columns shared verbatim across: espn_mbb_team_odds_records, espn_nba_team_odds_records.

Details

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.

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.

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_mbb_team_record(
  team_id,
  season = most_recent_mbb_season(),
  season_type = c(2L, 3L),
  ...
)

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

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

Examples


  espn_mbb_team_record(team_id = 150, season = 2025)


  espn_nba_team_record(team_id = 13, 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).

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_mbb_team_record_detail(team_id, season, record_id, season_type = 2L, ...)

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

Examples


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


  espn_nba_team_record_detail(team_id = 13, season = 2024, record_id = 0)

Shared column schema: espn mbb team roster schema

Description

Columns shared verbatim across: espn_mbb_team_roster, espn_nba_team_roster.

Details

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

Get ESPN Women's College Basketball Team Schedule

Description

Get ESPN Women's College Basketball Team Schedule

Get ESPN NBA Team Schedule

Usage

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

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

Columns as documented in the shared espn_mbb_team_schedule_schema table.

A single tibble with one row per event.

Columns as documented in the shared espn_mbb_team_schedule_schema table.

Author(s)

Saiem Gilani

Examples


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


  espn_nba_team_schedule(team_id = "13", season = 2025)

Shared column schema: espn mbb team schedule schema

Description

Columns shared verbatim across: espn_mbb_team_schedule, espn_nba_team_schedule.

Details

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.

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.

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_mbb_team_season_roster(team_id, season = most_recent_mbb_season(), ...)

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 MBB season.

...

Additional arguments; currently unused.

Details

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

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

Value

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

Columns as documented in the shared espn_mbb_team_season_roster_schema table.

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

Columns as documented in the shared espn_mbb_team_season_roster_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_team_season_roster(team_id = 150, season = 2025)


  espn_nba_team_season_roster(team_id = 13, season = 2025)

Shared column schema: espn mbb team season roster schema

Description

Columns shared verbatim across: espn_mbb_team_season_roster, espn_nba_team_season_roster.

Details

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.

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.

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_mbb_team_season_statistics(
  team_id,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

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

Examples


  espn_mbb_team_season_statistics(team_id = 150, season = 2024)


  espn_nba_team_season_statistics(team_id = 13, season = 2024)

Get ESPN men's college basketball team stats data

Description

Get ESPN men's college basketball team stats data

Get ESPN NBA team stats data

Usage

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

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

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

Examples


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


try(espn_nba_team_stats(team_id = 13, year = 2020))

Get ESPN men's college basketball team names and IDs

Description

Get ESPN men's college basketball team names and IDs

Get ESPN NBA team names and IDs

Usage

espn_mbb_teams(year = most_recent_mbb_season())

espn_nba_teams()

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.

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

Examples


try(espn_mbb_teams())


try(espn_nba_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()).

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_mbb_tournament(tournament_id, ...)

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.

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

Examples


  espn_mbb_tournament(tournament_id = 3)


  espn_nba_tournament(tournament_id = 1)

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.

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_mbb_tournament_season(tournament_id, season, ...)

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

Examples


  espn_mbb_tournament_season(tournament_id = 3, season = 2024)


  espn_nba_tournament_season(tournament_id = 1, season = 2024)

Get ESPN MBB Tournament Seasons List

Description

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

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

Usage

espn_mbb_tournament_seasons(tournament_id, ...)

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.
tournament_id	character	ESPN tournament identifier.
season	integer	Season year.
ref	character	Full `⁠$ref⁠` URL for that season.

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

Examples


  espn_mbb_tournament_seasons(tournament_id = 3)


  espn_nba_tournament_seasons(tournament_id = 1)

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.

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_mbb_tournaments(...)

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 (`"mens-college-basketball"`).

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

Examples


  espn_mbb_tournaments()


  espn_nba_tournaments()

Get ESPN Women's College Basketball Venues

Description

Get ESPN Women's College Basketball Venues

Get ESPN NBA Venues

Usage

espn_mbb_venues(...)

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.

Columns as documented in the shared espn_mbb_venues_schema table.

A single hoopR_data tibble with one row per venue.

Columns as documented in the shared espn_mbb_venues_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_venues()


  espn_nba_venues()

Shared column schema: espn mbb venues schema

Description

Columns shared verbatim across: espn_mbb_venues, espn_nba_venues.

Details

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

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

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_mbb_week_ranking(
  ranking_id,
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

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 MBB season.

season_type

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

...

Additional arguments; currently unused.

Details

Get ESPN MBB Per-Week Ranking Detail

Get ESPN NBA Per-Week Ranking Detail

Value

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

Columns as documented in the shared espn_mbb_week_ranking_schema table.

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

Columns as documented in the shared espn_mbb_week_ranking_schema table.

Author(s)

Saiem Gilani

Examples


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


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

Shared column schema: espn mbb week ranking schema

Description

Columns shared verbatim across: espn_mbb_week_ranking, espn_nba_week_ranking.

Details

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.

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.

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_mbb_week_rankings(
  week,
  season = most_recent_mbb_season(),
  season_type = 2L,
  ...
)

espn_nba_week_rankings(
  week,
  season = most_recent_nba_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

Get ESPN NBA Per-Week Rankings Index

Value

A tibble with one row per ranking source.

Columns as documented in the shared espn_mbb_week_rankings_schema table.

A tibble with one row per ranking source.

Columns as documented in the shared espn_mbb_week_rankings_schema table.

Author(s)

Saiem Gilani

Examples


  espn_mbb_week_rankings(week = 5, season = 2025)


  espn_nba_week_rankings(week = 5, season = 2025)

Shared column schema: espn mbb week rankings schema

Description

Columns shared verbatim across: espn_mbb_week_rankings, espn_nba_week_rankings.

Details

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.

Men's College Basketball win probability chart data from ESPN

Description

Men's College Basketball win probability chart data from ESPN

Get NBA win probability chart data from ESPN

Usage

espn_mbb_wp(game_id)

espn_nba_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.

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

Examples


espn_mbb_wp(game_id = 401256760)



espn_nba_wp(game_id = 401283399)

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

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

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

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

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

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_pick(
  season = most_recent_nba_season(),
  round = 1L,
  pick = 1L,
  ...
)

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

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

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

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

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

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

Arguments

season

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

round

Draft round (default 1).

pick

Pick number within the round (default 1).

...

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

athlete_id

ESPN draftee identifier.

Details

Get ESPN NBA Draft Pick Detail

Get ESPN NBA Draft Rounds Summary

Get ESPN NBA Draft Athletes Index

Get ESPN NBA Draft Status

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

A tibble with one row per round.

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

A single-row tibble.

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

Examples


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


  espn_nba_draft_rounds(season = 2024)


  espn_nba_draft_athletes(season = 2024)


  espn_nba_draft_status(season = 2024)


  espn_nba_season_draft(season = 2024)


  espn_nba_draft_athlete_detail(season = 2024, athlete_id = 1966)


  espn_nba_draft(season = 2024)

Get ESPN NBA Free Agents

Description

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

Examples


  espn_nba_freeagents(season = 2025)

Shared column schema: espn nba game all player schema

Description

Columns shared verbatim across: espn_nba_game_all, espn_nba_player_box, load_nba_player_box.

Details

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.

Shared column schema: espn nba game all plays schema

Description

Columns shared verbatim across: espn_nba_game_all, espn_nba_pbp.

Details

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

Shared column schema: espn nba game all team schema

Description

Columns shared verbatim across: espn_nba_game_all, espn_nba_team_box, load_nba_team_box.

Details

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.

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.

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_contracts(athlete_id, ...)

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

Arguments

athlete_id

ESPN athlete identifier (character or numeric).

...

Additional arguments; currently unused.

season

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

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"`).

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

Examples


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


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

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

Examples


  espn_nba_team_depthchart(team_id = 13, season = 2025)

Get ESPN NBA Transactions

Description

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

Examples


  espn_nba_transactions(season = 2025, limit = 10)

Get Fox Sports Basketball Boxscore

Description

Get Fox Sports Basketball Boxscore

Usage

fox_nba_boxscore(game_id)

fox_mbb_boxscore(game_id)

Arguments

game_id

Fox Bifrost event id.

Value

A hoopR_data tibble (long), one row per (player, stat): game_id, team, stat_group, player, athlete_id, stat, value.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_boxscore("106422"))

Get Fox Sports Basketball Statistical Leaders

Description

Get Fox Sports Basketball Statistical Leaders

Usage

fox_nba_league_leaders(category = "scoring", who = "player", page = 0)

fox_mbb_league_leaders(category = "scoring", who = "player", page = 0)

Arguments

category

Stat category (default "scoring").

who

"player" or "team" (default "player").

page

0-based page index (default 0).

Value

A hoopR_data tibble of leaderboard rows (entity_id + stat columns).

Author(s)

Saiem Gilani

Examples


  try(fox_nba_league_leaders("scoring"))

Get Fox Sports Basketball Game Odds

Description

Get Fox Sports Basketball Game Odds

Usage

fox_nba_odds(game_id)

fox_mbb_odds(game_id)

Arguments

game_id

Fox Bifrost event id.

Value

A hoopR_data tibble, one row per team: game_id, team, plus the six-pack odds columns (spread / to-win / total). Empty when no market.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_odds("106422"))

Get Fox Sports Basketball Play-by-Play

Description

Get Fox Sports Basketball Play-by-Play

Usage

fox_nba_pbp(game_id)

fox_mbb_pbp(game_id)

Arguments

game_id

Fox Bifrost event id (e.g. "106422").

Value

A hoopR_data tibble, one row per play: game_id, period, left_team, right_team, play_id, clock, team, left_score_change, right_score_change, play_text.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_pbp("106422"))


  try(fox_mbb_pbp("262052"))

Get Fox Sports Basketball Standings

Description

Get Fox Sports Basketball Standings

Usage

fox_nba_standings(team_id)

fox_mbb_standings(team_id)

Arguments

team_id

Fox Bifrost team id (standings of that team's conference/division).

Value

A hoopR_data tibble of standings rows (team_id, section, the standings columns, entity_id).

Author(s)

Saiem Gilani

Examples


  try(fox_nba_standings("1"))

Get Fox Sports Basketball Team Game Log

Description

Get Fox Sports Basketball Team Game Log

Usage

fox_nba_team_gamelog(team_id)

fox_mbb_team_gamelog(team_id)

Arguments

team_id

Fox Bifrost team id.

Value

A hoopR_data tibble (long): team_id, season_type, category, game_id, game_date, opponent, stat, value.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_team_gamelog("1"))

Get Fox Sports Basketball Team Roster

Description

Get Fox Sports Basketball Team Roster

Usage

fox_nba_team_roster(team_id)

fox_mbb_team_roster(team_id)

Arguments

team_id

Fox Bifrost team id (e.g. "1"). Discover via the league team directory.

Value

A hoopR_data tibble, one row per player: team_id, position_group, player, position/age/etc. columns, athlete_id.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_team_roster("1"))

Get Fox Sports Basketball Team Stat Leaders

Description

Get Fox Sports Basketball Team Stat Leaders

Usage

fox_nba_team_stats(team_id)

fox_mbb_team_stats(team_id)

Arguments

team_id

Fox Bifrost team id.

Value

A hoopR_data tibble: team_id, category, stat, stat_abbreviation, player, value.

Author(s)

Saiem Gilani

Examples


  try(fox_nba_team_stats("1"))

Get Fox Sports Basketball Team Directory

Description

Get Fox Sports Basketball Team Directory

Usage

fox_nba_teams(team_id = "1")

fox_mbb_teams(team_id = "1")

Arguments

team_id

Fox Bifrost seed team id used to fetch league standings (default "1"); the standings response enumerates every team in the seed's league sections.

Value

A hoopR_data tibble, one row per team: fox_team_id, fox_team_name, fox_section.

Examples


  try(fox_nba_teams())

Get the full Fox Sports men's college basketball team directory

Description

Enumerate every MBB team in the Fox Sports (Bifrost) directory. A single fox_mbb_teams() call only returns the seed team's conference, so this walks unseen team ids (one seed per conference) and unions the results.

Usage

fox_mbb_teams_all(max_id = 500, max_calls = 60)

Arguments

max_id

Highest Fox team id to probe as a seed (default 500).

max_calls

Safety cap on the number of standings calls (default 60).

Value

A hoopR_data tibble, one row per team: fox_team_id, fox_team_name, fox_section.

Examples


  try(fox_mbb_teams_all())

Parse ESPN MBB PBP, helper function

Description

Parse ESPN MBB PBP, helper function

Parse ESPN MBB Team Box, helper function

Parse ESPN MBB Player Box, helper function

Usage

helper_espn_mbb_pbp(resp)

helper_espn_mbb_team_box(resp)

helper_espn_mbb_player_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

Parse ESPN NBA Team Box, helper function

Parse ESPN NBA Player Box, helper function

Usage

helper_espn_nba_pbp(resp)

helper_espn_nba_team_box(resp)

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

HoopsHype Player Salaries

Description

Get NBA player salaries from HoopsHype.

Returns the full league's player salaries, one row per player per contract season (current plus future seasons HoopsHype lists). No API key is required; dollar figures are returned as numeric.

HoopsHype is a Next.js app whose single salaries page paginates client-side, but each team's salary page (⁠/salaries/{team}/⁠) embeds that team's complete roster in its ⁠__NEXT_DATA__⁠ payload. This function iterates the 30 team pages and stitches them together (~30 requests per call) using a team-by-team approach.

Usage

hoopshype_salaries()

Value

A hoopR_data tibble with one row per player-season:

col_name	types	description
player_id	character	HoopsHype player id.
player	character	Player name.
first_name	character	Player first name.
last_name	character	Player last name.
team_id	character	HoopsHype team id.
team	character	Team name.
season	integer	Contract season (4-digit ending year).
salary	numeric	Salary for the season (USD).
cap_allocation	numeric	Cap allocation for the season (USD).
team_option	logical	Whether the season is a team option.
player_option	logical	Whether the season is a player option.
two_way	logical	Whether it is a two-way contract.
qualifying_offer	logical	Whether it is a qualifying offer.

Examples


  try(hoopshype_salaries())

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 KenPom Game Box Score

Description

Get KenPom Game Box Score

Get KenPom Win Probability

Usage

kp_box(game_id, year)

kp_winprob(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

Same columns as the away_team table above.

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.

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.

Examples


try(kp_box(game_id = 6, year = 2021))


try(kp_winprob(game_id = 1238, year = 2020))

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.

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.

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.

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.

Examples


  try(kp_confstats(year=most_recent_mbb_season()))

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.

Examples


  try(kp_pomeroy_archive_ratings(date='2018-11-22'))

Get KenPom Ratings

Description

Get KenPom Ratings

Get KenPom Efficiency and Tempo Summary

Get Four Factors Data

Get Team Points Distribution

Get Heights, Experience, Bench and Continuity Data

Get 2-Foul Participation Stats

Get Team Stats

Get Player Stats Leaders by Metric

Get KPoY Leaders Tables

Usage

kp_pomeroy_ratings(min_year, max_year = most_recent_mbb_season())

kp_efficiency(min_year, max_year = most_recent_mbb_season())

kp_fourfactors(min_year, max_year = most_recent_mbb_season())

kp_pointdist(min_year, max_year = most_recent_mbb_season())

kp_height(min_year, max_year = most_recent_mbb_season())

kp_foul_trouble(min_year, max_year = most_recent_mbb_season())

kp_teamstats(min_year, max_year = most_recent_mbb_season())

kp_playerstats(
  metric = "eFG",
  conf = NULL,
  conf_only = FALSE,
  year = most_recent_mbb_season()
)

kp_kpoy(year = most_recent_mbb_season())

Arguments

min_year

First year of data to pull

max_year

Last year of data to pull

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

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

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.

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.

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.

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.

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.

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.

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.

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

Examples


try(kp_pomeroy_ratings(min_year = 2020, max_year = 2021))


try(kp_efficiency(min_year = 2020, max_year = 2021))


try(kp_fourfactors(min_year = 2020, max_year = 2021))


try(kp_pointdist(min_year = 2020, max_year = 2021))


try(kp_height(min_year = 2020, max_year = 2021))


try(kp_foul_trouble(min_year = 2020, max_year = most_recent_mbb_season()))


try(kp_teamstats(min_year = 2019, max_year = 2021))


try(kp_playerstats(metric = "eFG", conf_only = FALSE, year = 2021))


try(kp_kpoy(year = 2026))

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.

Examples


  try(kp_program_ratings())

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.

Examples

  
    try(kp_team_history(team = 'Florida St.'))

Get team schedule results

Description

Get team schedule results

Get KenPom's team game plan page

Get KenPom's team opponent tracker page

Get KenPom's player stats from the team page

Get KenPom's player career stats from the player page

Get Minutes Matrix from Expanded Player Page

Get Team Player Stats

Get Depth Chart Last 5 Games from Team Page

Get Lineups Last 5 Games from Team Page

Usage

kp_team_schedule(team, year = 2022)

kp_gameplan(team, year = 2021)

kp_opptracker(team, year = 2021)

kp_team_players(team, year = 2021)

kp_player_career(player_id)

kp_minutes_matrix(team, year = 2021)

kp_team_player_stats(team, year = 2021)

kp_team_depth_chart(team, year = 2021)

kp_team_lineups(team, year = 2021)

Arguments

team

Team filter to select.

year

Year of data to pull

player_id

Player Id filter to select.

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.

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.

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.

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.

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.

Returns a tibble of minutes matrix data

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

Same columns as the all_games table above.

A data frame with one row per rostered player, with the following columns:

col_name	types	description
team	character	Team-side label or team identifier.
year	numeric	4-digit year.
player_id	integer	KenPom player identifier.
player_name	character	Player full name.
class_year	character	Class year (e.g. 'Fr', 'So', 'Jr', 'Sr').
height	character	Height (e.g. '6-9').
weight	numeric	Weight in pounds.
pct_pg	numeric	Percentage of the player's minutes played at point guard (0-1 decimal).
pct_sg	numeric	Percentage of the player's minutes played at shooting guard (0-1 decimal).
pct_sf	numeric	Percentage of the player's minutes played at small forward (0-1 decimal).
pct_pf	numeric	Percentage of the player's minutes played at power forward (0-1 decimal).
pct_c	numeric	Percentage of the player's minutes played at center (0-1 decimal).
pct_poss	numeric	Percentage of team possessions used while the player was on the floor (0-1 decimal).
fta	integer	Season free throw attempts.
fg2a	integer	Season 2-point field goal attempts.
fg3a	integer	Season 3-point field goal attempts.

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.

Examples


  try(kp_team_schedule(team = 'Florida St.', year = 2022))


   try(kp_gameplan(team='Florida St.', year=2021))


  try(kp_opptracker(team = 'Florida St.', year = 2021))

  
    try(kp_team_players(team = 'Florida St.', year = 2024))
  

  
    try(kp_player_career(player_id = '41180'))
  

  
    try(kp_minutes_matrix(team = 'Florida St.', year = 2021))
  


  
    try(kp_team_player_stats(team = 'Florida St.', year = 2021))
  
  
    try(kp_team_depth_chart(team = 'Florida St.', year= 2021))
  


  
    try(kp_team_lineups(team = 'Florida St.', year = 2021))

Get Division-I statistical trends

Description

Get Division-I statistical trends

Get officials rankings

Get referee game log

Get Home Court Advantage Estimates

Get Home Court Arenas

Get Game Attributes

Get FanMatch by date

Usage

kp_trends()

kp_officials(year = most_recent_mbb_season())

kp_referee(referee, year)

kp_hca()

kp_arenas(year = most_recent_mbb_season())

kp_game_attrs(year = most_recent_mbb_season(), attr = "Excitement")

kp_fanmatch(date)

Arguments

year

Year of data to pull

referee

Referee ID

attr

Game Attribute, valid values include:
'Excitement', 'Tension','Dominance','MinWp','FanMatch',
'Upsets','Busts','Comeback','Window'

date

Date of games to pull (YYYY-MM-DD)

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.

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.

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.

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.

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.

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.

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.

Examples


try(kp_trends())


try(kp_officials(year = 2021))


try(kp_referee(referee = 714363, year = 2021))


try(kp_hca())


try(kp_arenas(year = 2021))


try(kp_game_attrs(year = 2021, attr = "Excitement"))


try(kp_fanmatch(date = "2022-02-22"))

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 = YOUR-EMAIL@DOMAIN.COM
KP_PW = XXX-YOUR-PASSWORD-XXX

You can save the login information for consistent usage by adding

KP_USER = YOUR-EMAIL@DOMAIN.COM
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 = "YOUR-EMAIL@DOMAIN.COM")
Sys.setenv(KP_PW = "XXX-YOUR-PASSWORD-XXX")

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

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.

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.

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.

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.

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.

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.

helper that loads multiple seasons of ESPN MBB athlete core records – identity and biographical fields, one row per athlete who appeared in the season – from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

This is the only source of athlete bio in the pipeline: the player season stats payload carries no identity at all – not even the athlete id.

Two properties of the source are worth knowing before joining:

current_team_id is the athlete's CURRENT team, not their team in the requested season. Season team lives in load_mbb_player_box() / load_mbb_player_stats().
Bio (height / weight / jersey) is a current snapshot that ESPN overwrites in place; it is not era-correct for a historical season. The season dimension here is participation, not the bio's vintage.

Field coverage is era-dependent by nature – headshots exist only for modern players, while college and date of birth thin out the other way.

Loads shot events parsed from ESPN men's college basketball play-by-play feeds. One row per shot attempt (made or missed), with court coordinates and shot metadata. Backed by the hoopR-mbb-data pipeline, publishing parquet/rds artifacts to the espn_mens_college_basketball_shots release tag. Published coverage runs 2003 and 2006 through the most recent season – 2004 and 2005 are a documented gap (no shot-coordinate assets were published for those two seasons).

Usage

load_mbb_pbp(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_team_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_player_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_schedule(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_player_stats(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_team_stats(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_standings(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_game_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_officials(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_player_core(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_shots(
  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).

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

Returns a tibble

Columns as documented in the shared espn_mbb_game_all_player_schema table.

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.

Returns a tibble of MBB team rosters.

Returns a tibble of MBB player season stats (long format).

Returns a tibble of MBB team season stats (long format).

Returns a tibble of MBB standings.

Returns a tibble of MBB per-game rosters.

Returns a tibble of MBB per-game officials.

Returns a tibble of MBB athlete core records (one row per athlete-season).

Returns a tibble with one row per shot attempt.

col_name	types	description
game_id	integer	Unique game identifier.
season	integer	Season identifier (4-digit year).
period_number	integer	Numeric period (1-2 halves).
clock_display_value	character	Game clock display string (e.g. '8:32').
team_id	integer	Unique team identifier.
athlete_id_1	integer	Primary athlete identifier (the shooter).
athlete_id_2	integer	Secondary athlete identifier (e.g. assister / fouler).
type_id	integer	Type identifier (numeric).
type_text	character	Display text for the shot/play type.
scoring_play	logical	TRUE if the play resulted in points scored.
score_value	integer	Point value of the shot (2 / 3 / 1).
coordinate_x	numeric	X coordinate on the court (half-court layout).
coordinate_y	numeric	Y coordinate on the court (half-court layout).
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.
athlete_name_1	character	Display name of the primary athlete (the shooter).
athlete_name_2	character	Display name of the secondary athlete, when present.
team_name	character	Full team display name.
team_mascot	character	Team mascot / nickname.
team_abbrev	character	Short team abbreviation.

Examples


load_mbb_pbp(seasons = most_recent_mbb_season())


load_mbb_team_box(seasons = most_recent_mbb_season())


load_mbb_player_box(seasons = most_recent_mbb_season())


load_mbb_schedule(seasons = most_recent_mbb_season())


load_mbb_shots(seasons = most_recent_mbb_season())

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

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.

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.

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.

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.

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.

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.

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.

helper that loads multiple seasons of ESPN NBA athlete core records – identity and biographical fields, one row per athlete who appeared in the season – from the sportsdataverse-data release repo, either into memory or into a database via forwarded arguments in the dots.

This is the only source of athlete bio in the pipeline: the player season stats payload carries no identity at all – not even the athlete id.

Two properties of the source are worth knowing before joining:

current_team_id is the athlete's CURRENT team, not their team in the requested season. Season team lives in load_nba_player_box() / load_nba_player_stats().
Bio (height / weight / jersey) is a current snapshot that ESPN overwrites in place; it is not era-correct for a historical season. The season dimension here is participation, not the bio's vintage.

Field coverage is era-dependent by nature – headshots exist only for modern players, while college and date of birth thin out the other way.

Loads shot events parsed from ESPN NBA play-by-play feeds. One row per shot attempt (made or missed), with court coordinates and shot metadata. Backed by the hoopR-nba-data pipeline, publishing parquet/rds artifacts to the espn_nba_shots release tag.

Usage

load_nba_pbp(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_team_box(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_player_box(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_schedule(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_standings(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_game_rosters(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_officials(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_draft(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_player_stats(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_team_stats(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_rosters(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_player_core(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_shots(
  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.

Returns a tibble

Columns as documented in the shared espn_nba_game_all_team_schema table.

Returns a tibble

Columns as documented in the shared espn_nba_game_all_player_schema table.

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

Returns a tibble of per-season NBA standings.

Returns a tibble of per-game NBA rosters.

Returns a tibble of per-game NBA officials.

Returns a tibble of NBA draft picks.

Returns a tibble of NBA player season stats (long format).

Returns a tibble of NBA team season stats (long format).

Returns a tibble of NBA team rosters.

Returns a tibble of NBA athlete core records (one row per athlete-season).

Returns a tibble with one row per shot attempt.

col_name	types	description
game_id	integer	Unique game identifier.
season	integer	Season identifier (4-digit year).
period_number	integer	Numeric period (1-4 for quarters; 5+ for OT).
clock_display_value	character	Game clock display string (e.g. '8:32').
team_id	integer	Unique team identifier.
athlete_id_1	integer	Primary athlete identifier (the shooter).
athlete_id_2	integer	Secondary athlete identifier (e.g. assister / fouler).
type_id	integer	Type identifier (numeric).
type_text	character	Display text for the shot/play type.
scoring_play	logical	TRUE if the play resulted in points scored.
score_value	integer	Point value of the shot (2 / 3 / 1).
coordinate_x	numeric	X coordinate on the court (half-court layout).
coordinate_y	numeric	Y coordinate on the court (half-court layout).
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.
athlete_name_1	character	Display name of the primary athlete (the shooter).
athlete_name_2	character	Display name of the secondary athlete, when present.
team_name	character	Full team display name.
team_mascot	character	Team mascot / nickname.
team_abbrev	character	Short team abbreviation.

Examples


load_nba_pbp(seasons = most_recent_nba_season())


load_nba_team_box(seasons = most_recent_nba_season())


load_nba_player_box(seasons = most_recent_nba_season())


load_nba_schedule(seasons = most_recent_nba_season())


load_nba_shots(seasons = most_recent_nba_season())

Load NBA player-impact ratings (RAPM / SPM / BPM / DARKO) from the data repo

Description

Loads season-level NBA player-impact ratings – one row per player-team-season, combining regularized adjusted plus-minus (RAPM), statistical plus-minus (SPM), box plus-minus (BPM), wins above replacement (WAR), and a DARKO-style skill/projection pair. Produced by the sdv-py NBA/WNBA possession-engine model program; published to the nba_player_impact release tag as csv/parquet/rds.

Loads season-level NCAA men's college basketball player-value ratings – one row per player-team-season, with a box-score-derived offensive/defensive/net box plus-minus (BPM). Coverage starts at 2006 (the earliest season with published box-score inputs of sufficient quality for the model); this tag is parquet-only, with no csv/rds sibling assets. Produced by the sdv-py NCAA MBB model program; published to the mbb_player_value release tag.

Loads season-level NCAA men's college basketball team ratings – one row per team-season, with adjusted (opponent-strength-normalized) offensive/defensive efficiency, adjusted tempo, raw efficiency, and a national rank. A KenPom-style adjusted-efficiency-margin rating. This tag is parquet-only, with no csv/rds sibling assets. Produced by the sdv-py NCAA MBB model program; published to the mbb_ratings release tag.

Usage

load_nba_player_impact(
  seasons = most_recent_nba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_player_value(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_mbb_ratings(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit season-ending years for NCAA men's college basketball. Published coverage runs 2006 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 2006)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a hoopR_data tibble with one row per player-team-season.

col_name	types	description
player_id	integer	Unique NBA Stats player identifier.
player_name	character	Player display name.
team_id	integer	Unique team identifier.
team_abbreviation	character	Team abbreviation.
team_name	character	Full team display name.
teams	character	Team abbreviation(s) the player appeared for this season.
season	integer	Season identifier (4-digit year).
season_type	character	Season portion (e.g. 'Regular Season').
o_rapm	numeric	Offensive regularized adjusted plus-minus.
d_rapm	numeric	Defensive regularized adjusted plus-minus.
rapm	numeric	Net regularized adjusted plus-minus (o_rapm + d_rapm).
off_poss	integer	Offensive possessions used in the RAPM fit.
def_poss	integer	Defensive possessions used in the RAPM fit.
o_adj_rapm	numeric	Offensive RAPM adjusted for minutes/possession stability.
d_adj_rapm	numeric	Defensive RAPM adjusted for minutes/possession stability.
adj_rapm	numeric	Net adjusted RAPM (o_adj_rapm + d_adj_rapm).
ospm	numeric	Offensive statistical plus-minus (box-score component).
dspm	numeric	Defensive statistical plus-minus (box-score component).
spm	numeric	Net statistical plus-minus.
min	numeric	Minutes played.
gp	integer	Games played.
obpm	numeric	Offensive box plus-minus.
dbpm	numeric	Defensive box plus-minus.
bpm	numeric	Net box plus-minus.
war	numeric	Wins above replacement.
darko_filtered_skill	numeric	DARKO-style filtered skill rating.
darko_projected_rating	numeric	DARKO-style forward-looking projected rating.
darko_projected_sd	numeric	Standard deviation of the DARKO-style projected rating.

Returns a hoopR_data tibble with one row per player-team-season.

col_name	types	description
player_id	character	stats.ncaa.org player identifier.
player	character	Player display name (title-cased).
season	integer	Season identifier (4-digit season-ending year).
team_id	character	Unique team identifier.
min	numeric	Minutes played.
box_obpm	numeric	Box-score offensive box plus-minus.
box_dbpm	numeric	Box-score defensive box plus-minus.
box_bpm	numeric	Box-score net box plus-minus (box_obpm + box_dbpm).

Returns a hoopR_data tibble with one row per team-season.

col_name	types	description
season	integer	Season identifier (4-digit season-ending year).
team_id	character	Unique team identifier.
adj_o	numeric	Adjusted offensive efficiency (points per 100 possessions, opponent-adjusted).
adj_d	numeric	Adjusted defensive efficiency (points allowed per 100 possessions, opponent-adjusted).
adj_em	numeric	Adjusted efficiency margin (adj_o minus adj_d).
adj_tempo	numeric	Adjusted possessions per 40 minutes.
raw_o	numeric	Unadjusted (raw) offensive efficiency.
raw_d	numeric	Unadjusted (raw) defensive efficiency.
games	integer	Games played (season total).
rank	integer	National rank by adj_em.
adj_em_z	numeric	Z-score of adj_em relative to the season's team distribution.

Author(s)

Saiem Gilani

Examples


  try(load_nba_player_impact(seasons = most_recent_nba_season()))


  try(load_mbb_player_value(seasons = most_recent_mbb_season()))


  try(load_mbb_ratings(seasons = most_recent_mbb_season()))

Load hoopR NBA Stats Coaches

Description

Loads season-level NBA coaching staff data scraped from the NBA Stats API. One row per coach-team-season triple. Backed by the hoopR-nba-stats-data pipeline that reads raw JSONs from hoopR-nba-stats-raw and publishes csv/parquet/rds artifacts to the nba_stats_coaches release tag.

Loads season-level NBA draft picks scraped from the NBA Stats API (drafthistory-style outputs). One row per pick. Backed by the hoopR-nba-stats-data pipeline that reads raw JSONs from hoopR-nba-stats-raw and publishes csv/parquet/rds artifacts to the nba_stats_draft release tag.

Loads the per-event 10-man on-court lineup (5 home + 5 away) scraped alongside the NBA Stats API play-by-play feed. One row per play-by-play action, with each player slot's NBA Stats person id. Backed by the hoopR-nba-stats-data pipeline that publishes csv.gz/parquet/rds artifacts to the nba_stats_game_lineups release tag.

Loads the per-game inactive player list scraped from the NBA Stats API – the InactivePlayers result set of boxscoresummaryv2. One row per inactive athlete-game pair, not a full per-game roster: use load_nba_stats_player_game_logs() for the athletes who did play. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_game_rosters release tag.

Loads season-level 5-man on-court lineup statistics (leaguedashlineups-style outputs, Base measure). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_lineups release tag. For Advanced/Misc/Scoring/ Opponent/⁠Four Factors⁠ measures and 2/3/4-man groupings, use load_nba_stats_leaguedash() with table = "lineups_*".

Loads game-level officials data scraped from the NBA Stats API (boxscoresummaryv2-style outputs). One row per official-game pair. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_officials release tag.

Loads season-level NBA play-by-play scraped from the NBA Stats API modern game-feed. One row per play-by-play action, with shot location, on/off-court lineup joins available via load_nba_stats_game_lineups(). Backed by the hoopR-nba-stats-data pipeline that publishes csv.gz/parquet/rds artifacts to the nba_stats_pbp release tag.

Loads per-player per-game box scores scraped from the NBA Stats API boxscoretraditionalv3-style output. One row per athlete-game pair. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_player_boxscores release tag.

Loads per-player per-game logs scraped from stats.nba.com/leaguegamelog?PlayerOrTeam=P (one row per athlete-game pair: minutes, shooting splits, rebounds, steals, blocks, turnovers, personal fouls, plus/minus). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_player_game_logs release tag.

Loads season-level NBA player statistics (leaguedashplayerstats-style outputs, Base measure). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_player_season_stats release tag. For Advanced/Misc/Scoring/Usage/Defense measures and player tracking (drives, passing, touches, speed/distance, etc.), use load_nba_stats_leaguedash() with table = "player_stats_*" or table = "player_tracking_*".

Loads possession-level data derived from the NBA Stats API play-by-play – one row per possession, with the on-court 5-man lineups for both teams, shooting/rebounding/turnover splits, and the possession start type. Backed by the hoopR-nba-stats-data pipeline that publishes csv.gz/parquet/rds artifacts to the nba_stats_possessions release tag.

Loads season-level NBA team rosters scraped from the NBA Stats API. One row per athlete-team-season triple. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_rosters release tag.

Loads season-level NBA schedules scraped from stats.nba.com/leaguegamefinder (regular season + playoffs combined, pre-rejoined home/away). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_schedules release tag.

Loads shot events scraped from the NBA Stats API. One row per shot attempt with legacy court coordinates, action/sub type, distance, and made/missed result, carried through from the play-by-play feed (not shotchartdetail). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_shots release tag.

Loads season-level NBA standings (leaguestandingsv3-style outputs). One row per team-season. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_standings release tag.

Loads per-team per-game box scores scraped from the NBA Stats API boxscoretraditionalv3-style output. One row per team-game pair. Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_team_boxscores release tag.

Loads season-level team statistics (leaguedashteamstats-style outputs, Base measure). Backed by the hoopR-nba-stats-data pipeline that publishes csv/parquet/rds artifacts to the nba_stats_team_season_stats release tag. For Advanced/Misc/Scoring/Defense/Opponent/⁠Four Factors⁠ measures, use load_nba_stats_leaguedash() with table = "team_stats_*".

Usage

load_nba_stats_coaches(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_draft(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_game_lineups(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_game_rosters(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_lineups(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_officials(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_pbp(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_player_boxscores(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_player_game_logs(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_player_season_stats(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_possessions(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_rosters(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_schedule(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_shots(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_standings(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_team_boxscores(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_nba_stats_team_season_stats(
  seasons = most_recent_nba_stats_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years – the season's START year (e.g. 2024 for the 2024-25 season), matching sdv-py's ⁠load_nba_stats_*⁠ convention (see the file-level note in R/load_nba_stats.R). Published coverage floors vary by loader (1996 for most; 2007 for load_nba_stats_lineups() – see that function's own Description) and run through the most recent season with no gaps. Pass seasons = TRUE for every published season for that specific loader.

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a hoopR_data tibble with one row per coach-team-season.

col_name	types	description
team_id	integer	Unique NBA Stats team identifier.
season	integer	Season identifier (4-digit year, END year of the season).
coach_id	integer	Unique coach identifier.
first_name	character	Coach's first name.
last_name	character	Coach's last name.
coach_name	character	Coach's full name.
is_assistant	integer	Whether the coach is an assistant coach (1) or head coach (0).
coach_type	character	Coaching role (e.g. 'Head Coach', 'Assistant Coach').
sort_sequence	integer	Display sort order within the coaching staff.
sub_sort_sequence	integer	Secondary display sort order within the coaching staff.
season_type	character	Portion of the season (e.g. 'Regular Season', 'Playoffs').

Returns a hoopR_data tibble of NBA draft picks.

col_name	types	description
person_id	integer	Unique player identifier.
player_name	character	Player's name.
season	integer	Season identifier (4-digit year, END year of the season).
round_number	integer	Draft round number.
round_pick	integer	Pick number within the round.
overall_pick	integer	Overall pick number.
draft_type	character	Draft type ('Draft', 'Undrafted', etc.).
team_id	integer	Unique NBA Stats team identifier.
team_city	character	Team city or region.
team_name	character	Full team display name.
team_abbreviation	character	Three-letter team abbreviation.
organization	character	Player's college / organization prior to the draft.
organization_type	character	Type of organization (e.g. college, international).
player_profile_flag	integer	Player profile flag.

Returns a hoopR_data tibble with one row per play-by-play action.

col_name	types	description
game_id	character	Unique game identifier.
action_number	integer	Sequential play-by-play action number within the game.
period	integer	Period of the game (1-4 quarters; 5+ for OT).
home_player_1	integer	Home on-court lineup slot 1 player identifier.
home_player_2	integer	Home on-court lineup slot 2 player identifier.
home_player_3	integer	Home on-court lineup slot 3 player identifier.
home_player_4	integer	Home on-court lineup slot 4 player identifier.
home_player_5	integer	Home on-court lineup slot 5 player identifier.
away_player_1	integer	Away on-court lineup slot 1 player identifier.
away_player_2	integer	Away on-court lineup slot 2 player identifier.
away_player_3	integer	Away on-court lineup slot 3 player identifier.
away_player_4	integer	Away on-court lineup slot 4 player identifier.
away_player_5	integer	Away on-court lineup slot 5 player identifier.
season	integer	Season identifier (4-digit year, END year of the season).

Returns a hoopR_data tibble with one row per inactive athlete-game pair.

col_name	types	description
player_id	integer	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	integer	Unique NBA Stats team identifier.
team_city	character	Team city or region.
team_name	character	Full team display name.
team_abbreviation	character	Three-letter team abbreviation.
season	integer	Season identifier (4-digit year, END year of the season).
game_id	character	Unique game identifier.

Returns a hoopR_data tibble of 5-man lineup season stats (182 columns: standard box-score rate/counting stats plus the 5 player-id slots and group_id/group_name). See names(load_nba_stats_lineups()) for the full column set, or the lineups_base table of load_nba_stats_leaguedash() for the equivalent parameter-cube asset.

Returns a hoopR_data tibble with one row per official-game pair.

col_name	types	description
official_id	integer	Unique official / referee identifier.
first_name	character	Official's first name.
last_name	character	Official's last name.
jersey_num	character	Jersey number worn by the official.
season	integer	Season identifier (4-digit year, END year of the season).
game_id	character	Unique game identifier.

Returns a hoopR_data tibble of per-event play-by-play rows.

col_name	types	description
order_index	integer	Play-by-play chronological order index within the game.
action_number	integer	Sequential play-by-play action number within the game.
clock	character	Game clock remaining in the period.
period	integer	Period of the game (1-4 quarters; 5+ for OT).
team_id	integer	Unique NBA Stats team identifier for the acting team.
team_tricode	character	Three-letter team code.
person_id	integer	Unique player identifier for the acting player.
player_name	character	Acting player's name.
player_name_i	character	Acting player's name with abbreviated first initial.
x_legacy	integer	Legacy X coordinate on the court (0 = basket center).
y_legacy	integer	Legacy Y coordinate on the court (baseline at 0).
shot_distance	integer	Shot distance from the basket, in feet (shot events only).
shot_result	character	Shot result, 'Made' or 'Missed' (shot events only).
is_field_goal	integer	Whether the action is a field goal attempt (1) or not (0).
score_home	character	Home team score after the play.
score_away	character	Away team score after the play.
points_total	integer	Points scored on the action, if any.
location	character	Court location code for the action.
description	character	Text description of the play.
action_type	character	Action type label (e.g. 'Made Shot', 'Missed Shot', 'Rebound').
sub_type	character	Sub type of the action (e.g. 'Jump Shot', 'Layup').
video_available	integer	Whether NBA Stats video is available for the action.
shot_value	integer	Points the shot was worth, 2 or 3 (shot events only).
action_id	integer	Unique play-by-play action identifier.
game_id	character	Unique game identifier.
seconds_remaining	numeric	Seconds remaining in the period at the action.
event_type	character	Normalized event type label.
is_made_shot	logical	Whether the action is a made shot.
is_missed_shot	logical	Whether the action is a missed shot.
is_free_throw	logical	Whether the action is a free throw.
is_rebound	logical	Whether the action is a rebound.
is_turnover	logical	Whether the action is a turnover.
is_foul	logical	Whether the action is a foul.
is_substitution	logical	Whether the action is a substitution.
is_jump_ball	logical	Whether the action is a jump ball.
is_timeout	logical	Whether the action is a timeout.
is_period	logical	Whether the action is a period-boundary marker.
possession_number	integer	Sequential possession number within the game.
off_player_1	integer	Offensive on-court lineup slot 1 player identifier.
off_player_2	integer	Offensive on-court lineup slot 2 player identifier.
off_player_3	integer	Offensive on-court lineup slot 3 player identifier.
off_player_4	integer	Offensive on-court lineup slot 4 player identifier.
off_player_5	integer	Offensive on-court lineup slot 5 player identifier.
def_player_1	integer	Defensive on-court lineup slot 1 player identifier.
def_player_2	integer	Defensive on-court lineup slot 2 player identifier.
def_player_3	integer	Defensive on-court lineup slot 3 player identifier.
def_player_4	integer	Defensive on-court lineup slot 4 player identifier.
def_player_5	integer	Defensive on-court lineup slot 5 player identifier.
season	integer	Season identifier (4-digit year, END year of the season).

Returns a hoopR_data tibble with one row per athlete-game pair.

col_name	types	description
team_id	integer	Unique NBA Stats team identifier.
team_name	character	Full team display name.
team_tricode	character	Three-letter team code.
side	character	Whether the team was 'home' or 'away'.
person_id	integer	Unique player identifier.
first_name	character	Player's first name.
family_name	character	Player's family (last) name.
name_i	character	Player's name with abbreviated first initial.
player_slug	character	URL-safe player name slug.
position	character	Player's roster position.
comment	character	Reason the player did not play, if applicable (e.g. 'DND - Injury').
jersey_num	character	Jersey number worn by the player.
minutes	character	Minutes played, as an `MM:SS` string.
field_goals_made	integer	Field goals made.
field_goals_attempted	integer	Field goal attempts.
field_goals_percentage	numeric	Field goal percentage (0-1).
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).
free_throws_made	integer	Free throws made.
free_throws_attempted	integer	Free throw attempts.
free_throws_percentage	numeric	Free throw percentage (0-1).
rebounds_offensive	integer	Offensive rebounds.
rebounds_defensive	integer	Defensive rebounds.
rebounds_total	integer	Total rebounds.
assists	integer	Assists.
steals	integer	Steals.
blocks	integer	Blocks.
turnovers	integer	Turnovers.
fouls_personal	integer	Personal fouls.
points	integer	Points scored.
plus_minus_points	numeric	Plus/minus point differential while on court.
game_id	character	Unique game identifier.
season	integer	Season identifier (4-digit year, END year of the season).

Returns a hoopR_data tibble of per-athlete per-game log rows.

col_name	types	description
season_id	character	Unique season identifier string.
team_id	integer	Unique NBA Stats team identifier.
team_abbreviation	character	Three-letter team abbreviation.
team_name	character	Full team display name.
game_id	character	Unique game identifier.
game_date	character	Date the game was played, as an ISO 'YYYY-MM-DD' string.
matchup	character	Matchup string, e.g. 'BOS vs. NYK' or 'BOS @ NYK'.
wl	character	Game result, 'W' or 'L'.
min	integer	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Total rebounds.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.
plus_minus	integer	Plus/minus point differential while on court.
video_available	integer	Whether NBA Stats video is available for the game.
season	integer	Season identifier (4-digit year, END year of the season).
season_type	character	Portion of the season (e.g. 'Regular Season', 'Playoffs').

Returns a hoopR_data tibble of player season stats (210 columns: rank fields, bio fields, and standard/rank box-score rate/counting stats for the season). See names(load_nba_stats_player_season_stats()) for the full column set, or the player_stats_base table of load_nba_stats_leaguedash() for the equivalent parameter-cube asset.

Returns a hoopR_data tibble with one row per possession.

col_name	types	description
game_id	character	Unique game identifier.
period	integer	Period of the game (1-4 quarters; 5+ for OT).
possession_number	integer	Sequential possession number within the game.
offense_team_id	integer	Team identifier for the team on offense.
defense_team_id	integer	Team identifier for the team on defense.
start_order_index	integer	Play-by-play order index at the start of the possession.
end_order_index	integer	Play-by-play order index at the end of the possession.
start_seconds_remaining	numeric	Seconds remaining in the period at possession start.
end_seconds_remaining	numeric	Seconds remaining in the period at possession end.
points	integer	Points scored on the possession.
is_second_chance	logical	Whether the possession followed an offensive rebound.
number_in_period	integer	Sequential possession number within the period.
possession_start_type	character	How the possession started (e.g. 'OffDeadball', 'OffRebound').
count_as_possession	logical	Whether the event counts as a scoreable possession.
fg2a	integer	2-point field goal attempts by the lineup.
fg2m	integer	2-point field goals made by the lineup.
fg3a	integer	3-point field goal attempts by the lineup.
fg3m	integer	3-point field goals made by the lineup.
fta	integer	Free throw attempts by the lineup.
ftm	integer	Free throws made by the lineup.
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
tov	integer	Turnovers.
off_player_1	integer	Offensive lineup slot 1 player identifier.
off_player_2	integer	Offensive lineup slot 2 player identifier.
off_player_3	integer	Offensive lineup slot 3 player identifier.
off_player_4	integer	Offensive lineup slot 4 player identifier.
off_player_5	integer	Offensive lineup slot 5 player identifier.
def_player_1	integer	Defensive lineup slot 1 player identifier.
def_player_2	integer	Defensive lineup slot 2 player identifier.
def_player_3	integer	Defensive lineup slot 3 player identifier.
def_player_4	integer	Defensive lineup slot 4 player identifier.
def_player_5	integer	Defensive lineup slot 5 player identifier.
lineup_source	character	Provenance of the lineup join (e.g. 'game_lineups', 'derived').
season	integer	Season identifier (4-digit year, END year of the season).

Returns a hoopR_data tibble with one row per athlete-team-season.

col_name	types	description
team_id	integer	Unique NBA Stats team identifier.
season	integer	Season identifier (4-digit year, END year of the season).
league_id	character	League identifier ('00' for NBA).
player	character	Player's full name.
nickname	character	Player's nickname.
player_slug	character	URL-safe player name slug.
num	character	Jersey number worn by the player.
position	character	Player's roster position.
height	character	Player's listed height (feet-inches).
weight	character	Player's listed weight (lbs).
birth_date	character	Player's date of birth.
age	numeric	Player's age.
exp	character	Years of NBA experience ('R' for rookie).
school	character	Player's last college / school attended.
player_id	integer	Unique player identifier.
how_acquired	character	How the player joined the roster (e.g. 'Draft', 'Trade').
supplemental_status	integer	Roster supplemental / two-way status flag.
season_type	character	Portion of the season (e.g. 'Regular Season', 'Playoffs').

Returns a hoopR_data tibble of per-season schedules, one row per game with the home/away sides pre-joined into ⁠home_*⁠ / ⁠away_*⁠ columns.

col_name	types	description
game_id	character	Unique game identifier.
season	integer	Season identifier (4-digit year, END year of the season).
season_type	character	Portion of the season (e.g. 'Regular Season', 'Playoffs').
game_date	character	Date the game was played, as an ISO 'YYYY-MM-DD' string.
matchup	character	Matchup string, home side first (e.g. 'BOS vs. NYK').
home_team_id	integer	Unique NBA Stats team identifier for the home team.
home_team_abbreviation	character	Home team abbreviation.
home_team_name	character	Home team full name.
home_pts	integer	Points scored by the home team.
home_wl	character	Home team result, 'W' or 'L'.
away_team_id	integer	Unique NBA Stats team identifier for the away team.
away_team_abbreviation	character	Away team abbreviation.
away_team_name	character	Away team full name.
away_pts	integer	Points scored by the away team.
away_wl	character	Away team result, 'W' or 'L'.

Returns a hoopR_data tibble with one row per shot attempt.

col_name	types	description
game_id	character	Unique game identifier.
season	integer	Season identifier (4-digit year, END year of the season).
period	integer	Period of the game (1-4 quarters; 5+ for OT).
clock	character	Game clock remaining in the period.
team_id	integer	Unique NBA Stats team identifier for the shooting team.
team_tricode	character	Three-letter team code (e.g. 'BOS' / 'NYK').
person_id	integer	Unique player identifier for the shooter.
player_name	character	Shooter's name.
action_type	character	Action type label ('Made Shot' or 'Missed Shot').
sub_type	character	Shot sub type (e.g. 'Jump Shot', 'Layup', 'Dunk').
shot_result	character	Shot result, 'Made' or 'Missed'.
shot_value	integer	Points the shot was worth (2 or 3).
shot_distance	integer	Shot distance from the basket, in feet.
x_legacy	integer	Legacy X coordinate on the court (0 = basket center).
y_legacy	integer	Legacy Y coordinate on the court (baseline at 0).
description	character	Text description of the play.
score_home	character	Home team score after the play.
score_away	character	Away team score after the play.

Returns a hoopR_data tibble of team standings (94 columns: win/ loss splits by home/road/conference/division/last-10, streak fields, and points-per-game aggregates). See names(load_nba_stats_standings()) for the full column set. The standings table of load_nba_stats_leaguedash() is the equivalent parameter-cube asset (same underlying leaguestandingsv3 endpoint).

Returns a hoopR_data tibble with one row per team-game pair.

col_name	types	description
team_id	integer	Unique NBA Stats team identifier.
team_name	character	Full team display name.
team_tricode	character	Three-letter team code.
side	character	Whether the team was 'home' or 'away'.
minutes	character	Total minutes played, as an `MM:SS` string.
field_goals_made	integer	Field goals made.
field_goals_attempted	integer	Field goal attempts.
field_goals_percentage	numeric	Field goal percentage (0-1).
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).
free_throws_made	integer	Free throws made.
free_throws_attempted	integer	Free throw attempts.
free_throws_percentage	numeric	Free throw percentage (0-1).
rebounds_offensive	integer	Offensive rebounds.
rebounds_defensive	integer	Defensive rebounds.
rebounds_total	integer	Total rebounds.
assists	integer	Assists.
steals	integer	Steals.
blocks	integer	Blocks.
turnovers	integer	Turnovers.
fouls_personal	integer	Personal fouls.
points	integer	Points scored.
plus_minus_points	numeric	Plus/minus point differential.
game_id	character	Unique game identifier.
season	integer	Season identifier (4-digit year, END year of the season).

Returns a hoopR_data tibble of team season stats (178 columns: rank fields plus standard/rank box-score rate/counting stats for the season). See names(load_nba_stats_team_season_stats()) for the full column set, or the team_stats_base table of load_nba_stats_leaguedash() for the equivalent parameter-cube asset.

Examples


  try(load_nba_stats_coaches(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_draft(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_game_lineups(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_game_rosters(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_lineups(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_officials(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_pbp(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_player_boxscores(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_player_game_logs(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_player_season_stats(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_possessions(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_rosters(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_schedule(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_shots(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_standings(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_team_boxscores(seasons = most_recent_nba_stats_season()))


  try(load_nba_stats_team_season_stats(seasons = most_recent_nba_stats_season()))

Load hoopR NBA Stats League Dashboard cube

Description

Loads one asset of the nba_stats_leaguedash release tag – the parameter cube that supersedes the narrower Base-measure tags (load_nba_stats_player_season_stats(), load_nba_stats_team_season_stats(), load_nba_stats_lineups(), load_nba_stats_standings()). The cube publishes 36 tables per season and is the only route to Advanced/Misc/Scoring/Usage/Defense/Opponent/⁠Four Factors⁠ measures, 2/3/4-man lineup groupings, the ⁠*_bio⁠/⁠*_master⁠ wide joins, and player tracking (drives, passing, touches, catch-and-shoot, pull-up shooting, rebounding, speed/distance).

Coverage floors differ by table and are not individually enforced here (only the global 1996 floor is): the ⁠lineups_*⁠ tables start at the 2007-08 season and the ⁠player_tracking_*⁠ tables (other than catchshoot/pullupshot, which go back to 1996) start at the 2013-14 season. Requesting an out-of-range season for those tables 404s gracefully with a warning and contributes no rows, same as any other ⁠nba_stats_*⁠ loader.

Usage

load_nba_stats_leaguedash(
  seasons = most_recent_nba_stats_season(),
  table = NULL,
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years – the season's START year (e.g. 2024 for the 2024-25 season). Published coverage runs 1996 through the most recent season for most tables (see Description for per-table floors). Pass seasons = TRUE for every published season. (Min: 1996)

table

Name of the cube table to load. One of player_bio, player_master, player_stats_base, player_stats_advanced, player_stats_misc, player_stats_scoring, player_stats_usage, player_stats_defense, player_tracking_catchshoot, player_tracking_defense, player_tracking_drives, player_tracking_efficiency, player_tracking_elbowtouch, player_tracking_painttouch, player_tracking_passing, player_tracking_possessions, player_tracking_posttouch, player_tracking_pullupshot, player_tracking_rebounding, player_tracking_speeddistance, team_master, team_stats_base, team_stats_advanced, team_stats_misc, team_stats_scoring, team_stats_defense, team_stats_opponent, team_stats_fourfactors, lineups_master, lineups_base, lineups_advanced, lineups_misc, lineups_scoring, lineups_opponent, lineups_fourfactors, standings.

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a hoopR_data tibble of the requested cube table, one row per player-season, team-season or lineup-season depending on table. Column sets differ per table (11 to 625 columns); the ⁠*_master⁠ tables are wide joins of every measure type for that entity.

Examples


  try(load_nba_stats_leaguedash(seasons = most_recent_nba_stats_season(),
                                table = "player_bio"))

Load hoopR NBA team crosswalk

Description

Loads a pre-built per-season NBA team crosswalk that maps ESPN team identifiers to NBA.com identifiers and canonical abbreviations. The files are versioned .rds snapshots stored in the nba_crosswalk release of the sportsdataverse-data repository.

Loads a pre-built per-season NBA schedule crosswalk that links ESPN game identifiers to NBA.com game identifiers. The files are versioned .rds snapshots stored in the nba_crosswalk release of the sportsdataverse-data repository.

Loads a pre-built per-season NBA player crosswalk that maps ESPN athlete identifiers to NBA.com player identifiers. The files are versioned .rds snapshots stored in the nba_crosswalk release of the sportsdataverse-data repository.

Loads a pre-built per-season MBB team crosswalk that maps ESPN team identifiers to Fox Sports (Bifrost), Bart Torvik, and KenPom identifiers and canonical abbreviations. The files are versioned .rds snapshots stored in the mbb_crosswalk release of the sportsdataverse-data repository.

Loads a pre-built per-season MBB schedule crosswalk that links ESPN game identifiers to Bart Torvik game identifiers. The files are versioned .rds snapshots stored in the mbb_crosswalk release of the sportsdataverse-data repository.

Loads a pre-built per-season MBB player crosswalk that maps ESPN athlete identifiers to Fox Sports (Bifrost) player identifiers. The files are versioned .rds snapshots stored in the mbb_crosswalk release of the sportsdataverse-data repository.

Usage

load_nba_team_crosswalk(seasons = most_recent_nba_season())

load_nba_schedule_crosswalk(seasons = most_recent_nba_season())

load_nba_player_crosswalk(seasons = most_recent_nba_season())

load_mbb_team_crosswalk(seasons = most_recent_mbb_season())

load_mbb_schedule_crosswalk(seasons = most_recent_mbb_season())

load_mbb_player_crosswalk(seasons = most_recent_mbb_season())

Arguments

seasons

A vector of 4-digit years associated with given NBA seasons. (Min: 2002; default: most_recent_nba_season())

Value

Returns a tibble of class hoopR_data with one row per NBA team per season. Columns include at minimum season, espn_team_id, and nba_team_id.

Returns a tibble of class hoopR_data with one row per NBA game per season. Columns include at minimum season, espn_game_id, and nba_game_id.

Returns a tibble of class hoopR_data with one row per NBA player per season. Columns include at minimum season, espn_athlete_id, and nba_player_id.

Returns a tibble of class hoopR_data with one row per MBB team per season. Columns include at minimum season and espn_team_id.

Returns a tibble of class hoopR_data with one row per MBB game per season. Columns include at minimum season and espn_game_id.

Returns a tibble of class hoopR_data with one row per MBB player per season. Columns include at minimum season and espn_athlete_id.

Examples


load_nba_team_crosswalk(seasons = most_recent_nba_season())


load_nba_schedule_crosswalk(seasons = most_recent_nba_season())


load_nba_player_crosswalk(seasons = most_recent_nba_season())


load_mbb_team_crosswalk(seasons = most_recent_mbb_season())


load_mbb_schedule_crosswalk(seasons = most_recent_mbb_season())


load_mbb_player_crosswalk(seasons = most_recent_mbb_season())

Load cleaned NCAA men's college basketball play-by-play from the data repo

Description

Loads season-level NCAA men's college basketball play-by-play. One row per event, with reconstructed 5-man lineups, possession numbering, shot context (transition/paint/second-chance), and an ESPN game-id crosswalk. Produced by the sdv-py ncaa_mbb engine (stats.ncaa.org play-by-play parsed, cleaned, and enriched); backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_pbp release tag as csv.gz/parquet/rds.

Loads shot-chart events for NCAA men's college basketball – one row per field goal attempt, with court coordinates, distance, shot zone, and made/missed result. Coordinates are only available from the 2019 season onward (stats.ncaa.org did not publish shot-location data before then), so seasons has a 2019 floor even though most sibling NCAA MBB datasets start at 2010. Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_shots release tag as csv.gz/parquet/rds.

Loads reconstructed 5-man lineup stints for NCAA men's college basketball – one row per contiguous stretch a specific 5-player lineup was on court for a team, with on/off scoring, shooting, and rebounding splits plus the matching opponent (⁠opp_*⁠) splits. Produced by the sdv-py ncaa_mbb engine's lineup reconstructor; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_lineups release tag as csv.gz/parquet/rds.

Loads reconstructed 10-man matchup stints (the home 5-man lineup crossed with the away 5-man lineup) for NCAA men's college basketball – one row per contiguous stretch both lineups were on court together, with the score at stint start/end and both team's lineup rosters. Produced by the sdv-py ncaa_mbb engine's lineup reconstructor; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_matchup_stints release tag as csv.gz/parquet/rds.

Loads possession-level data for NCAA men's college basketball – one row per offensive possession, with the on-court 5-man lineups for both teams, points scored, assist/transition/garbage-time flags, and the possession's first and last event types. Produced by the sdv-py ncaa_mbb engine's possession detector; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_possessions release tag as csv.gz/parquet/rds.

Loads within-team regularized adjusted plus-minus (RAPM) ratings for NCAA men's college basketball – one row per player-team-season, fit against teammate lineup variation within that team's own possessions (not a cross-team national RAPM). Produced by the sdv-py ncaa_mbb engine's RAPM model on top of the reconstructed lineup/possession data; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_rapm_within_team release tag as csv.gz/parquet/rds.

Loads league-wide regularized adjusted plus-minus (RAPM) ratings for NCAA men's college basketball – one row per player-season, fit against lineup variation across all Division I stints for that season (not a within-team RAPM). Produced by the sdv-py ncaa_mbb engine's league-wide stint-ridge RAPM solver (Torvik-gated to Division I teams) on top of the reconstructed lineup/possession data; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_rapm release tag as csv.gz/parquet/rds.

Loads advanced per-player, per-game box scores for NCAA men's college basketball – one row per player-game, with shooting splits by zone (rim/mid/3), transition and half-court splits, assisted-vs-unassisted splits, and shot-zone efficiency rates. A superset of the traditional box score (points/rebounds/assists/steals/blocks/turnovers/fouls are included alongside the advanced splits). Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_player_box release tag as csv.gz/parquet/rds.

Loads advanced per-team, per-game box scores for NCAA men's college basketball – one row per team-game, with offensive/defensive ratings, shot-zone rates and efficiency (rim/mid/3), rebounding/assist/turnover rates, and the matching opponent (⁠d_*⁠) splits. Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_team_box release tag as csv.gz/parquet/rds.

Loads a lightweight season roster for NCAA men's college basketball – one row per player-team-season with a games-played count. For the fuller roster (jersey, class, position, height, hometown, high school), use load_ncaa_mbb_team_rosters(). Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_rosters release tag as csv.gz/parquet/rds.

Loads the full season roster for NCAA men's college basketball – one row per player-team-season with jersey number, class year, position, height, hometown, high school, and games played/started. Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_team_rosters release tag as csv.gz/parquet/rds.

Loads season schedules/results for NCAA men's college basketball – one row per game with home/away teams and final scores. Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_schedule release tag as csv.gz/parquet/rds.

Loads the season-level stats.ncaa.org team-id / conference crosswalk for NCAA men's college basketball – one row per team-season. Useful for joining ncaa_team_id columns on the other ⁠ncaa_mbb_*⁠ datasets back to a team name and conference. Produced by the sdv-py ncaa_mbb engine; backed by the ncaa-mbb-hoops-data pipeline, published to the ncaa_mbb_team_ids release tag as csv.gz/parquet/rds.

Usage

load_ncaa_mbb_pbp(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_shots(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_lineups(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_matchup_stints(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_possessions(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_rapm_within_team(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_rapm(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_player_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_team_box(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_team_rosters(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_schedule(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

load_ncaa_mbb_team_ids(
  seasons = most_recent_mbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit season-ending years for NCAA men's college basketball (e.g. 2024 for the 2023-24 season). Published coverage runs 2010 through the most recent season, with no gaps. Pass seasons = TRUE for every published season. (Min: 2010)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Details

League-wide regularized adjusted plus-minus – a single ridge fit over all Division I stints per season, distinct from load_ncaa_mbb_rapm_within_team()'s within-team fit. Published coverage runs seasons 2011 through 2026.

Value

Returns a hoopR_data tibble with one row per play-by-play event.

col_name	types	description
game_date	character	Date the game was played (MM/DD/YYYY).
home	character	Home team name.
away	character	Away team name.
period	integer	Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
clock	character	Game clock remaining in the period (MM:SS).
game_time	character	Elapsed game time (MM:SS).
game_seconds	integer	Elapsed game time in seconds from tip-off.
home_score	integer	Home team score after the event.
away_score	integer	Away team score after the event.
event_team	character	Team name credited with the play event.
event_description	character	Raw play-by-play text description.
player_1	character	Primary player name involved in the event (raw, upper-cased).
player_2	character	Secondary player name involved in the event (raw, upper-cased).
event_type	character	Play event type label (e.g. 'made Layup', 'won Jumpball').
event_result	character	Event result ('made', 'missed', or NA for non-shot events).
shot_value	integer	Point value of a shot event (2 or 3).
event_length	integer	Duration of the event in seconds.
poss_num	integer	Sequential possession number within the game.
poss_team	character	Team name on offense for the possession.
poss_length	integer	Duration of the possession in seconds.
is_transition	logical	Whether the play occurred in transition.
home_1	character	Home lineup slot 1 player name (raw).
home_2	character	Home lineup slot 2 player name (raw).
home_3	character	Home lineup slot 3 player name (raw).
home_4	character	Home lineup slot 4 player name (raw).
home_5	character	Home lineup slot 5 player name (raw).
away_1	character	Away lineup slot 1 player name (raw).
away_2	character	Away lineup slot 2 player name (raw).
away_3	character	Away lineup slot 3 player name (raw).
away_4	character	Away lineup slot 4 player name (raw).
away_5	character	Away lineup slot 5 player name (raw).
status	character	Row QA status flag ('CLEAN' or a data-quality note).
is_garbage_time	logical	Whether the event occurred in garbage time.
sub_deviate	integer	Substitution-inference deviation counter used by the lineup reconstructor.
contest_id	character	Unique stats.ncaa.org contest identifier.
home_ncaa_team_id	character	stats.ncaa.org team identifier for the home team.
home_espn_team_id	character	ESPN team identifier for the home team.
away_ncaa_team_id	character	stats.ncaa.org team identifier for the away team.
away_espn_team_id	character	ESPN team identifier for the away team.
event_team_ncaa_team_id	character	stats.ncaa.org team identifier for the event team.
event_team_espn_team_id	character	ESPN team identifier for the event team.
poss_team_ncaa_team_id	character	stats.ncaa.org team identifier for the possession team.
poss_team_espn_team_id	character	ESPN team identifier for the possession team.
player_1_id	character	stats.ncaa.org player identifier for player_1.
player_1_clean_name	character	Cleaned/title-cased display name for player_1.
player_2_id	character	stats.ncaa.org player identifier for player_2.
player_2_clean_name	character	Cleaned/title-cased display name for player_2.
home_1_player_id	character	stats.ncaa.org player identifier for home lineup slot 1.
home_1_clean_name	character	Cleaned display name for home lineup slot 1.
home_2_player_id	character	stats.ncaa.org player identifier for home lineup slot 2.
home_2_clean_name	character	Cleaned display name for home lineup slot 2.
home_3_player_id	character	stats.ncaa.org player identifier for home lineup slot 3.
home_3_clean_name	character	Cleaned display name for home lineup slot 3.
home_4_player_id	character	stats.ncaa.org player identifier for home lineup slot 4.
home_4_clean_name	character	Cleaned display name for home lineup slot 4.
home_5_player_id	character	stats.ncaa.org player identifier for home lineup slot 5.
home_5_clean_name	character	Cleaned display name for home lineup slot 5.
away_1_player_id	character	stats.ncaa.org player identifier for away lineup slot 1.
away_1_clean_name	character	Cleaned display name for away lineup slot 1.
away_2_player_id	character	stats.ncaa.org player identifier for away lineup slot 2.
away_2_clean_name	character	Cleaned display name for away lineup slot 2.
away_3_player_id	character	stats.ncaa.org player identifier for away lineup slot 3.
away_3_clean_name	character	Cleaned display name for away lineup slot 3.
away_4_player_id	character	stats.ncaa.org player identifier for away lineup slot 4.
away_4_clean_name	character	Cleaned display name for away lineup slot 4.
away_5_player_id	character	stats.ncaa.org player identifier for away lineup slot 5.
away_5_clean_name	character	Cleaned display name for away lineup slot 5.
espn_game_id	character	ESPN game identifier crosswalked to this contest.
is_fastbreak	logical	Whether the play was a fastbreak possession.
is_from_turnover	logical	Whether the possession began off a turnover.
is_paint	logical	Whether the shot was taken in the paint.
is_second_chance	logical	Whether the possession followed an offensive rebound.
assist_player	character	Cleaned display name of the player credited with the assist.
ft_number	integer	Free throw number within the trip to the line (1st, 2nd, ...).
ft_attempts	integer	Total free throws awarded on the trip to the line.
foul_class	character	Foul classification ('personal', 'technical', etc.).
is_shooting_foul	logical	Whether the foul was a shooting foul.
is_looseball_foul	logical	Whether the foul was a loose-ball foul.
is_one_and_one	logical	Whether the free throw trip was a one-and-one bonus.
is_flagrant	logical	Whether the foul was flagrant.
foul_tech_class	character	Technical foul sub-classification (e.g. 'administrative').
ft_awarded	integer	Total free throws awarded for the foul.
turnover_type	character	Turnover sub-type (e.g. 'shotclock', 'travel').
is_team_turnover	logical	Whether the turnover is a team turnover (no individual credited).
timeout_type	character	Timeout sub-type (e.g. 'short', 'full').
challenge_outcome	character	Replay-challenge outcome, when the event was a review.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per shot attempt.

col_name	types	description
season	integer	Season identifier (4-digit season-ending year).
team_id	character	Team name of the shooting team (raw scrape field; despite the column name it holds the team name string, not a numeric id -- see ncaa_team_id / espn_team_id for the crosswalked ids).
shooter_id	character	Raw scrape key for the shooter (see shooter_player_id for the stats.ncaa.org id).
shot_x	numeric	Shot chart X coordinate.
shot_y	numeric	Shot chart Y coordinate.
dist_ft	numeric	Shot distance from the basket, in feet.
shot_zone	character	Shot zone label (e.g. 'abovebreak3', 'rim').
shot_type	character	Shot type label from the source play description.
made	logical	Whether the shot was made.
point_value	integer	Point value of the shot (2 or 3).
period	logical	Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
sec_left	logical	Seconds remaining in the period at the time of the shot.
source	character	Source system for the shot record (e.g. 'ncaa').
contest_id	character	Unique stats.ncaa.org contest identifier.
ncaa_team_id	character	stats.ncaa.org team identifier for the shooting team.
espn_team_id	character	ESPN team identifier for the shooting team.
shooter_player_id	character	stats.ncaa.org player identifier for the shooter.
shooter_clean_name	character	Cleaned display name for the shooter.
espn_game_id	character	ESPN game identifier crosswalked to this contest.

Returns a hoopR_data tibble with one row per lineup stint.

col_name	types	description
lineup_key	character	Hash key uniquely identifying the 5-player lineup.
date	character	Game date/time (ISO 8601).
location_type	character	Home/away designation for `team` in this stint ('Home' or 'Away').
team	character	Team name.
team_year	integer	Season-start calendar year for the stint.
opponent	character	Opponent team name.
lineup_id	character	Human-readable lineup identifier built from the five player codes.
start_min	numeric	Game-clock minute the lineup entered.
end_min	numeric	Game-clock minute the lineup exited.
duration_mins	numeric	Minutes the lineup was on court together.
player_1	character	Lineup slot 1 player display name ('Last, First').
player_2	character	Lineup slot 2 player display name ('Last, First').
player_3	character	Lineup slot 3 player display name ('Last, First').
player_4	character	Lineup slot 4 player display name ('Last, First').
player_5	character	Lineup slot 5 player display name ('Last, First').
players_in	character	Player(s) substituted into the lineup at the start of the stint.
players_out	character	Player(s) substituted out of the lineup at the start of the stint.
start_scored	integer	Team's points scored at the moment the lineup entered.
start_allowed	integer	Points allowed at the moment the lineup entered.
end_scored	integer	Team's points scored at the moment the lineup exited.
end_allowed	integer	Points allowed at the moment the lineup exited.
start_diff	integer	Score differential at the moment the lineup entered.
end_diff	integer	Score differential at the moment the lineup exited.
player_count_error	logical	Flag set when fewer/more than 5 players were reconstructed for the stint.
poss	integer	Possessions played by the lineup.
pts	integer	Points scored.
plus_minus	integer	Point differential while the lineup was on court.
fga	integer	Field goal attempts by the lineup.
fgm	integer	Field goals made by the lineup.
rima	integer	Rim-area shot attempts.
rimm	integer	Rim-area shots made.
rim_ast	integer	Rim-area makes that came off an assist.
mida	integer	Mid-range shot attempts.
midm	integer	Mid-range shots made.
mid_ast	integer	Mid-range makes that came off an assist.
fg2a	integer	2-point field goal attempts by the lineup.
fg2m	integer	2-point field goals made by the lineup.
tpa	integer	3-point field goal attempts.
tpm	integer	3-point field goals made.
tp_ast	integer	3-pointers made that came off an assist.
fta	integer	Free throw attempts by the lineup.
ftm	integer	Free throws made by the lineup.
orb	integer	Offensive rebounds.
drb	integer	Defensive rebounds.
to	integer	Turnovers by the lineup.
stl	integer	Steals.
blk	integer	Blocks.
ast	integer	Assists.
foul	integer	Personal fouls.
opp_poss	integer	Opponent possessions while this lineup was on court.
opp_pts	integer	Opponent points scored while this lineup was on court.
opp_plus_minus	integer	Opponent point differential while this lineup was on court (negative of `plus_minus`).
opp_fga	integer	Opponent field goal attempts.
opp_fgm	integer	Opponent field goals made.
opp_rima	integer	Opponent rim-area shot attempts.
opp_rimm	integer	Opponent rim-area shots made.
opp_rim_ast	integer	Opponent rim-area makes that came off an assist.
opp_mida	integer	Opponent mid-range shot attempts.
opp_midm	integer	Opponent mid-range shots made.
opp_mid_ast	integer	Opponent mid-range makes that came off an assist.
opp_fg2a	integer	Opponent 2-point field goal attempts.
opp_fg2m	integer	Opponent 2-point field goals made.
opp_tpa	integer	Opponent 3-point field goal attempts.
opp_tpm	integer	Opponent 3-point field goals made.
opp_tp_ast	integer	Opponent 3-pointers made that came off an assist.
opp_fta	integer	Opponent free throw attempts.
opp_ftm	integer	Opponent free throws made.
opp_orb	integer	Opponent offensive rebounds.
opp_drb	integer	Opponent defensive rebounds.
opp_to	integer	Opponent turnovers.
opp_stl	integer	Opponent steals.
opp_blk	integer	Opponent blocks.
opp_ast	integer	Opponent assists.
opp_foul	integer	Opponent personal fouls.
stint_num	integer	Sequential stint number for this lineup within the game.
contest_id	character	Unique stats.ncaa.org contest identifier.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per matchup stint.

col_name	types	description
contest_id	character	Unique stats.ncaa.org contest identifier.
season	integer	Season identifier (4-digit season-ending year).
game_date	character	Date the game was played (MM/DD/YYYY).
home	character	Home team name.
away	character	Away team name.
game_stint_num	integer	Sequential stint number within the game (all 10-man matchups).
period	integer	Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
start_seconds	integer	Elapsed game seconds at the start of the stint.
end_seconds	integer	Elapsed game seconds at the end of the stint.
duration_seconds	integer	Duration of the stint in seconds.
matchup_key	character	Hash key uniquely identifying the home-lineup/away-lineup matchup.
home_lineup_key	character	Hash key for the home team's 5-player lineup.
away_lineup_key	character	Hash key for the away team's 5-player lineup.
home_lineup	character	Pipe-delimited list of the 5 home players on court.
away_lineup	character	Pipe-delimited list of the 5 away players on court.
end_home_score	integer	Home team score at the end of the stint.
end_away_score	integer	Away team score at the end of the stint.
n_events	integer	Number of play-by-play events within the stint.
n_possessions	integer	Number of possessions within the stint.
start_home_score	integer	Home team score at the start of the stint.
start_away_score	integer	Away team score at the start of the stint.
home_pts	integer	Points scored by the home team during the stint.
away_pts	integer	Points scored by the away team during the stint.
home_1	character	Home lineup slot 1 player name (raw).
home_2	character	Home lineup slot 2 player name (raw).
home_3	character	Home lineup slot 3 player name (raw).
home_4	character	Home lineup slot 4 player name (raw).
home_5	character	Home lineup slot 5 player name (raw).
away_1	character	Away lineup slot 1 player name (raw).
away_2	character	Away lineup slot 2 player name (raw).
away_3	character	Away lineup slot 3 player name (raw).
away_4	character	Away lineup slot 4 player name (raw).
away_5	character	Away lineup slot 5 player name (raw).

Returns a hoopR_data tibble with one row per possession.

col_name	types	description
game_date	character	Date the game was played (MM/DD/YYYY).
home	character	Home team name.
away	character	Away team name.
period	integer	Period of the game (1-2 halves pre-2016, 1-4 quarters 2016+).
poss_num	integer	Sequential possession number within the game.
poss_team	character	Team name on offense for the possession.
home_1	character	Home lineup slot 1 player name (raw).
home_2	character	Home lineup slot 2 player name (raw).
home_3	character	Home lineup slot 3 player name (raw).
home_4	character	Home lineup slot 4 player name (raw).
home_5	character	Home lineup slot 5 player name (raw).
away_1	character	Away lineup slot 1 player name (raw).
away_2	character	Away lineup slot 2 player name (raw).
away_3	character	Away lineup slot 3 player name (raw).
away_4	character	Away lineup slot 4 player name (raw).
away_5	character	Away lineup slot 5 player name (raw).
home_score	integer	Home team score after the event.
away_score	integer	Away team score after the event.
pts	integer	Points scored.
is_assisted	integer	Whether the possession ended in an assisted make.
is_transition	integer	Whether the play occurred in transition.
is_garbage_time	integer	Whether the event occurred in garbage time.
start_event_type	character	Event type that started the possession.
first_shot_time	integer	Elapsed game seconds at the possession's first shot attempt.
first_shot_type	character	Event type of the possession's first shot attempt.
last_event_time	integer	Elapsed game seconds at the possession's final event.
last_event_type	character	Event type of the possession's final event.
contest_id	character	Unique stats.ncaa.org contest identifier.
home_ncaa_team_id	character	stats.ncaa.org team identifier for the home team.
home_espn_team_id	character	ESPN team identifier for the home team.
away_ncaa_team_id	character	stats.ncaa.org team identifier for the away team.
away_espn_team_id	character	ESPN team identifier for the away team.
poss_team_ncaa_team_id	character	stats.ncaa.org team identifier for the possession team.
poss_team_espn_team_id	character	ESPN team identifier for the possession team.
home_1_player_id	character	stats.ncaa.org player identifier for home lineup slot 1.
home_1_clean_name	character	Cleaned display name for home lineup slot 1.
home_2_player_id	character	stats.ncaa.org player identifier for home lineup slot 2.
home_2_clean_name	character	Cleaned display name for home lineup slot 2.
home_3_player_id	character	stats.ncaa.org player identifier for home lineup slot 3.
home_3_clean_name	character	Cleaned display name for home lineup slot 3.
home_4_player_id	character	stats.ncaa.org player identifier for home lineup slot 4.
home_4_clean_name	character	Cleaned display name for home lineup slot 4.
home_5_player_id	character	stats.ncaa.org player identifier for home lineup slot 5.
home_5_clean_name	character	Cleaned display name for home lineup slot 5.
away_1_player_id	character	stats.ncaa.org player identifier for away lineup slot 1.
away_1_clean_name	character	Cleaned display name for away lineup slot 1.
away_2_player_id	character	stats.ncaa.org player identifier for away lineup slot 2.
away_2_clean_name	character	Cleaned display name for away lineup slot 2.
away_3_player_id	character	stats.ncaa.org player identifier for away lineup slot 3.
away_3_clean_name	character	Cleaned display name for away lineup slot 3.
away_4_player_id	character	stats.ncaa.org player identifier for away lineup slot 4.
away_4_clean_name	character	Cleaned display name for away lineup slot 4.
away_5_player_id	character	stats.ncaa.org player identifier for away lineup slot 5.
away_5_clean_name	character	Cleaned display name for away lineup slot 5.
espn_game_id	character	ESPN game identifier crosswalked to this contest.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per player-team-season.

col_name	types	description
team	character	Team name.
player_code	character	Player display name as 'Last, First' used as the RAPM join key.
rapm_off	numeric	Within-team offensive regularized adjusted plus-minus.
rapm_def	numeric	Within-team defensive regularized adjusted plus-minus.
team_off_poss	numeric	Team offensive possessions used in the RAPM fit.
num_players	integer	Number of teammates included in the within-team RAPM fit.
rapm_net	numeric	Within-team net regularized adjusted plus-minus (rapm_off + rapm_def).
season	integer	Season identifier (4-digit season-ending year).
player_id	character	stats.ncaa.org player identifier.
team_id	character	Unique team identifier.
person_id	character	Internal person identifier used to join across seasons/teams.

Returns a hoopR_data tibble with one row per player-season.

col_name	types	description
season	integer	Season identifier (4-digit season-ending year).
player_id	character	stats.ncaa.org player identifier.
person_id	character	Internal person identifier used to join across seasons/teams.
player	character	Player display name ('LAST.FIRST' format).
team	character	Team name.
orapm	numeric	League-wide offensive regularized adjusted plus-minus.
drapm	numeric	League-wide defensive regularized adjusted plus-minus.
rapm_net	numeric	League-wide net regularized adjusted plus-minus (orapm + drapm).
off_poss	integer	Offensive possessions used in the RAPM fit.
def_poss	integer	Defensive possessions used in the RAPM fit.
estimand	character	Estimand tag for the RAPM fit (e.g. 'league' for the Division I stint solve).

Returns a hoopR_data tibble with one row per player-game.

col_name	types	description
game_date	character	Date the game was played (MM/DD/YYYY).
home	character	Home team name.
away	character	Away team name.
team	character	Team name.
player	character	Player name (raw, upper-cased).
mins	numeric	Minutes played.
o_poss	numeric	Offensive possessions played.
pts	numeric	Points scored.
orb	numeric	Offensive rebounds.
drb	numeric	Defensive rebounds.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
ts_pct	numeric	True shooting percentage.
efg_pct	numeric	Effective field goal percentage.
fgm	numeric	Field goals made by the lineup.
fga	numeric	Field goal attempts by the lineup.
fg_pct	numeric	Field goal percentage.
tpm	numeric	3-point field goals made.
tpa	numeric	3-point field goal attempts.
tp_pct	numeric	3-point field goal percentage.
ftm	numeric	Free throws made by the lineup.
fta	numeric	Free throw attempts by the lineup.
ft_pct	numeric	Free throw percentage.
rimm	numeric	Rim-area shots made.
rima	numeric	Rim-area shot attempts.
rim_pct	numeric	Rim-area field goal percentage.
midm	numeric	Mid-range shots made.
mida	numeric	Mid-range shot attempts.
mid_pct	numeric	Mid-range field goal percentage.
pbackm	numeric	Post/back-to-basket shots made.
pbacka	numeric	Post/back-to-basket attempts.
pback_pct	numeric	Post/back-to-basket shooting percentage.
blk_rim	numeric	Blocked shots at the rim.
blk_mid	numeric	Blocked mid-range shots.
blk_three	numeric	Blocked 3-point attempts.
pct_fga_trans	numeric	Share of field goal attempts taken in transition.
pct_tpa_trans	numeric	Share of 3-point attempts taken in transition.
pct_rima_trans	numeric	Share of rim-area attempts taken in transition.
pct_fgm_trans	numeric	Share of field goals made in transition.
pct_tpm_trans	numeric	Share of 3-pointers made in transition.
pct_rimm_trans	numeric	Share of rim-area shots made in transition.
pct_fgm_ast	numeric	Share of field goals made that were assisted.
pct_tpm_ast	numeric	Share of 3-pointers made that were assisted.
pct_rimm_ast	numeric	Share of rim-area shots made that were assisted.
pts_trans	numeric	Points scored in transition.
orb_trans	numeric	Offensive rebounds in transition possessions.
drb_trans	numeric	Defensive rebounds in transition possessions.
ast_trans	numeric	Assists in transition possessions.
stl_trans	numeric	Steals in transition possessions.
blk_trans	numeric	Blocks in transition possessions.
tov_trans	numeric	Turnovers in transition possessions.
ts_pct_trans	numeric	True shooting percentage in transition possessions.
efg_pct_trans	numeric	Effective field goal percentage in transition possessions.
fgm_trans	numeric	Field goals made in transition possessions.
fga_trans	numeric	Field goal attempts in transition possessions.
fg_pct_trans	numeric	Field goal percentage in transition possessions.
tpm_trans	numeric	3-point field goals made in transition possessions.
tpa_trans	numeric	3-point field goal attempts in transition possessions.
tp_pct_trans	numeric	3-point field goal percentage in transition possessions.
ftm_trans	numeric	Free throws made in transition possessions.
fta_trans	numeric	Free throw attempts in transition possessions.
ft_pct_trans	numeric	Free throw percentage in transition possessions.
rimm_trans	numeric	Rim-area shots made in transition possessions.
rima_trans	numeric	Rim-area shot attempts in transition possessions.
rim_pct_trans	numeric	Rim-area field goal percentage in transition possessions.
midm_trans	numeric	Mid-range shots made in transition possessions.
mida_trans	numeric	Mid-range shot attempts in transition possessions.
mid_pct_trans	numeric	Mid-range field goal percentage in transition possessions.
pts_half	numeric	Points scored in half-court possessions.
orb_half	numeric	Offensive rebounds in half-court possessions.
drb_half	numeric	Defensive rebounds in half-court possessions.
ast_half	numeric	Assists in half-court possessions.
stl_half	numeric	Steals in half-court possessions.
blk_half	numeric	Blocks in half-court possessions.
tov_half	numeric	Turnovers in half-court possessions.
ts_pct_half	numeric	True shooting percentage in half-court possessions.
efg_pct_half	numeric	Effective field goal percentage in half-court possessions.
fgm_half	numeric	Field goals made in half-court possessions.
fga_half	numeric	Field goal attempts in half-court possessions.
fg_pct_half	numeric	Field goal percentage in half-court possessions.
tpm_half	numeric	3-point field goals made in half-court possessions.
tpa_half	numeric	3-point field goal attempts in half-court possessions.
tp_pct_half	numeric	3-point field goal percentage in half-court possessions.
ftm_half	numeric	Free throws made in half-court possessions.
fta_half	numeric	Free throw attempts in half-court possessions.
ft_pct_half	numeric	Free throw percentage in half-court possessions.
rimm_half	numeric	Rim-area shots made in half-court possessions.
rima_half	numeric	Rim-area shot attempts in half-court possessions.
rim_pct_half	numeric	Rim-area field goal percentage in half-court possessions.
midm_half	numeric	Mid-range shots made in half-court possessions.
mida_half	numeric	Mid-range shot attempts in half-court possessions.
mid_pct_half	numeric	Mid-range field goal percentage in half-court possessions.
pts_ast	numeric	Points scored off an assisted make.
fgm_ast	numeric	Field goals made that came off an assist.
tpm_ast	numeric	3-point field goals made that came off an assist.
rimm_ast	numeric	Rim-area shots made that came off an assist.
midm_ast	numeric	Mid-range shots made that came off an assist.
pts_unast	numeric	Points scored off an unassisted make.
efg_pct_unast	numeric	Effective field goal percentage that were unassisted.
fgm_unast	numeric	Field goals made that were unassisted.
fga_unast	numeric	Field goal attempts that were unassisted.
fg_pct_unast	numeric	Field goal percentage that were unassisted.
tpm_unast	numeric	3-point field goals made that were unassisted.
tpa_unast	numeric	3-point field goal attempts that were unassisted.
tp_pct_unast	numeric	3-point field goal percentage that were unassisted.
rimm_unast	numeric	Rim-area shots made that were unassisted.
rima_unast	numeric	Rim-area shot attempts that were unassisted.
rim_pct_unast	numeric	Rim-area field goal percentage that were unassisted.
midm_unast	numeric	Mid-range shots made that were unassisted.
mida_unast	numeric	Mid-range shot attempts that were unassisted.
mid_pct_unast	numeric	Mid-range field goal percentage that were unassisted.
contest_id	character	Unique stats.ncaa.org contest identifier.
home_ncaa_team_id	character	stats.ncaa.org team identifier for the home team.
home_espn_team_id	character	ESPN team identifier for the home team.
away_ncaa_team_id	character	stats.ncaa.org team identifier for the away team.
away_espn_team_id	character	ESPN team identifier for the away team.
team_ncaa_team_id	character	stats.ncaa.org team identifier.
team_espn_team_id	character	ESPN team identifier.
player_id	character	stats.ncaa.org player identifier.
clean_name	character	Cleaned/title-cased display name.
espn_game_id	character	ESPN game identifier crosswalked to this contest.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per team-game.

col_name	types	description
home	character	Home team name.
away	character	Away team name.
team	character	Team name.
mins	numeric	Minutes played.
o_mins	numeric	Minutes with the team on offense.
d_mins	numeric	Minutes with the team on defense.
o_poss	numeric	Offensive possessions played.
d_poss	numeric	Defensive possessions played.
ortg	numeric	Offensive rating (points per 100 possessions).
drtg	numeric	Defensive rating (points allowed per 100 possessions).
netrtg	numeric	Net rating (ortg minus drtg).
pts	numeric	Points scored.
d_pts	numeric	Points allowed.
fga	numeric	Field goal attempts by the lineup.
d_fga	numeric	Opponent field goal attempts.
fgm	numeric	Field goals made by the lineup.
d_fgm	numeric	Opponent field goals made.
tpa	numeric	3-point field goal attempts.
d_tpa	numeric	Opponent 3-point attempts.
tpm	numeric	3-point field goals made.
d_tpm	numeric	Opponent 3-pointers made.
fta	numeric	Free throw attempts by the lineup.
d_fta	numeric	Opponent free throw attempts.
ftm	numeric	Free throws made by the lineup.
d_ftm	numeric	Opponent free throws made.
rima	numeric	Rim-area shot attempts.
d_rima	numeric	Opponent rim-area attempts.
rimm	numeric	Rim-area shots made.
d_rimm	numeric	Opponent rim-area shots made.
orb	numeric	Offensive rebounds.
d_orb	numeric	Opponent offensive rebounds.
drb	numeric	Defensive rebounds.
d_drb	numeric	Opponent defensive rebounds.
blk	numeric	Blocks.
d_blk	numeric	Opponent blocks.
to	numeric	Turnovers by the lineup.
d_to	numeric	Opponent turnovers.
ast	numeric	Assists.
d_ast	numeric	Opponent assists.
e_poss	numeric	Estimated possessions (alternate possession estimator).
fg_pct	numeric	Field goal percentage.
d_fg_pct	numeric	Opponent field goal percentage.
tpp	numeric	3-point field goal percentage.
d_tpp	numeric	Opponent 3-point percentage.
ftp	numeric	Free throw percentage.
d_ftp	numeric	Opponent free throw percentage.
efg_pct	numeric	Effective field goal percentage.
d_efg_pct	numeric	Opponent effective field goal percentage.
ts_pct	numeric	True shooting percentage.
d_ts_pct	numeric	Opponent true shooting percentage.
rim_pct	numeric	Rim-area field goal percentage.
d_rim_pct	numeric	Opponent rim-area field goal percentage.
mid_pct	numeric	Mid-range field goal percentage.
d_mid_pct	numeric	Opponent mid-range field goal percentage.
tp_rate	numeric	Share of shot attempts taken from 3-point range.
d_tp_rate	numeric	Opponent share of shot attempts from 3-point range.
rim_rate	numeric	Share of shot attempts taken at the rim.
d_rim_rate	numeric	Opponent share of shot attempts at the rim.
mid_rate	numeric	Share of shot attempts taken mid-range.
d_mid_rate	numeric	Opponent share of shot attempts mid-range.
ft_rate	numeric	Free throw rate (FTA per FGA).
d_ft_rate	numeric	Opponent free throw rate.
ast_rate	numeric	Assist rate.
d_ast_rate	numeric	Opponent assist rate.
to_rate	numeric	Turnover rate.
d_to_rate	numeric	Opponent turnover rate.
blk_rate	numeric	Block rate.
o_blk_rate	numeric	Offensive possessions ending in a block allowed, as a rate.
orb_pct	numeric	Offensive rebound percentage.
drb_pct	numeric	Defensive rebound percentage.
time_per_poss	numeric	Average seconds per possession.
d_time_per_poss	numeric	Opponent average seconds per possession.
contest_id	character	Unique stats.ncaa.org contest identifier.
home_ncaa_team_id	character	stats.ncaa.org team identifier for the home team.
home_espn_team_id	character	ESPN team identifier for the home team.
away_ncaa_team_id	character	stats.ncaa.org team identifier for the away team.
away_espn_team_id	character	ESPN team identifier for the away team.
team_ncaa_team_id	character	stats.ncaa.org team identifier.
team_espn_team_id	character	ESPN team identifier.
espn_game_id	character	ESPN game identifier crosswalked to this contest.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per player-team-season.

col_name	types	description
season	integer	Season identifier (4-digit season-ending year).
team	character	Team name.
player	character	Player name (raw, upper-cased).
games	integer	Games played (season total).

Returns a hoopR_data tibble with one row per player-team-season.

col_name	types	description
season	integer	Season identifier (4-digit season-ending year).
team_id	character	Unique team identifier.
team	character	Team name.
player_id	character	stats.ncaa.org player identifier.
player	character	Player name (raw, upper-cased).
clean_name	character	Cleaned/title-cased display name.
name	character	Player full display name.
jersey	character	Jersey number.
class	character	Class year (e.g. 'Fr.', 'So.', 'Jr.', 'Sr.').
position	character	Position abbreviation.
height	character	Height as a 'feet-inches' string (e.g. '6-1').
ht_inches	integer	Height in total inches.
hometown	character	Player hometown (city, state).
high_school	character	Player high school.
gp	character	Games played.
gs	character	Games started.

Returns a hoopR_data tibble with one row per game.

col_name	types	description
contest_id	character	Unique stats.ncaa.org contest identifier.
game_date	character	Date the game was played (MM/DD/YYYY).
home	character	Home team name.
away	character	Away team name.
home_score	integer	Home team score after the event.
away_score	integer	Away team score after the event.
season	integer	Season identifier (4-digit season-ending year).

Returns a hoopR_data tibble with one row per team-season.

col_name	types	description
team	character	Team name.
conference	character	Conference affiliation.
id	character	stats.ncaa.org team identifier.
season	integer	Season identifier (4-digit season-ending year).

Author(s)

Saiem Gilani

Examples


  try(load_ncaa_mbb_pbp(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_shots(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_lineups(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_matchup_stints(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_possessions(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_rapm_within_team(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_rapm(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_player_box(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_team_box(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_rosters(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_team_rosters(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_schedule(seasons = most_recent_mbb_season()))


  try(load_ncaa_mbb_team_ids(seasons = most_recent_mbb_season()))

Get the MBB cross-source player crosswalk

Description

Build a wide, one-row-per-player-per-team crosswalk linking ESPN and Fox Sports (Bifrost) MBB player identities for a season. ESPN is the anchor source; Fox is matched by normalized name (exact first, then Jaro-Winkler fuzzy with jersey tiebreaker) within each team block. Yahoo columns are NA placeholders. KenPom and Torvik have no per-player data for MBB, so neither source is joined.

Usage

mbb_player_crosswalk(season = most_recent_mbb_season(), min_confidence = 0.92)

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_mbb_season().

min_confidence

Jaro-Winkler similarity floor for fuzzy matches (default 0.92).

Value

A hoopR_data tibble, one row per player per team (ESPN-anchored):

col_name	types	description
season	integer	Season year.
espn_team_id	integer	ESPN team id (canonical key).
team_abbreviation	character	ESPN team abbreviation.
player_name	character	Normalized player name (matching key).
espn_athlete_id	character	ESPN athlete id.
espn_full_name	character	ESPN full name.
espn_jersey	character	ESPN jersey number.
espn_position	character	ESPN position abbreviation.
fox_athlete_id	character	Fox athlete id (NA if unmatched).
fox_player	character	Fox player name (NA if unmatched).
fox_jersey	character	Fox jersey number (NA if unmatched).
fox_position_group	character	Fox position group label (NA if unmatched).
yahoo_player_id	character	Yahoo player id (NA placeholder).
yahoo_player_name	character	Yahoo player name (NA placeholder).
match_method	character	"exact_name"/"fuzzy_jw"/"unmatched".
match_confidence	numeric	Jaro-Winkler score or 1 for exact (NA if none).
match_keys	character	NA (reserved for future use).

Examples


  try(mbb_player_crosswalk(season = 2025))

Get the MBB cross-source schedule crosswalk

Description

Build a wide, one-row-per-game crosswalk linking ESPN and Bart Torvik (barttorvik.com) game identifiers for an MBB season. Fox Sports and Yahoo game IDs are NA placeholders. KenPom game IDs are optionally enriched when include_kenpom = TRUE and credentials are set (see below). Dates are reduced to Eastern-Time game dates before joining; Torvik team1/team2 are unordered (the join uses a sorted team-pair key, so home/away from the Torvik side is not preserved). Games where either Torvik team name cannot be resolved to an ESPN id via mbb_team_crosswalk() are kept as bart_only rows.

KenPom (optional): KenPom requires a paid subscription. Set the environment variables KP_USER (email) and KP_PW (password) and pass include_kenpom = TRUE. When include_kenpom = FALSE (the default) or when credentials are absent, kp_game_id is left as NA and no network calls to KenPom are made. Errors from individual team schedule calls are silently dropped so the function always returns a complete crosswalk even when partial KenPom data is unavailable.

Usage

mbb_schedule_crosswalk(
  season = most_recent_mbb_season(),
  include_kenpom = FALSE
)

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_mbb_season().

include_kenpom

Logical. When TRUE AND KP_USER is set, attempts to enrich kp_game_id via per-team kp_team_schedule() calls. Default FALSE.

Value

A hoopR_data tibble, one row per game:

col_name	types	description
season	integer	Season year.
game_date	Date	ET game date.
home_espn_team_id	integer	ESPN home team id (NA for bart-only rows).
away_espn_team_id	integer	ESPN away team id (NA for bart-only rows).
espn_game_id	character	ESPN game id (NA for bart-only rows).
bart_muid	character	Torvik muid (NA for espn-only rows).
bart_team1	character	Torvik team1 name (NA for espn-only rows).
bart_team2	character	Torvik team2 name (NA for espn-only rows).
bart_winner	character	Torvik winner name (NA for espn-only rows).
kp_game_id	character	KenPom game id (NA unless kenpom enabled).
fox_game_id	character	Fox game id (NA placeholder).
yahoo_game_id	character	Yahoo game id (NA placeholder).
match_method	character	"both"/"espn_only"/"bart_only".
match_confidence	numeric	1 for matched, NA for unmatched.

Examples


  try(mbb_schedule_crosswalk(season = 2025))

Get the MBB cross-source team crosswalk

Description

Build a wide, one-row-per-team-per-season crosswalk linking ESPN, Fox Sports (Bifrost), Bart Torvik (barttorvik.com), and KenPom (hoopR::teams_links bundled data) men's college basketball team identities, keyed on espn_team_id. Yahoo columns are NA placeholders. ESPN is deduped by team_id (first occurrence kept).

Fox is joined on the full normalized mascot name (with a curated alias bridge for cases where Fox and ESPN differ). Torvik and KenPom are each joined on the normalized school/location name after a curated alias pass for common divergences (e.g. "UConn" / "Connecticut", "Ole Miss" / "Mississippi", "LIU" / "Long Island University"). No authentication is required for any source — Fox is the only network call (slow, ~60 s); Torvik is a single CSV; KenPom uses the bundled teams_links object.

Usage

mbb_team_crosswalk(season = most_recent_mbb_season(), fox = NULL)

Arguments

season

Season year (4-digit, e.g. 2025). Defaults to most_recent_mbb_season().

fox

An already-fetched fox_mbb_teams_all() frame, or NULL (default) to fetch live. Pass a pre-fetched frame to avoid the ~60-second Fox enumeration when calling repeatedly.

Value

A hoopR_data tibble, one row per ESPN team:

col_name	types	description
season	integer	Season year.
espn_team_id	integer	ESPN team id (canonical key).
espn_abbreviation	character	ESPN abbreviation.
espn_display_name	character	ESPN display name (school + mascot).
espn_short_name	character	ESPN short name.
espn_location	character	ESPN school/location only.
espn_mascot	character	ESPN mascot/nickname.
espn_conference	character	ESPN conference name.
fox_team_id	character	Fox Bifrost team id (NA if unmatched).
fox_team_name	character	Fox team name (NA if unmatched).
fox_section	character	Fox conference/section label (NA if unmatched).
bart_team	character	Torvik team name (NA if unmatched).
bart_conf	character	Torvik conference abbreviation (NA if unmatched).
kp_team	character	KenPom team name (NA if unmatched).
kp_conf	character	KenPom conference abbreviation (NA if unmatched).
yahoo_team_id	character	Yahoo team id (NA placeholder).
yahoo_team_name	character	Yahoo team name (NA placeholder).
fox_match_confidence	numeric	1 for matched, NA for unmatched.
bart_match_confidence	numeric	1 for matched, NA for unmatched.
kp_match_confidence	numeric	1 for matched, NA for unmatched.
match_method	character	Combination of matched sources, e.g.
		"fox+bart+kp" / "fox+bart" / "bart+kp" /
		"fox_only" / "bart_only" / "kp_only" /
		"espn_only".

Examples


  try(mbb_team_crosswalk(season = 2025))

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

Most Recent NBA Stats Season

Description

Returns the most recent season's START year – the seasons value the ⁠nba_stats_*⁠ release loaders expect (see load_nba_stats_coaches()), matching sdv-py's ⁠load_nba_stats_*⁠ Python loaders. It is defined as most_recent_nba_season() - 1: most_recent_nba_season() returns the current season's END year (hoopR's ESPN-family convention, used directly – with no offset – by ⁠load_nba_*()⁠), and the published ⁠nba_stats_*⁠ assets are themselves keyed by that same END year, but the ⁠nba_stats_*⁠ loaders take the season's START year and translate it internally via seasons + 1. So this helper is not a plain alias of most_recent_nba_season(); it is one less.

Usage

most_recent_nba_stats_season()

Append Advanced Metrics to a Box Score

Description

Detects the standard hoopR / stats.nba.com box-score columns present in df and appends the advanced metrics it can compute from them (true-shooting %, effective field-goal %, free-throw rate, turnover %, assist-to-turnover ratio and Hollinger game score). Columns are matched case-insensitively against common aliases; metrics whose inputs are absent are skipped (reported via a message), so it is safe to pass any box score.

Usage

nba_add_advanced_metrics(df)

Arguments

df

A data frame / tibble of player or team box-score rows.

Value

df with the available advanced-metric columns appended.

Examples

box <- data.frame(player = "A", pts = 30, fgm = 10, fga = 20,
                  fg3m = 4, ftm = 7, fta = 8, oreb = 1, dreb = 6,
                  ast = 8, stl = 2, blk = 1, pf = 2, tov = 3)
nba_add_advanced_metrics(box)

Get NBA Stats API All-time Leaders Grid

Description

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_leagueleaders() instead. Note: stat_category = "Defense" was never supported upstream by this endpoint even before deprecation (#51).

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_alltimeleadersgrids(
  league_id = "00",
  per_mode = "PerGame",
  season_type = "Regular Season",
  top_x = 10,
  ...
)

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",
  ...
)

nba_assisttracker(
  league_id = "00",
  per_mode = "PerGame",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

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",
  ...
)

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",
  ...
)

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",
  ...
)

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",
  ...
)

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",
  ...
)

nba_dunkscoreleaders(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  player_id = "",
  team_id = "",
  game_id = "",
  ...
)

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

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.

player_or_team

Player or Team

season

Season - format 2020-21

game_scope

Game Scope - Season, Last 10, ,Yesterday, Finals

player_scope

Player Scope - All Players, Rookies

stat_category

Stat Category: Points, Rebounds, Assists, Defense, Clutch, Playmaking, Efficiency, Fast Break, Scoring Breakdown

stat_type

Stat Type - Traditional, Advanced, Tracking

stat

Stat - PTS, REB, AST, FG_PCT, FT_PCT, FG3_PCT, STL, BLK

active_flag

Active Flag

scope

Scope - RS, S, Rookies

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)

Details

 nba_alltimeleadersgrids(league_id = '00')

 nba_assistleaders(league_id = '00', player_or_team = "Player")
 nba_assistleaders(league_id = '00', player_or_team = "Team")

  nba_assisttracker(league_id = '00')

 nba_homepageleaders(league_id = '00', player_or_team = "Player")
 nba_homepageleaders(league_id = '00', player_or_team = "Team")

 nba_homepagev2(league_id = '00', player_or_team = "Player")
 nba_homepagev2(league_id = '00', player_or_team = "Team")

 nba_leaderstiles(league_id = '00', player_or_team = "Player")
 nba_leaderstiles(league_id = '00', player_or_team = "Team")

(Possibly Deprecated)

 nba_defensehub(league_id = '00', player_or_team = "Player")
 nba_defensehub(league_id = '00', player_or_team = "Team")

League Leaders

 nba_leagueleaders(league_id = '00')

 nba_dunkscoreleaders(season = year_to_season(most_recent_nba_season() - 1))

 nba_gravityleaders(season = year_to_season(most_recent_nba_season() - 1))

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

Returns a named list of data frames: AssistLeaders

AssistLeaders

Columns as documented in the shared nba_assistleaders_assistleaders_schema table.

Returns a named list of data frames: AssistTracker

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

Same columns as the LeagueAverage table above.

Returns a named list of data frames: HomePageStat1, HomePageStat2, HomePageStat3, HomePageStat4, HomePageStat5, HomePageStat6, HomePageStat7, HomePageStat8

HomePageStat1

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

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

Columns as documented in the shared nba_assistleaders_assistleaders_schema table.

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.

Returns a named list of data frames: AllTimeSeasonHigh, LastSeasonHigh, LeadersTiles, LowSeasonHigh,

LeadersTiles

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

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

Columns as documented in the shared nba_homepagev2_homepagestat1_schema table.

LowSeasonHigh

Same columns as the AllTimeSeasonHigh table above.

Returns a named list of data frames: DefenseHubStat1, DefenseHubStat10, DefenseHubStat2, DefenseHubStat3, DefenseHubStat4, DefenseHubStat5, DefenseHubStat6, DefenseHubStat7, DefenseHubStat8, DefenseHubStat9

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

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.

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

Assist Percentage

Description

Estimated percentage of teammate field goals a player assisted while on the floor.

Usage

nba_assist_pct(ast, fgm, minutes, team_fgm, team_minutes)

Arguments

ast, fgm, minutes

Player totals: assists, field goals made, minutes.

team_fgm, team_minutes

Team field goals made and minutes for the same game(s).

Value

A numeric vector of assist percentages (0-100 scale).

Examples

nba_assist_pct(ast = 8, fgm = 10, minutes = 36, team_fgm = 40, team_minutes = 240)

Assist-to-Turnover Ratio

Description

Assist-to-Turnover Ratio

Usage

nba_assist_to_turnover(ast, tov)

Arguments

ast, tov

Numeric vectors: assists, turnovers.

Value

A numeric vector (NA when turnovers are 0).

Examples

nba_assist_to_turnover(ast = 8, tov = 3)

Shared column schema: nba assistleaders assistleaders schema

Description

Columns shared verbatim across: nba_assistleaders, nba_homepagev2.

Details

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.

Reduce NBA Stats API result sets

Description

Convenience helpers to munge hoopR's structure-faithful named-list result sets into a single tibble. hoopR's ⁠nba_*()⁠ wrappers return the endpoint's resultSets verbatim as a named list of tibbles (lossless, no munging); these reduce that list on demand, making explicit – and composable – the three reductions older scrapers tended to hard-code inside each task function.

Usage

nba_bind_sets(result_sets, tag_column = "set_name")

nba_join_sets(result_sets, join_key)

nba_nest_sets(result_sets, keep_cols, nest_col = ".data")

Arguments

result_sets

A named list of tibbles (an ⁠nba_*()⁠ return).

tag_column

Name of the origin column nba_bind_sets() adds (holds the set names). Defaults to "set_name".

join_key

Single shared column name nba_join_sets() joins the sets on.

keep_cols

Grouping key column(s) nba_nest_sets() keeps wide; every other column is nested.

nest_col

Name of the list-column nba_nest_sets() creates. Defaults to ".data".

Details

nba_bind_sets() row-binds the sets into one long tibble, tagging each row with its origin (tactic B). Use when the sets share a schema, or you simply want them stacked with an origin column (e.g. draft rounds, per-mode stat blocks). Columns absent from a given set fill with NA.

nba_join_sets() successively left-joins the sets into one wide tibble on a shared key (tactic C). Use when the sets are different facets of the same entity (e.g. player stats + team stats keyed on a game or player id).

nba_nest_sets() keeps keep_cols (plus the set name) wide and nests every other column into a list-column, preserving all data when no single flat schema can hold it (tactic D). Use for incompatible sets (e.g. a player profile's season totals + career totals + awards). Recover a set with tidyr::unnest().

All three accept a named list of tibbles – an ⁠nba_*()⁠ return, or the output of nba_stats_map_result_sets() – and return a single tibble.

Value

A single tbl_df (bound, joined, or nested).

Examples

sets <- list(
  PlayerStats = data.frame(GAME_ID = "1", PERSON_ID = c(1, 2), PTS = c(10, 20)),
  TeamStats   = data.frame(GAME_ID = "1", TEAM_ID = 99, PTS = 30)
)
nba_bind_sets(sets, tag_column = "set")          # B: row-bind + tag
nba_join_sets(sets, join_key = "GAME_ID")        # C: join/widen on a key
nba_nest_sets(sets, keep_cols = "GAME_ID")       # D: nest into a list-column

Shared column schema: nba boxscoresummaryv2 gamesummary schema

Description

Columns shared verbatim across: nba_boxscoresummaryv2, nba_scoreboard.

Details

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.

Shared column schema: nba boxscoresummaryv2 lastmeeting schema

Description

Columns shared verbatim across: nba_boxscoresummaryv2, nba_scoreboard, nba_scoreboardv2.

Details

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

Shared column schema: nba boxscoresummaryv2 seasonseries schema

Description

Columns shared verbatim across: nba_boxscoresummaryv2, nba_scoreboard, nba_scoreboardv2.

Details

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

Get NBA Stats API Boxscore Traditional V2

Description

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscorefourfactorsv3() instead.

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscoremiscv3() instead.

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscorescoringv3() instead.

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_boxscoreusagev3() instead.

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_boxscoretraditionalv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreadvancedv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoredefensive(game_id, ...)

nba_boxscorefourfactorsv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoremiscv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorescoringv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreusagev2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoresummaryv2(game_id, ...)

nba_boxscorematchups(game_id, ...)

nba_boxscoreplayertrackv2(game_id, ...)

nba_hustlestatsboxscore(game_id, ...)

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",
  ...
)

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

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.

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

Details

 nba_boxscoretraditionalv2(game_id = "0022200021")

League-scoped: as of a 2026-08-24 residential-IP probe sweep this V2 endpoint returns HTTP 200 with zero rows for NBA (LeagueID '00') game IDs – use nba_boxscoreadvancedv3() for NBA instead. It still serves real rows for WNBA (LeagueID '10') and G-League (LeagueID '20') game IDs, so the wrapper stays exported/active rather than deprecated.

 nba_boxscoreadvancedv2(game_id = "0022200021")

(Possibly Deprecated)

 nba_boxscoredefensive(game_id = "0022200021")

 nba_boxscorefourfactorsv2(game_id = "0022200021")

 nba_boxscoremiscv2(game_id = "0022200021")

 nba_boxscorescoringv2(game_id = "0022200021")

 nba_boxscoreusagev2(game_id = "0022200021")

 nba_boxscoresummaryv2(game_id = "0022200021")

(Possibly Deprecated)

 nba_boxscorematchups(game_id = "0022200021")

 nba_boxscoreplayertrackv2(game_id = "0022200021")

 nba_hustlestatsboxscore(game_id = "0022200021")

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

(Possibly Deprecated)

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.

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

Returns a named list of data frames: PlayerDefensiveStats, Table1

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

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

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

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

Returns a named list of data frames: AvailableVideo, GameInfo, GameSummary, InactivePlayers, LastMeeting, LineScore, Officials, OtherStats, SeasonSeries

GameSummary

Columns as documented in the shared nba_boxscoresummaryv2_gamesummary_schema table.

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

Columns as documented in the shared nba_boxscoresummaryv2_lastmeeting_schema table.

SeasonSeries

Columns as documented in the shared nba_boxscoresummaryv2_seasonseries_schema table.

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.

Returns a named list of data frames: PlayerMatchupsStats

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

Returns a named list of data frames: HustleStatsAvailable, PlayerStats, TeamStats

HustleStatsAvailable

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

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.

Returns a named list of data frames: BoxScoreSimilarityScores

Returns a named list of data frames: GLeagueAlumBoxScoreSimilarityScores

Author(s)

Saiem Gilani

Get NBA Stats API Boxscore Traditional V3

Description

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_boxscoretraditionalv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreadvancedv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoremiscv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorescoringv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreusagev3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorefourfactorsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreplayertrackv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorematchupsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorehustlev2(game_id = "0022200021", ...)

nba_boxscoredefensivev2(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_gamerotation(game_id, league_id = "00", rotation_stat = "PLAYER_PTS", ...)

nba_boxscoresummaryv3(game_id = "0022200021", ...)

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.

league_id

League ID

rotation_stat

Rotation stat to provide details on: PLAYER_PTS, PT_DIFF, USG_PCT

Details

 nba_boxscoretraditionalv3(game_id = "0022200021")

 nba_boxscoreadvancedv3(game_id = "0022200021")

 nba_boxscoremiscv3(game_id = "0022200021")

 nba_boxscorescoringv3(game_id = "0022200021")

 nba_boxscoreusagev3(game_id = "0022200021")

 nba_boxscorefourfactorsv3(game_id = "0022200021")

 nba_boxscoreplayertrackv3(game_id = "0022200021")

 nba_boxscorematchupsv3(game_id = "0022200021")

 nba_boxscorehustlev2(game_id = "0022200021")

 nba_boxscoredefensivev2(game_id = "0022200021")

 nba_gamerotation(game_id = "0022200021")

 nba_boxscoresummaryv3(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

Same columns as the home_team_player_traditional table above.

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

Same columns as the home_team_totals_traditional table above.

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

Same columns as the home_team_starters_totals table above.

home_team_bench_totals

Same columns as the home_team_starters_totals table above.

away_team_bench_totals

Same columns as the home_team_starters_totals table above.

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

Same columns as the home_team_player_advanced table above.

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

Same columns as the home_team_totals_advanced table above.

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

Same columns as the home_team_player_misc table above.

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

Same columns as the home_team_totals_misc table above.

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

Same columns as the home_team_player_scoring table above.

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

Same columns as the home_team_totals_scoring table above.

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

Same columns as the home_team_player_usage table above.

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

Same columns as the home_team_totals_usage table above.

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

Same columns as the home_team_player_four_factors table above.

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

Same columns as the home_team_totals_four_factors table above.

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

Same columns as the home_team_player_player_track table above.

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

Same columns as the home_team_totals_player_track table above.

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

Same columns as the home_team_player_matchups table above.

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

Same columns as the home_team_player_hustle table above.

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

Same columns as the home_team_totals_hustle table above.

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

Same columns as the home_team_player_defensive table above.

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

Same columns as the home_team_totals_defensive table above.

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

Same columns as the AwayTeam table above.

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

Get NBA Stats API All Players

Description

Get NBA Stats API All Players

Get NBA Stats API Player Info

Get NBA Stats API Playoff Series

Get NBA Stats API Team Roster

Get NBA Stats API Common Team Years

Usage

nba_commonallplayers(
  is_only_current_season = 0,
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

nba_commonplayerinfo(league_id = "00", player_id = "2544", ...)

nba_commonplayoffseries(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 2),
  series_id = "",
  ...
)

nba_commonteamroster(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  team_id = "1610612739",
  ...
)

nba_commonteamyears(league_id = "00", ...)

Arguments

is_only_current_season

is_only_current_season

league_id

league_id

season

season

...

Additional arguments passed to an underlying function like httr.

player_id

player_id

series_id

series_id

team_id

team_id

Details

All Players

  nba_commonallplayers(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Player Info

 nba_commonplayerinfo(league_id = '00', player_id = '2544')

 nba_commonplayoffseries(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))

Team Roster

 nba_commonteamroster(season = year_to_season(most_recent_nba_season() - 1), team_id = '1610612739')

 nba_commonteamyears(league_id = '00')

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

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.

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

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

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

Get NBA Stats API Cumulative Player Stats

Description

Get NBA Stats API Cumulative Player Stats

Get NBA Stats API Cumulative Player Game Stats

Get NBA Stats API Cumulative Team Stats

Get NBA Stats API Cumulative Team Game Stats

Usage

nba_cumestatsplayer(
  game_ids = "0022000756",
  league_id = "00",
  player_id = "1629611",
  season = "2020-21",
  season_type = "Regular Season",
  team_id = "",
  ...
)

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 = "",
  ...
)

nba_cumestatsteam(
  game_ids = "0022201094",
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

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

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.

location

location

outcome

outcome

vs_conference

vs_conference

vs_division

vs_division

vs_team_id

vs_team_id

season_id

season_id

Details

CUME Stats

 nba_cumestatsplayer()

CUME Stats

 nba_cumestatsplayergames(player_id = '2544')

CUME Stats

 nba_cumestatsteam(game_ids = '0022201094', season = '2022-23', team_id = '1610612739')

CUME Stats

 nba_cumestatsteamgames(team_id = 1610612739, season = year_to_season(most_recent_nba_season() - 1))

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

Returns a named list of data frames: CumeStatsPlayerGames

CumeStatsPlayerGames

col_name	types	description
MATCHUP	character	Matchup.
GAME_ID	character	Unique game identifier.

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

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

Get NBA Data API Play-by-Play

Description

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

Defensive Rating (points allowed per 100 possessions)

Description

Defensive Rating (points allowed per 100 possessions)

Usage

nba_defensive_rating(opp_pts, poss)

Arguments

opp_pts, poss

Numeric vectors: opponent points, possessions.

Value

A numeric vector of points allowed per 100 possessions.

Examples

nba_defensive_rating(opp_pts = 108, poss = 100)

Get NBA Stats API Draft Board

Description

Get NBA Stats API Draft Board

Get NBA Stats API Draft Combine Stats

Get NBA Stats API Draft Combine Drill Results

Get NBA Stats API Draft Combine Non-Stationary Shooting

Get NBA Stats API Draft Combine Player Anthropological Measurements

Get NBA Stats API Draft Combine - Spot Shooting

Get NBA Stats API Draft History

Usage

nba_draftboard(season = most_recent_nba_season() - 1, ...)

nba_draftcombinestats(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

nba_draftcombinedrillresults(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

nba_draftcombinenonstationaryshooting(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

nba_draftcombineplayeranthro(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

nba_draftcombinespotshooting(
  league_id = "00",
  season_year = most_recent_nba_season() - 1,
  ...
)

nba_drafthistory(
  league_id = "00",
  college = "",
  overall_pick = "",
  round_pick = "",
  round_num = "",
  season = most_recent_nba_season() - 1,
  team_id = "",
  top_x = "",
  ...
)

Arguments

season

season

...

Additional arguments passed to an underlying function like httr.

league_id

league_id

season_year

season_year

college

college

overall_pick

overall_pick

round_pick

round_pick

round_num

round_num

team_id

team_id

top_x

top_x

Details

  nba_draftboard(season = most_recent_nba_season() - 1)

 nba_draftcombinestats(season_year = most_recent_nba_season() - 1)

Draft Combine

 nba_draftcombinedrillresults(season_year = most_recent_nba_season() - 1)

Draft Combine Non-stationary Shooting

 nba_draftcombinenonstationaryshooting(season_year = most_recent_nba_season() - 1)

Draft Combine Player Anthro

 nba_draftcombineplayeranthro(season_year = most_recent_nba_season() - 1)

Draft Combine Spot Shooting

 nba_draftcombinespotshooting(season_year = most_recent_nba_season() - 1)

Draft History

 nba_drafthistory(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.

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

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

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

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

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

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

Effective Field Goal Percentage

Description

Field-goal percentage adjusted for the extra value of the three-pointer: (FGM + 0.5 * FG3M) / FGA.

Usage

nba_effective_fg_pct(fgm, fg3m, fga)

Arguments

fgm, fg3m, fga

Numeric vectors: field goals made, three-pointers made, field-goal attempts.

Value

A numeric vector of effective field-goal percentages (0-1 scale).

Examples

nba_effective_fg_pct(fgm = 10, fg3m = 4, fga = 20)

Get NBA Stats API Fantasy Widget

Description

Get NBA Stats API Fantasy Widget

Get NBA Stats API League Dashboard Lineups

Get NBA Stats API League Lineup Visual Data

Get NBA Stats API League Player On/Off Details

Get NBA Stats API League Season Matchups

Get NBA Stats API Matchups Rollup

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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",
  ...
)

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

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.

conference

conference

division

division

game_segment

game_segment

group_quantity

group_quantity

measure_type

measure_type

outcome

outcome

pace_adjust

pace_adjust

per_mode

per_mode

period

period

plus_minus

plus_minus

rank

rank

shot_clock_range

shot_clock_range

minutes_min

minutes_min

def_player_id

def_player_id

def_team_id

def_team_id

off_player_id

off_player_id

off_team_id

off_team_id

Details

 nba_fantasywidget(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Lineups Dashboard

 nba_leaguedashlineups(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Lineups Dashboard

 nba_leaguelineupviz(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

 nba_leagueplayerondetails(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Player Season Matchups

 nba_leagueseasonmatchups(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

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

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

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

Returns a named list of data frames: PlayersOnCourtLeaguePlayerDetails

PlayersOnCourtLeaguePlayerDetails

Columns as documented in the shared nba_leagueplayerondetails_playersoncourtleagueplayerdetails_schema table.

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

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

Four Factors

Description

Dean Oliver's "Four Factors" of winning basketball, as a tidy tibble (one row per input element): effective field-goal percentage, turnover percentage, offensive-rebound percentage and free-throw rate.

Usage

nba_four_factors(fgm, fg3m, fga, fta, ftm, oreb, tov, opp_dreb)

Arguments

fgm, fg3m, fga, fta, ftm, oreb, tov

Team box-score totals.

opp_dreb

Opponent defensive rebounds (for offensive-rebound percentage).

Value

A tibble with columns efg_pct, tov_pct, oreb_pct, ft_rate.

Examples

nba_four_factors(fgm = 40, fg3m = 12, fga = 88, fta = 25, ftm = 20,
                 oreb = 10, tov = 13, opp_dreb = 33)

Get NBA Stats API Franchise Leaders

Description

Get NBA Stats API Franchise Leaders

Get NBA Stats API Franchise Leaders with Rank

Get NBA Stats API Franchise Players

Get NBA Stats API Franchise History

Usage

nba_franchiseleaders(league_id = "00", team_id = "1610612739", ...)

nba_franchiseleaderswrank(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

nba_franchiseplayers(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612739",
  ...
)

nba_franchisehistory(league_id = "00", ...)

Arguments

league_id

league_id

team_id

team_id

...

Additional arguments passed to an underlying function like httr.

per_mode

per_mode

season_type

season_type

Details

Franchise Leaders

 nba_franchiseleaders(league_id = '00', team_id = '1610612739')

Franchise Players

 nba_franchiseleaderswrank(league_id = '00', team_id = '1610612739')
 nba_franchiseleaderswrank(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')

Franchise Players

 nba_franchiseplayers(league_id = '00', team_id = '1610612739')
 nba_franchiseplayers(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')

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

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

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.

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

Same columns as the FranchiseHistory table above.

Author(s)

Saiem Gilani

Free Throw Rate

Description

Free-throw attempts per field-goal attempt: FTA / FGA.

Usage

nba_ft_rate(fta, fga)

Arguments

fta, fga

Numeric vectors: free-throw attempts, field-goal attempts.

Value

A numeric vector.

Examples

nba_ft_rate(fta = 8, fga = 20)

Game Score

Description

John Hollinger's single-game player rating, roughly scaled like points (a Game Score of 40 is outstanding, 10 is an average starter).

Usage

nba_game_score(pts, fgm, fga, fta, ftm, oreb, dreb, stl, ast, blk, pf, tov)

Arguments

pts, fgm, fga, fta, ftm, oreb, dreb, stl, ast, blk, pf, tov

Numeric vectors of box-score totals.

Value

A numeric vector of game scores.

Examples

nba_game_score(pts = 30, fgm = 10, fga = 20, fta = 8, ftm = 7,
               oreb = 1, dreb = 6, stl = 2, ast = 8, blk = 1, pf = 2, tov = 3)

Shared column schema: nba homepagev2 homepagestat1 schema

Description

Columns shared verbatim across: nba_homepagev2, nba_leaderstiles.

Details

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.

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 Biographical Stats

Get NBA Stats API League Dashboard by Player Clutch Splits

Get NBA Stats API League Dashboard Player Tracking - Player Shots

Get NBA Stats API League Dashboard Player Stats

Get NBA Stats API League Dashboard Player Shot Locations

Get NBA Stats API League Dashboard Player Tracking - Defense

Get NBA Stats API League Dashboard Player Tracking - Stats

Get NBA Stats API League Dashboard Player Tracking - Team Defense

Get NBA Stats API League Dashboard by Team Clutch Splits

Get NBA Stats API League Dashboard Player Tracking - Team Shots

Get NBA Stats API League Dashboard Team Stats

Get NBA Stats API League Dashboard Team Shot Locations

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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

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.

college

college

country

country

draft_pick

draft_pick

draft_year

draft_year

game_scope

game_scope

height

height

player_experience

player_experience

player_position

player_position

starter_bench

starter_bench

weight

weight

ahead_behind

ahead_behind

clutch_time

clutch_time

point_diff

point_diff

distance_range

distance_range

two_way

two_way

defense_category

defense_category

player_id

player_id

player_or_team

player_or_team

pt_measure_type

pt_measure_type

Details

Opponent Shots - General

 nba_leaguedashoppptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Player Bio Stats

 nba_leaguedashplayerbiostats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Players Clutch Stats

 nba_leaguedashplayerclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Players Shot Dashboard

 nba_leaguedashplayerptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Players Stats

 nba_leaguedashplayerstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Players Shooting by Shot Location

 nba_leaguedashplayershotlocations(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Defensive Dashboard

 nba_leaguedashptdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Players Tracking (Second Spectrum) Stats

 nba_leaguedashptstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Team Defensive Dashboard

 nba_leaguedashptteamdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Team Clutch Stats

 nba_leaguedashteamclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Team Shot Dashboard

 nba_leaguedashteamptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

Team Stats

 nba_leaguedashteamstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

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: LeagueDashPTShots

LeagueDashPTShots

Columns as documented in the shared nba_leaguedashoppptshot_leaguedashptshots_schema table.

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

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

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

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

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

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

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

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

Returns a named list of data frames: LeagueDashTeamClutch

LeagueDashTeamClutch

Columns as documented in the shared nba_leaguedashteamclutch_leaguedashteamclutch_schema table.

Returns a named list of data frames: LeagueDashPTShots

LeagueDashPTShots

Columns as documented in the shared nba_leaguedashoppptshot_leaguedashptshots_schema table.

Returns a named list of data frames: LeagueDashTeamStats

LeagueDashTeamStats

Columns as documented in the shared nba_leaguedashteamclutch_leaguedashteamclutch_schema table.

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

Shared column schema: nba leaguedashoppptshot leaguedashptshots schema

Description

Columns shared verbatim across: nba_leaguedashoppptshot, nba_leaguedashteamptshot.

Details

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

Shared column schema: nba leaguedashteamclutch leaguedashteamclutch schema

Description

Columns shared verbatim across: nba_leaguedashteamclutch, nba_leaguedashteamstats.

Details

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

Get NBA Stats API League Game Log

Description

Get NBA Stats API League Game Log

Get NBA Stats API League Standings

Get NBA Stats API League Standings V3

Get NBA Stats API Playoff Picture

Get NBA Stats API League Game Streak Finder

Get NBA Stats API In-Season Tournament Standings

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",
  ...
)

nba_leaguestandings(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  season_year = "",
  ...
)

nba_leaguestandingsv3(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  season_year = "",
  ...
)

nba_playoffpicture(league_id = "00", season_id = "22022", ...)

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 = "",
  ...
)

nba_iststandings(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  section = "group",
  ...
)

Arguments

counter

counter

date_from

date_from

date_to

date_to

direction

direction

league_id

League - default: '00'. Other options include '10': WNBA, '20': G-League

player_or_team

player_or_team

season

Season - format: '2023-24'

season_type

season_type

sorter

sorter

...

Additional arguments passed to an underlying function like httr.

season_year

season_year

season_id

season_id

conference

conference

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

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

rookie_year

rookie_year

season_segment

season_segment

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

section

Section filter - 'group' or 'knockout'

Details

Player/Team Boxscores

 nba_leaguegamelog(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

League Standings

 nba_leaguestandings(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

League Standings

 nba_leaguestandingsv3(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

 nba_playoffpicture(league_id = '00', season_id = paste0(2, most_recent_nba_season() - 1))

 nba_leaguegamefinder(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

 nba_iststandings(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.

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

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

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

Same columns as the EastConfPlayoffPicture table above.

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

Same columns as the EastConfStandings table above.

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

Same columns as the EastConfRemainingGames table above.

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.

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

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 Leaders

Get NBA Stats API League Hustle Stats Team

Get NBA Stats API League Hustle Stats Team Leaders

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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

Player Hustle Stats

 nba_leaguehustlestatsplayer(league_id = '00')
 nba_leaguehustlestatsplayer(league_id = '00', team_id = '1610612761')

Player Hustle Stats Leaders

 nba_leaguehustlestatsplayerleaders(league_id = '00')

Team Hustle Stats

 nba_leaguehustlestatsteam(league_id = '00')

Team Hustle Stats Leaders

 nba_leaguehustlestatsteamleaders(league_id = '00')

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

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.

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

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

Same columns as the Table5 table above.

Author(s)

Saiem Gilani

Shared column schema: nba leagueplayerondetails playersoncourtleagueplayerdetails schema

Description

Columns shared verbatim across: nba_leagueplayerondetails, nba_teamplayeronoffdetails, nba_teamvsplayer.

Details

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

Shared column schema: nba live boxscore arena schema

Description

Columns shared verbatim across: nba_live_boxscore, nbagl_live_boxscore.

Details

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.

Shared column schema: nba live boxscore game details schema

Description

Columns shared verbatim across: nba_live_boxscore, nbagl_live_boxscore.

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.

Shared column schema: nba live boxscore home team boxscore schema

Description

Columns shared verbatim across: nba_live_boxscore, nbagl_live_boxscore.

Details

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

Shared column schema: nba live boxscore home team player boxscore schema

Description

Columns shared verbatim across: nba_live_boxscore, nbagl_live_boxscore.

Details

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.

Shared column schema: nba live boxscore officials schema

Description

Columns shared verbatim across: nba_live_boxscore, nbagl_live_boxscore.

Details

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.

Shared column schema: nba live pbp schema

Description

Columns shared verbatim across: nba_live_pbp, nbagl_live_pbp.

Details

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

Net Rating

Description

Net Rating

Usage

nba_net_rating(off_rating, def_rating)

Arguments

off_rating, def_rating

Numeric vectors: offensive and defensive ratings.

Value

A numeric vector (off_rating - def_rating).

Examples

nba_net_rating(off_rating = 115, def_rating = 108)

Offensive Rating (points per 100 possessions)

Description

Offensive Rating (points per 100 possessions)

Usage

nba_offensive_rating(pts, poss)

Arguments

pts, poss

Numeric vectors: points scored, possessions.

Value

A numeric vector of points per 100 possessions.

Examples

nba_offensive_rating(pts = 115, poss = 100)

Offensive Rebound Percentage

Description

Offensive Rebound Percentage

Usage

nba_oreb_pct(oreb, opp_dreb)

Arguments

oreb, opp_dreb

Numeric vectors: offensive rebounds, opponent defensive rebounds.

Value

A numeric vector (0-100 scale).

Examples

nba_oreb_pct(oreb = 10, opp_dreb = 33)

Pace (possessions per 48 minutes)

Description

Pace (possessions per 48 minutes)

Usage

nba_pace(poss, minutes)

Arguments

poss

Numeric vector of possessions (e.g. from nba_possessions()).

minutes

Numeric vector of total team minutes played (player-minutes; 240 for a regulation game).

Value

A numeric vector of pace (possessions per 48 minutes).

Examples

nba_pace(poss = 100, minutes = 240)

Shared column schema: nba pbp schema

Description

Columns shared verbatim across: nba_pbp, nba_pbps.

Details

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.

Scale Box-Score Counting Stats Per N Minutes

Description

Rescale counting stats to a per-minute basis (defaults to the familiar per-36). Adds one "{col}_per_{per}" column per requested stat; the original columns are left untouched.

Usage

nba_per_minutes(df, cols, minutes = "min", per = 36)

Arguments

df

A data frame / tibble of box-score rows.

cols

Character vector of counting-stat columns to rescale (e.g. c("pts", "reb", "ast")).

minutes

Name of the minutes column. Defaults to "min".

per

Minutes to scale to. Defaults to 36.

Value

df with the added per-minute columns.

Examples

box <- data.frame(player = c("A", "B"), min = c(36, 24),
                  pts = c(18, 8), reb = c(9, 6), ast = c(7, 2))
nba_per_minutes(box, cols = c("pts", "reb", "ast"))

Scale Box-Score Counting Stats Per N Possessions

Description

Rescale counting stats to a per-possession basis (defaults to the familiar per-100). Adds one "{col}_per_{per}" column per requested stat.

Usage

nba_per_possessions(df, cols, possessions = "poss", per = 100)

Arguments

df

A data frame / tibble of box-score rows.

cols

Character vector of counting-stat columns to rescale.

possessions

Name of the possessions column. Defaults to "poss".

per

Possessions to scale to. Defaults to 100.

Value

df with the added per-possession columns.

Examples

box <- data.frame(team = c("A", "B"), poss = c(98, 102),
                  pts = c(112, 109), tov = c(13, 11))
nba_per_possessions(box, cols = c("pts", "tov"))

Get NBA Stats API Play-by-Play V3

Description

Get NBA Stats API Play-by-Play V3

Get NBA Stats API play-by-play

Get NBA Stats API play-by-play (Multiple Games)

Get NBA Stats API Live play-by-play

Get NBA Stats API Live Boxscore

Usage

nba_playbyplayv3(game_id, start_period = 0, end_period = 0, ...)

nba_pbp(game_id, on_court = TRUE, version = "v3", p = NULL, ...)

nba_pbps(
  game_ids = NULL,
  on_court = TRUE,
  version = "v3",
  nest_data = FALSE,
  ...
)

nba_live_pbp(game_id, ...)

nba_live_boxscore(game_id, ...)

Arguments

game_id

Game ID

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.

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

game_ids

Game IDs

nest_data

If TRUE returns nested data by game

Details

 nba_playbyplayv3(game_id = "0022201086")

 nba_pbp(game_id = '0022201086')
 nba_pbp(game_id = '0022201086', version = "v2")

y <- c("0022201086", "0022200021")

nba_pbps(game_ids = y)
nba_pbps(game_ids = y, version = "v2")

 nba_live_pbp(game_id = '0022201086')

 nba_live_boxscore(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.

Returns a data frame: PlayByPlay

Columns as documented in the shared nba_pbp_schema table.

Returns a data frame: PlayByPlay

Columns as documented in the shared nba_pbp_schema table.

Returns a data frame: PlayByPlay

Columns as documented in the shared nba_live_pbp_schema table.

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

Columns as documented in the shared nba_live_boxscore_game_details_schema table.

arena

Columns as documented in the shared nba_live_boxscore_arena_schema table.

officials

Columns as documented in the shared nba_live_boxscore_officials_schema table.

home_team_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_boxscore_schema table.

away_team_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_boxscore_schema table.

home_team_player_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_player_boxscore_schema table.

away_team_player_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_player_boxscore_schema table.

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

Jason Lee

Get the NBA cross-source player crosswalk

Description

Build a wide, one-row-per-player-per-team crosswalk linking ESPN, NBA Stats, and Fox player identities. Matching is deterministic: normalized exact name within a team block, then Jaro-Winkler fuzzy with jersey/DOB tiebreakers. Yahoo columns are NA placeholders.

Usage

nba_player_crosswalk(season = most_recent_nba_season(), min_confidence = 0.92)

Arguments

season

NBA season per hoopR convention (default most_recent_nba_season()).

min_confidence

Jaro-Winkler similarity floor for fuzzy matches (default 0.92).

Value

A hoopR_data tibble, one row per player per team (ESPN-anchored).

Examples


  try(nba_player_crosswalk())

NBA Player Dictionary

Description

A tidy player dictionary (id, name, team, bio, headshot URL) sourced from the stats.nba.com player index. Handy for joining player ids to names/teams and for fetching headshots.

Usage

nba_player_dict(season = year_to_season(most_recent_nba_season() - 1), ...)

Arguments

season

Season in "YYYY-YY" form. Defaults to the most recent completed season.

...

Additional arguments passed to nba_playerindex() (e.g. proxy).

Value

A hoopR_data tibble with one row per player:

col_name	types	description
player_id	character	Player id (`PERSON_ID`).
player_name	character	Full name.
player_slug	character	URL-safe player slug.
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_name	character	Full team name.
position	character	Listed position.
jersey_number	character	Jersey number.
height	character	Listed height.
weight	character	Listed weight.
country	character	Country.
draft_year	character	Draft year.
from_year	character	First season.
to_year	character	Most recent season.
headshot_url	character	NBA CDN headshot URL.
season	character	Season (echoes the `season` argument).

Examples


  try(nba_player_dict())

NBA Player Headshot URL

Description

Build the official NBA CDN headshot URL(s) for one or more player ids. Vectorized – pass a vector of ids to get a vector of URLs.

Usage

nba_player_headshot_url(player_id, size = "1040x760")

Arguments

player_id

Player id(s) (PERSON_ID), numeric or character.

size

Image size: "1040x760" (default, large) or "260x190" (small).

Value

A character vector of headshot URLs.

Examples

nba_player_headshot_url(player_id = 201939)            # Stephen Curry
nba_player_headshot_url(c(2544, 201939), size = "260x190")

Shared column schema: nba playercareerstats seasonrankingsregularseason schema

Description

Columns shared verbatim across: nba_playercareerstats, nba_playerprofilev2.

Details

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

Shared column schema: nba playercareerstats seasontotalsregularseason schema

Description

Columns shared verbatim across: nba_playercareerstats, nba_playerprofilev2.

Details

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.

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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

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.

team_id

team_id

play_type

play_type - 'Isolation', 'Transition', 'PRBallHandler', 'PRRollman', 'Postup', 'Spotup', 'Handoff', 'Cut', 'OffScreen', 'OffRebound', 'Misc'

player_or_team

player_or_team ('P' or 'T')

type_grouping

type_grouping - Offensive, Defensive

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

Player Tracking (Second Spectrum) Stats - Passing

 nba_playerdashptpass(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Tracking (Second Spectrum) Stats - Rebounding

 nba_playerdashptreb(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Tracking (Second Spectrum) Stats - Defending

 nba_playerdashptshotdefend(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

Player Tracking (Second Spectrum) Stats - Shooting

 nba_playerdashptshots(player_id = '2544', season = year_to_season(most_recent_nba_season() - 1))

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: 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.

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.

Return a named list of data frames: NumContestedRebounding, OverallRebounding, RebDistanceRebounding, ShotDistanceRebounding, ShotTypeRebounding

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.

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.

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

Get NBA Stats API Player Index

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_playercareerbycollegerollup() instead.

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_playerprofilev2() instead.

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 = "",
  ...
)

nba_playerheadshot(player_id = "2544", ...)

nba_playerawards(player_id, ...)

nba_playercareerbycollege(
  college = "Florida State",
  league_id = "00",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_playercareerbycollegerollup(
  league_id = "00",
  per_mode = "Totals",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_playercareerstats(
  league_id = "00",
  per_mode = "Totals",
  player_id = "2544",
  ...
)

nba_infographicfanduelplayer(game_id, ...)

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",
  ...
)

nba_playerfantasyprofilebargraph(
  league_id = "00",
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_playerestimatedmetrics(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

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",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

nba_playernextngames(
  league_id = "",
  number_of_games = 2147483647,
  player_id = "2544",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

nba_playerprofilev2(
  league_id = "",
  per_mode = "Totals",
  player_id = "2544",
  ...
)

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",
  ...
)

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

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.

player_id

Player ID

per_mode

Per Mode - PerGame, Totals

game_id

game_id

measure_type

measure_type

pace_adjust

Pace Adjustment - Y/N

plus_minus

Plus Minus - Y/N

rank

Rank - Y/N

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

location

location

month

month

opponent_team_id

opponent_team_id

outcome

outcome

po_round

po_round

period

period

season_segment

season_segment

vs_conference

vs_conference

vs_division

vs_division

active_streaks_only

active_streaks_only

conference

conference

division

division

draft_team_id

draft_team_id

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

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

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

rookie_year

rookie_year

starter_bench

starter_bench

vs_team_id

vs_team_id

years_experience

years_experience

number_of_games

N in number of games

vs_player_id

vs_player_id

player_id_list

Player ID

shot_clock_range

shot_clock_range

vs_player_id_list

vs_player_id_list

Details

Player Index

 nba_playerindex()

Player Headshot

 nba_playerheadshot(player_id = '2544')

Player Awards

 nba_playerawards(player_id = '2544')

 nba_playercareerbycollege(college = 'Florida State', per_mode = 'PerGame')

 nba_playercareerbycollegerollup(per_mode = 'Totals')

Player Career Stats

 nba_playercareerstats(player_id = '2544')

 nba_infographicfanduelplayer(game_id = "0022201086")

 nba_playerfantasyprofile(player_id = '2544')

 nba_playerfantasyprofilebargraph(player_id = '2544')

Player Estimated Metrics

 nba_playerestimatedmetrics()

Player Game Log

 nba_playergamelog(player_id = '2544')

Player Game Logs

 nba_playergamelogs(player_id = '2544')

 nba_playergamestreakfinder()

 nba_playernextngames(player_id = '2544')

Player Profile

 nba_playerprofilev2(player_id = '2544')

 nba_playervsplayer(player_id = '2544', vs_player_id = '203076')

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

Returns a url of the png for the player_id selected

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

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.

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

Same columns as the East table above.

Midwest

Same columns as the East table above.

West

Same columns as the East table above.

Return a named list of data frames: CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsRegularSeason, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

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

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

CareerTotalsPostSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsAllStarSeason

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

CareerTotalsAllStarSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsShowcaseSeason

CareerTotalsShowcaseSeason

SeasonRankingsRegularSeason

Columns as documented in the shared nba_playercareerstats_seasonrankingsregularseason_schema table.

SeasonRankingsPostSeason

Columns as documented in the shared nba_playercareerstats_seasonrankingsregularseason_schema table.

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.

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

Same columns as the Overall table above.

LastNGames

Same columns as the Overall table above.

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

Same columns as the Overall table above.

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

Same columns as the SeasonAvg table above.

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

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.

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.

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

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

Return a named list of data frames: CareerHighs, CareerTotalsAllStarSeason, CareerTotalsCollegeSeason, CareerTotalsPostSeason, CareerTotalsPreseason, CareerTotalsRegularSeason, NextGame, SeasonHighs, SeasonRankingsPostSeason, SeasonRankingsRegularSeason, SeasonTotalsAllStarSeason, SeasonTotalsCollegeSeason, SeasonTotalsPostSeason, SeasonTotalsPreseason, SeasonTotalsRegularSeason

SeasonTotalsRegularSeason

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

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

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

CareerTotalsPostSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsAllStarSeason

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

CareerTotalsAllStarSeason

Same columns as the CareerTotalsRegularSeason table above.

SeasonTotalsCollegeSeason

CareerTotalsCollegeSeason

SeasonTotalsPreseason

Columns as documented in the shared nba_playercareerstats_seasontotalsregularseason_schema table.

CareerTotalsPreseason

Same columns as the CareerTotalsRegularSeason table above.

SeasonRankingsRegularSeason

Columns as documented in the shared nba_playercareerstats_seasonrankingsregularseason_schema table.

SeasonRankingsPostSeason

Columns as documented in the shared nba_playercareerstats_seasonrankingsregularseason_schema table.

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

Same columns as the SeasonHighs table above.

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

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

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOverall

Same columns as the ShotDistanceOverall table above.

ShotAreaOnCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOffCourt

Same columns as the ShotDistanceOnCourt table above.

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

Same columns as the PlayerInfo table above.

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

Same columns as the OverallCompare table above.

Author(s)

Saiem Gilani

Get NBA Possession-Level Stint Matrix

Description

Get NBA Possession-Level Stint Matrix

Usage

nba_possession_lineups(game_id, ...)

Arguments

game_id

NBA Stats game id. 10-character zero-padded string (e.g., "0022200001").

...

reserved for future use.

Details

 nba_possession_lineups(game_id = "0022200001")

Value

Returns a data frame with one row per possession:

col_name	types	description
game_id	character	Unique game identifier (10-character NBA Stats ID).
period	integer	Game period (1-4 regular, 5+ overtime).
possession_number	integer	Sequential possession counter within the game (1-based).
offense_team_id	integer	NBA Stats team ID of the team on offense for this possession.
defense_team_id	integer	NBA Stats team ID of the team on defense for this possession.
points	integer	Points scored by the offense during this possession (0 or positive).
second_chance	logical	TRUE if the possession was extended by an offensive rebound (second-chance opportunity).
start_event_idx	integer	1-based row index into the source PBP frame for the first event of this possession.
end_event_idx	integer	1-based row index into the source PBP frame for the last event of this possession.
off_player_1	integer	NBA Stats person_id for offensive on-court player slot 1.
off_player_2	integer	NBA Stats person_id for offensive on-court player slot 2.
off_player_3	integer	NBA Stats person_id for offensive on-court player slot 3.
off_player_4	integer	NBA Stats person_id for offensive on-court player slot 4.
off_player_5	integer	NBA Stats person_id for offensive on-court player slot 5.
def_player_1	integer	NBA Stats person_id for defensive on-court player slot 1.
def_player_2	integer	NBA Stats person_id for defensive on-court player slot 2.
def_player_3	integer	NBA Stats person_id for defensive on-court player slot 3.
def_player_4	integer	NBA Stats person_id for defensive on-court player slot 4.
def_player_5	integer	NBA Stats person_id for defensive on-court player slot 5.

Author(s)

Saiem Gilani

Estimated Possessions

Description

Simple single-team possession estimate: FGA + 0.44 * FTA - OREB + TOV. For a more exact figure use the full possessions formula with opponent inputs.

Usage

nba_possessions(fga, fta, oreb, tov)

Arguments

fga, fta, oreb, tov

Numeric vectors: field-goal attempts, free-throw attempts, offensive rebounds, turnovers.

Value

A numeric vector of estimated possessions.

Examples

nba_possessions(fga = 88, fta = 25, oreb = 10, tov = 13)

Fit a Ridge-Regression RAPM Model from Possession Data

Description

Fit a Ridge-Regression RAPM Model from Possession Data

Usage

nba_rapm(possessions, ...)

Arguments

possessions

A possession-level stint matrix as produced by nba_possession_lineups(), with columns off_player_1 through off_player_5, def_player_1 through def_player_5 (integer NBA Stats person IDs), and points (numeric, points scored on that possession).

...

Reserved for future keyword arguments (currently ignored).

Details

 poss <- nba_possession_lineups(game_id = "0022200001")
 nba_rapm(poss)

Value

Returns a data.frame with one row per player:

col_name	types	description
player_id	integer	NBA Stats person ID. Rows are sorted ascending by player_id.
o_rapm	numeric	Offensive RAPM (per-100-possession points added on offense). Positive = better offensive player.
d_rapm	numeric	Defensive RAPM (per-100-possession points saved on defense). Positive = better defensive player (sign is flipped so good defense is positive).
rapm	numeric	Total RAPM = o_rapm + d_rapm. Positive = net positive impact.
off_poss	integer	Number of possessions the player appeared on offense.
def_poss	integer	Number of possessions the player appeared on defense.

Returns a 0-row frame with the same schema when input is empty or all possessions have NA lineup cells (never-raise).

Note: RAPM is expressed in per-100-possession units. A full season of possessions (~5,000–8,000) is needed for statistically meaningful estimates. Results from a single game (~150–250 possessions) are highly unstable and are provided here for pipeline illustration only.

Results are deterministic: the cross-validation uses fixed, construction-based folds (not random), so repeated calls on the same possessions return identical output with no need to set a seed.

Author(s)

Saiem Gilani

Get NBA Stats API Season Schedule

Description

Deprecated in hoopR 3.0.0. This endpoint is unstable/empty; use nba_scoreboardv3() instead.

Restored in hoopR 3.1.0 – a residential-IP live re-probe (2026-08-24) confirmed this endpoint still serves real rows for NBA. For real-time scores, prefer nba_todays_scoreboard() instead (see #129).

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_schedule(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

nba_scoreboard(league_id = "00", game_date = "2021-07-20", day_offset = 0, ...)

nba_scoreboardv2(
  league_id = "00",
  game_date = "2021-07-20",
  day_offset = 0,
  ...
)

nba_scoreboardv3(league_id = "00", game_date = "2023-03-26", ...)

nba_todays_scoreboard(...)

nba_winprobabilitypbp(game_id = "0021700807", run_type = "each second", ...)

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

...

Additional arguments passed to an underlying function like httr.

game_date

Game Date

day_offset

Day Offset (integer 0,-1)

game_id

Game ID

run_type

Run Type

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

 nba_scoreboard(league_id = '00', game_date = '2021-07-20')

 nba_scoreboardv2(league_id = '00', game_date = '2021-07-20')

 nba_scoreboardv3(league_id = '00', game_date = '2023-03-26')

 nba_todays_scoreboard()

 nba_winprobabilitypbp(game_id = '0021700807', run_type = 'each second')

 nba_scheduleleaguev2int(league_id = '00', 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).

Return a named list of data frames: Available, EastConfStandingsByDay, GameHeader, LastMeeting, LineScore, SeriesStandings, WestConfStandingsByDay

GameHeader

Columns as documented in the shared nba_boxscoresummaryv2_gamesummary_schema table.

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

Columns as documented in the shared nba_boxscoresummaryv2_seasonseries_schema table.

LastMeeting

Columns as documented in the shared nba_boxscoresummaryv2_lastmeeting_schema table.

EastConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

WestConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

Available

col_name	types	description
GAME_ID	character	Unique game identifier.
PT_AVAILABLE	character	Pt available.

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

Columns as documented in the shared nba_boxscoresummaryv2_seasonseries_schema table.

LastMeeting

Columns as documented in the shared nba_boxscoresummaryv2_lastmeeting_schema table.

EastConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

WestConfStandingsByDay

Columns as documented in the shared nba_scoreboard_eastconfstandingsbyday_schema table.

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

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

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.

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

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

Get the NBA cross-source schedule crosswalk

Description

Build a wide, one-row-per-game crosswalk linking ESPN and NBA Stats game ids (NA Fox/Yahoo placeholders). Dates from both sources are reduced to the local Eastern-Time game date before joining. Note: the NBA Stats CDN serves the current season only, so the live builder is effectively current-season; historical coverage comes from cached release artifacts.

Usage

nba_schedule_crosswalk(season = most_recent_nba_season())

Arguments

season

NBA season per hoopR convention (default most_recent_nba_season()).

Value

A hoopR_data tibble, one row per game.

Examples


  try(nba_schedule_crosswalk())

Shared column schema: nba scoreboard eastconfstandingsbyday schema

Description

Columns shared verbatim across: nba_scoreboard, nba_scoreboardv2.

Details

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

Fetch NBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Description

Fetch NBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Usage

nba_shot_zones(game_id, ...)

Arguments

game_id

A length-1 character string — the ten-character NBA Stats game identifier (e.g. "0022200001" for the first game of the 2022-23 regular season).

...

Reserved for future keyword arguments (currently ignored).

Details

 df <- nba_shot_zones(game_id = "0022200001")
 print(table(df$shot_zone, useNA = "ifany"))

Value

Returns a data.frame containing the full V3 play-by-play for game_id with an appended shot_zone column:

col_name	types	description
event_type	character	Play event type code. `"1"` = MadeShot, `"2"` = MissedShot, `"3"` = FreeThrow, etc.
shot_value	integer	Point value of the shot attempt (2 or 3); 0 for non-FGA events.
x_legacy	numeric	Horizontal court coordinate (legacy units). Negative = left side of the court.
y_legacy	numeric	Vertical court coordinate (legacy units). Values near 0 = baseline.
shot_distance	numeric	Distance from the basket in feet.
shot_zone	character	Shot-zone classification. One of `"corner_3"`, `"above_the_break_3"`, `"restricted_area"`, `"in_the_paint_non_ra"`, `"mid_range"`. `NA` on non-field-goal rows.

All other columns from the V3 PBP schema (nba_pbp()) are also present. Returns a 0-row frame when the game cannot be fetched (never-raise).

Shot zone definitions (pbpstats-core aligned):

"corner_3" — three-point attempt with abs(x_legacy) >= 220 and y_legacy <= 87.5 (baseline corner area).
"above_the_break_3" — all other three-point attempts.
"restricted_area" — two-point attempt within 4 ft of the basket.
"in_the_paint_non_ra" — two-point attempt 4–8 ft from the basket and within 80 legacy units of the paint center (abs(x_legacy) <= 80).
"mid_range" — all remaining two-point attempts.

Author(s)

Saiem Gilani

Examples


  try({
    df <- nba_shot_zones(game_id = "0022200001")
    print(df[!is.na(df$shot_zone), c("shot_distance", "shot_zone")])
  })

Get NBA Stats API Shot Chart Detail

Description

Get NBA Stats API Shot Chart Detail

Get NBA Stats API Shot Chart League-Wide

Get NBA Stats API Shot Chart for Lineups

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 = "",
  ...
)

nba_shotchartleaguewide(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  ...
)

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

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.

ahead_behind

ahead_behind

cfid

cfid

cfparams

cfparams

clutch_time

clutch_time

conference

conference

context_filter

context_filter

division

division

end_period

end_period

end_range

end_range

group_id

group_id

game_event_id

game_event_id

group_mode

group_mode

group_quantity

group_quantity

on_off

on_off

opp_player_id

opp_player_id

po_round

po_round

player_id1

player_id1

player_id2

player_id2

player_id3

player_id3

player_id4

player_id4

player_id5

player_id5

point_diff

point_diff

position

position

range_type

range_type

shot_clock_range

shot_clock_range

start_period

start_period

start_range

start_range

starter_bench

starter_bench

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

Details

 nba_shotchartdetail(league_id = '00', player_id = '202696', season = year_to_season(most_recent_nba_season() - 1))

 nba_shotchartleaguewide(league_id = '00', season = year_to_season(most_recent_nba_season() - 1))

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

Columns as documented in the shared nba_shotchartdetail_leagueaverages_schema table.

Return a named list of data frames: League_Wide

League_Wide

Columns as documented in the shared nba_shotchartdetail_leagueaverages_schema table.

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

Columns as documented in the shared nba_shotchartdetail_leagueaverages_schema table.

Author(s)

Saiem Gilani

Shared column schema: nba shotchartdetail leagueaverages schema

Description

Columns shared verbatim across: nba_shotchartdetail, nba_shotchartleaguewide, nba_shotchartlineupdetail.

Details

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

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 the NBA cross-source team crosswalk

Description

Build a wide, one-row-per-team crosswalk linking ESPN, NBA Stats, and Fox team identities, keyed on espn_team_id. nba_teams() already supplies the ESPN<->Stats linkage; this reshapes it and attaches Fox. Yahoo columns are NA placeholders. NOTE: ESPN/Stats team endpoints are current-season snapshots, so season is a stamp; historical relocations are not back-modeled live.

Usage

nba_team_crosswalk(season = most_recent_nba_season())

Arguments

season

NBA season per hoopR convention (default most_recent_nba_season(); e.g. 2025 for 2024-25).

Value

A hoopR_data tibble, one row per team (ESPN / ⁠nba_*⁠ / Fox / Yahoo column groups + match_method / match_confidence).

Examples


  try(nba_team_crosswalk())

NBA Team Dictionary

Description

A tidy team dictionary (id, abbreviation, name, conference, division, logo URL) derived from the stats.nba.com player index plus a static conference/division map.

Usage

nba_team_dict(season = year_to_season(most_recent_nba_season() - 1), ...)

Arguments

season

Season in "YYYY-YY" form. Defaults to the most recent completed season.

...

Additional arguments passed to nba_playerindex() (e.g. proxy).

Value

A hoopR_data tibble with one row per team:

col_name	types	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_city	character	Team city / region.
team_name	character	Team nickname.
team_full	character	Full team name.
conference	character	Conference (`Eastern` / `Western`).
division	character	Division.
logo_url	character	NBA CDN primary logo URL.

Examples


  try(nba_team_dict())

NBA Team Logo URL

Description

Build the official NBA CDN logo URL(s) for one or more team ids. Vectorized.

Usage

nba_team_logo_url(team_id, variant = "primary")

Arguments

team_id

Team id(s) (TEAM_ID, the 10-digit form e.g. 1610612744).

variant

Logo variant: "primary" (default), "secondary" or "global".

Value

A character vector of SVG logo URLs.

Examples

nba_team_logo_url(team_id = 1610612744)                # Golden State Warriors

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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

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.

game_id

game_id

group_quantity

group_quantity

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

Team Lineups Dashboard

 nba_teamdashlineups(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Player Tracking (Second Spectrum) Stats - Passing

 nba_teamdashptpass(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

Team Player Tracking (Second Spectrum) Stats - Rebounds

 nba_teamdashptreb(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 1))

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: 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.

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.

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.

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.

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

Shared column schema: nba teamplayeronoffdetails overallteamplayeronoffdetails schema

Description

Columns shared verbatim across: nba_teamplayeronoffdetails, nba_teamplayeronoffsummary.

Details

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

Get NBA Stats API Teams

Description

NBA Stats no longer returns stable data for this endpoint. This function is deprecated and now errors when called. Use nba_franchiseleaders() instead.

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_teams(...)

nba_teamdetails(team_id = "1610612749", ...)

nba_teamestimatedmetrics(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  ...
)

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",
  ...
)

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 = "",
  ...
)

nba_teamhistoricalleaders(
  league_id = "00",
  season_id = "22022",
  team_id = "1610612749",
  ...
)

nba_teaminfocommon(
  league_id = "00",
  season = year_to_season(most_recent_nba_season() - 1),
  season_type = "Regular Season",
  team_id = "1610612749",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

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 = "",
  ...
)

nba_teamyearbyyearstats(
  league_id = "00",
  per_mode = "Totals",
  season_type = "Regular Season",
  team_id = "1610612749",
  ...
)

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",
  ...
)

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 = "",
  ...
)

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

...

Additional arguments passed to an underlying function like httr.

team_id

team_id

league_id

league_id

season

season

season_type

season_type

date_from

date_from

date_to

date_to

game_segment

game_segment

last_n_games

last_n_games

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_segment

season_segment

vs_conference

vs_conference

vs_division

vs_division

season_id

season_id

pace_adjust

pace_adjust

plus_minus

plus_minus

rank

rank

shot_clock_range

shot_clock_range

vs_player_id

vs_player_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

conference

Conference filter - 'East', 'West', or ”

division

Division filter

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

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

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

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

Details

 nba_teams()

 nba_teamdetails(team_id = '1610612749')

Team Estimated Metrics

 nba_teamestimatedmetrics()

Teams Game Log

 nba_teamgamelog(team_id = '1610612749')

Teams Game Log

 nba_teamgamelogs(team_id = '1610612749')

 nba_teamhistoricalleaders(team_id = '1610612749')

 nba_teaminfocommon(team_id = '1610612749')

 nba_teamplayeronoffdetails(team_id = '1610612749')

 nba_teamplayeronoffsummary(team_id = '1610612749')

 nba_teamplayerdashboard(team_id = '1610612749')

Team Year by Year Stats

 nba_teamyearbyyearstats(team_id = '1610612749')

 nba_teamvsplayer(team_id = '1610612749', vs_player_id = '2544')

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

 nba_teamgamestreakfinder()

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.

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

Same columns as the TeamAwardsConf table above.

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

Same columns as the TeamHof table above.

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

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.

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

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

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.

Return a named list of data frames: OverallTeamPlayerOnOffDetails, PlayersOffCourtTeamPlayerOnOffDetails, PlayersOnCourtTeamPlayerOnOffDetails

OverallTeamPlayerOnOffDetails

Columns as documented in the shared nba_teamplayeronoffdetails_overallteamplayeronoffdetails_schema table.

PlayersOnCourtTeamPlayerOnOffDetails

Columns as documented in the shared nba_leagueplayerondetails_playersoncourtleagueplayerdetails_schema table.

PlayersOffCourtTeamPlayerOnOffDetails

Columns as documented in the shared nba_leagueplayerondetails_playersoncourtleagueplayerdetails_schema table.

Return a named list of data frames: OverallTeamPlayerOnOffSummary, PlayersOffCourtTeamPlayerOnOffSummary, PlayersOnCourtTeamPlayerOnOffSummary

OverallTeamPlayerOnOffSummary

Columns as documented in the shared nba_teamplayeronoffdetails_overallteamplayeronoffdetails_schema table.

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

Same columns as the PlayersOnCourtTeamPlayerOnOffSummary table above.

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

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

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

Columns as documented in the shared nba_leagueplayerondetails_playersoncourtleagueplayerdetails_schema table.

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

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOverall

Same columns as the ShotDistanceOverall table above.

ShotAreaOnCourt

Same columns as the ShotDistanceOnCourt table above.

ShotAreaOffCourt

Same columns as the ShotDistanceOnCourt table above.

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

Same columns as the TeamPlayersVsPlayersOn table above.

TeamVsPlayers

Same columns as the PlayersVsPlayers table above.

TeamVsPlayersOff

Same columns as the PlayersVsPlayers table above.

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

NBA Player Box Score with Team Context

Description

A traditional player box score with each player's team totals joined on (tactic C). nba_boxscoretraditionalv2() returns player-grain PlayerStats and team-grain TeamStats separately; this left-joins the team totals onto every player row by GAME_ID + TEAM_ID, suffixing the team columns with ⁠_team⁠.

Usage

nba_tidy_boxscore(game_id, ...)

Arguments

game_id

Game ID (10-digit, zero-padded e.g. "0022300061").

...

Additional arguments passed to nba_boxscoretraditionalv2().

Value

A hoopR_data tibble, one row per player, with the player's stats and their team's totals (team columns suffixed ⁠_team⁠).

Examples


  try(nba_tidy_boxscore(game_id = "0022300061"))

NBA Franchise History (active + defunct)

Description

One tidy franchise timeline. nba_franchisehistory() returns the active (FranchiseHistory) and DefunctTeams sets separately; these share a schema, so this row-binds them (tactic B) and tags each row active / defunct.

Usage

nba_tidy_franchise_history(...)

Arguments

...

Additional arguments passed to nba_franchisehistory() (e.g. proxy).

Value

A hoopR_data tibble, one row per franchise era, with a leading franchise_status column (active / defunct).

Examples


  try(nba_tidy_franchise_history())

NBA Player Profile (nested by table)

Description

A player's full profile collapsed to one self-describing tibble (tactic D). nba_playerprofilev2() returns many heterogeneous, PLAYER_ID-keyed sets (season totals, career totals, season/career highs, rankings, next game); this nests each populated set into a .data list-column, one row per ⁠(set_name, PLAYER_ID)⁠. Recover a table with tidyr::unnest().

Usage

nba_tidy_player_profile(player_id, ...)

Arguments

player_id

Player ID (e.g. 201939).

...

Additional arguments passed to nba_playerprofilev2().

Value

A hoopR_data tibble with set_name, PLAYER_ID and a .data list-column.

Examples


  prof <- try(nba_tidy_player_profile(player_id = 201939))

Aggregate NBA Player-Tracking Stats Across Multiple Seasons

Description

Fetches leaguedashptstats dashboards for each combination of seasons and season_types, then aggregates the results by entity (PLAYER_ID for Player, TEAM_ID for Team) following the contract ported from sportsdataverse-py's aggregate_tracking_frames:

Identity columns (⁠*_ID⁠, ⁠*_NAME⁠, ⁠*_ABBREVIATION⁠, and any other non-numeric string column such as TEAM_CITY) are carried via first() — never summed.
⁠*_FG_PCT⁠ / ⁠*_FT_PCT⁠ are recomputed from the summed FGM/FGA and FTM/FTA denominators (denom 0 -> NA); a ⁠*_FG_PCT⁠ / ⁠*_FT_PCT⁠ column whose makes/attempts pair is absent is dropped rather than recomputed.
Other ⁠*_PCT⁠ columns (e.g., DRIVE_PTS_PCT — "% of total" rates) are dropped from the output because they are not additive.
All remaining numeric columns are summed (numeric-content gate, mirroring the sportsdataverse-py dtype.is_numeric() rule).

Usage

nba_tracking_aggregate(
  seasons,
  season_types = "Regular Season",
  per_mode = "Totals",
  pt_measure_type = "Drives",
  player_or_team = "Player",
  league_id = "00",
  ...
)

Arguments

seasons

Character vector of NBA season strings, e.g. c("2022-23", "2023-24").

season_types

Character vector of season type(s), e.g. "Regular Season" or c("Regular Season", "Playoffs"). Defaults to "Regular Season".

per_mode

Per-mode string passed to nba_leaguedashptstats (default "Totals"). Use "Totals" for aggregation; per-game averages are not meaningfully additive.

pt_measure_type

Tracking measure type string, e.g. "Drives", "SpeedDistance", "Passing". Passed directly to nba_leaguedashptstats. Default "Drives".

player_or_team

"Player" (default) or "Team". Determines the entity key used to group aggregation (PLAYER_ID or TEAM_ID).

league_id

League identifier string. Default "00" (NBA).

...

Additional arguments forwarded to nba_leaguedashptstats (e.g., date_from, date_to, conference).

Details

Aggregate NBA Player-Tracking Stats Across Multiple Seasons

 nba_tracking_aggregate(seasons = c("2022-23", "2023-24"),
                        pt_measure_type = "Drives",
                        player_or_team  = "Player")

Value

A data.frame (tibble-compatible) with one row per entity (PLAYER_ID or TEAM_ID). Count columns are summed across all requested seasons/season types; ⁠*_FG_PCT⁠ and ⁠*_FT_PCT⁠ are recomputed from summed numerators/denominators; ⁠*_PCT⁠ "% of total" columns are dropped; identity string columns are carried from the first season. Returns a 0-row frame when no data are available.

Note

Designed and validated for COUNT-based tracking measures (e.g. "Drives"). Rate-only columns without a ⁠_pct⁠ suffix in some pt_measure_type values are summed across seasons (a known limitation shared with the sportsdataverse reference engine); verify aggregation semantics before using rate-heavy measures.

Author(s)

Saiem Gilani

Examples


  try({
    df <- nba_tracking_aggregate(
      seasons = c("2022-23", "2023-24"),
      pt_measure_type = "Drives",
      player_or_team  = "Player"
    )
    print(df[1:5, c("PLAYER_ID", "PLAYER_NAME", "DRIVES", "DRIVE_FG_PCT")])
  })

True Shooting Percentage

Description

Points per shooting possession: PTS / (2 * (FGA + 0.44 * FTA)).

Usage

nba_true_shooting_pct(pts, fga, fta)

Arguments

pts, fga, fta

Numeric vectors: points, field-goal attempts, free-throw attempts.

Value

A numeric vector of true-shooting percentages (0-1 scale).

Examples

nba_true_shooting_pct(pts = 30, fga = 20, fta = 8)

Turnover Percentage

Description

Turnovers per 100 plays: 100 * TOV / (FGA + 0.44 * FTA + TOV).

Usage

nba_turnover_pct(tov, fga, fta)

Arguments

tov, fga, fta

Numeric vectors: turnovers, field-goal attempts, free-throw attempts.

Value

A numeric vector (0-100 scale).

Examples

nba_turnover_pct(tov = 13, fga = 88, fta = 25)

Usage Rate

Description

Percentage of team plays a player used while on the floor.

Usage

nba_usage_rate(
  fga,
  fta,
  tov,
  minutes,
  team_fga,
  team_fta,
  team_tov,
  team_minutes
)

Arguments

fga, fta, tov, minutes

Player box-score totals: field-goal attempts, free-throw attempts, turnovers, minutes.

team_fga, team_fta, team_tov, team_minutes

Team totals for the same game(s).

Value

A numeric vector of usage percentages (0-100 scale).

Examples

nba_usage_rate(fga = 20, fta = 8, tov = 3, minutes = 36,
               team_fga = 88, team_fta = 25, team_tov = 13, team_minutes = 240)

Get NBA Stats API Video Details

Description

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_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 = "",
  ...
)

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 = "",
  ...
)

nba_videoevents(game_id = "0021700807", game_event_id = "10", ...)

nba_videostatus(game_date = "2023-03-10", league_id = "00", ...)

nba_videoeventsasset(game_id, game_event_id = 0, ...)

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.

game_event_id

game_event_id

game_date

game_date

Details

 nba_videodetailsasset(player_id = '2544', team_id = '1610612747')

 nba_videodetails(player_id = '2544', team_id = '1610612747')

 nba_videoevents(game_id = '0021700807', game_event_id = '10')

 nba_videostatus(game_date = '2023-03-10', league_id = '00')

(Possibly Defunct)

 nba_videoeventsasset(game_id = '0021700807', game_event_id = 10)

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.

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.

Return a list of tibbles: videoUrls, playlist

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.

Returns a named list containing video event asset data (structure varies by response)

Author(s)

Saiem Gilani

NBADraft.net Mock Draft

Description

Get the latest mock draft from NBADraft.net.

Returns the current consensus mock draft (both rounds), one row per pick. No API key is required.

Usage

nbadraft_mock_draft(year = NULL)

Arguments

year

(integer optional): Draft year (e.g. 2025). Defaults to the site's current mock; older years use the ⁠/{year}/⁠ path when available.

Value

A hoopR_data tibble with one row per mock-draft pick:

col_name	types	description
round	integer	Draft round (1 or 2).
pick	integer	Pick number within the round.
team	character	Projected team (`*` traded-pick marker stripped).
player	character	Projected player.
height	character	Player height.
weight	character	Player weight.
position	character	Player position.
school	character	Player school / pre-draft team.
class	character	Player class / draft eligibility.

Examples


  try(nbadraft_mock_draft())

Get NBA G-League Stats API Live Boxscore

Description

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

game_details

Columns as documented in the shared nba_live_boxscore_game_details_schema table.

arena

Columns as documented in the shared nba_live_boxscore_arena_schema table.

officials

Columns as documented in the shared nba_live_boxscore_officials_schema table.

home_team_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_boxscore_schema table.

away_team_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_boxscore_schema table.

home_team_player_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_player_boxscore_schema table.

away_team_player_boxscore

Columns as documented in the shared nba_live_boxscore_home_team_player_boxscore_schema table.

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

Get NBA G-League Stats API Live play-by-play

Description

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

Columns as documented in the shared nba_live_pbp_schema table.

Author(s)

Saiem Gilani

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

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

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

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

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

Load .parquet file from a remote connection

Description

Sibling of rds_from_url() for release assets published as parquet (e.g. the mbb_ratings / mbb_player_value model-dataset tags). 404-safe: an unpublished asset returns an empty data.table + a warning, matching rds_from_url()'s contract, instead of raising.

Usage

parquet_from_url(url)

Arguments

url

a character url

Value

a dataframe as created by arrow::read_parquet()

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

RealGM NBA Head Coaches

Description

Get the current NBA head coaches from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_coaches()

Value

A hoopR_data tibble with one row per coach:

col_name	types	description
staff	character	Coach name.
team	character	Team name.
start_season	character	Season the coach started with the team.
years_in_role	integer	Seasons in the role.
birth_date	character	Birth date (when listed).
nationality	character	Nationality.

Examples

## Not run: 
  try(realgm_coaches())

## End(Not run)

RealGM NBA Draft Results

Description

Get the results of a past NBA draft from RealGM.

One row per selection (rounds 1 and 2, labelled by round) plus the listed undrafted players (round = NA), including pre-draft team / international club, age, years of service and nationality.

Requires a headless browser (see realgm_players()).

Usage

realgm_draft(year = most_recent_nba_season() - 1L)

Arguments

year

Draft year (the calendar year the draft was held). Defaults to the most recently completed draft (most_recent_nba_season() - 1).

Value

A hoopR_data tibble carrying draft_year and round columns:

col_name	types	description
pick	integer	Overall pick number (`NA` for undrafted).
player	character	Player name.
team	character	Drafting team abbreviation.
draft_trades	character	Draft-night trade note, if any.
pos	character	Position.
ht	character	Listed height.
wt	integer	Listed weight (lbs).
age	numeric	Age at draft.
yos	integer	Years of service since.
pre_draft_team	character	Pre-draft team / school / club.
class	character	College class / draft eligibility note.
nationality	character	Player nationality.
round	integer	Draft round (`1`, `2`, or `NA` undrafted).
draft_year	numeric	Draft year (echoes `year`).

Examples

## Not run: 
  try(realgm_draft(year = 2020))

## End(Not run)

RealGM NBA Draft Prospect Stats

Description

Get current NBA draft-prospect statistics from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_draft_prospects()

Value

A hoopR_data tibble with one row per prospect (player, team (school/club), gp, mpg, ppg, shooting splits, rpg, apg, spg, bpg).

Examples

## Not run: 
  try(realgm_draft_prospects())

## End(Not run)

RealGM NBA Draft Early Entrants

Description

Get the current NBA draft early-entrant and withdrawal list from RealGM.

Stacks RealGM's early-entry candidate tables (college and international entrants and withdrawals) into one tibble.

Requires a headless browser (see realgm_players()).

Usage

realgm_early_entry()

Value

A hoopR_data tibble with one row per candidate (player, pos, ht, wt, birth_date, college / pre_draft_team, class, draft_status, yos, nationality).

Examples

## Not run: 
  try(realgm_early_entry())

## End(Not run)

RealGM Future NBA Free Agents

Description

Get RealGM's projected future NBA free-agent class from RealGM.

One row per upcoming free agent, including the free-agency season, the player's Bird/veteran free-agent status, recent production and – distinctively – the player's listed agent.

Requires a headless browser (see realgm_players()).

Usage

realgm_future_free_agents()

Value

A hoopR_data tibble with one row per future free agent:

col_name	types	description
player	character	Player name.
pos	character	Position.
team	character	Current team abbreviation.
season	character	Free-agency season (e.g. `2026-2027`).
age	integer	Age.
yos	integer	Years of service.
veteran_fa_status	character	Bird / Non-Bird / veteran FA status.
gp	integer	Games played.
pts	numeric	Points per game.
reb	numeric	Rebounds per game.
ast	numeric	Assists per game.
per	numeric	Player Efficiency Rating.
agent	character	Listed player agent.

Examples

## Not run: 
  try(realgm_future_free_agents())

## End(Not run)

RealGM NBA General Managers

Description

Get the current NBA general managers from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_gms()

Value

A hoopR_data tibble with one row per general manager (staff, team, start_season, years_in_role, birth_date, nationality).

Examples

## Not run: 
  try(realgm_gms())

## End(Not run)

RealGM NBA Best Individual Games

Description

Get the all-time best individual NBA games leaderboard from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_individual_games()

Value

A hoopR_data tibble with one row per player-game (player, date, team, min, pts, fgm, fga, reb, ast, stl, blk, etc.).

Examples

## Not run: 
  try(realgm_individual_games())

## End(Not run)

RealGM NBA Best Individual Seasons

Description

Get the all-time best individual NBA seasons leaderboard from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_individual_seasons()

Value

A hoopR_data tibble with one row per player-season (player, season, team, gp, min, pts, shooting splits, reb, ast, etc.).

Examples

## Not run: 
  try(realgm_individual_seasons())

## End(Not run)

RealGM NBA Player Stats

Description

Get season player statistics leaders from RealGM.

Returns the qualified-player leaderboard for a season, statistic family and season segment. RealGM exposes basic box-score averages as well as advanced and miscellaneous splits not all available from first-party feeds.

Requires a headless browser (see realgm_players()).

Usage

realgm_player_stats(
  season = most_recent_nba_season(),
  stat_type = "Averages",
  season_type = "Regular_Season"
)

Arguments

season

Season (the year the season ends, e.g. 2026 for 2025-26). Defaults to most_recent_nba_season().

stat_type

Statistic family. One of "Averages" (default), "Totals", "Per_48", "Per_40", "Per_36", "Per_Minute", "Advanced_Stats" or "Misc_Stats".

season_type

Season segment. One of "Regular_Season" (default), "Playoffs", "Preseason" or "Summer_League".

Value

A hoopR_data tibble (one row per qualified player) carrying the requested season, stat_type and season_type as columns. Columns vary by stat_type; for "Averages":

col_name	types	description
player	character	Player name.
team	character	Team abbreviation.
gp	integer	Games played.
mpg	numeric	Minutes per game.
ppg	numeric	Points per game.
rpg	numeric	Rebounds per game.
apg	numeric	Assists per game.

Examples

## Not run: 
  try(realgm_player_stats(season = 2025, stat_type = "Averages"))

## End(Not run)

RealGM NBA Player Index

Description

Get the active NBA player index from RealGM.

Returns RealGM's roster of active NBA players, including position, listed height/weight, age, current team, years of service and pre-draft team – the pre-draft / international detail RealGM is known for.

Requires a headless browser. RealGM is behind a Cloudflare JavaScript challenge, so the ⁠realgm_*()⁠ functions drive headless Chrome via the optional chromote package (install it and Google Chrome). A plain HTTP client receives an HTTP 403 challenge page.

Usage

realgm_players()

Value

A hoopR_data tibble with one row per active player:

col_name	types	description
number	integer	Row number.
player	character	Player name.
pos	character	Position.
ht	character	Listed height.
wt	integer	Listed weight (lbs).
age	numeric	Age.
current_team	character	Current NBA team.
yos	integer	Years of service.
pre_draft_team	character	Pre-draft team / school.
draft_status	character	Draft pick / undrafted status.
nationality	character	Player nationality.

Examples

## Not run: 
  try(realgm_players())

## End(Not run)

RealGM NBA Players Abroad

Description

Get the list of NBA-affiliated players currently playing overseas from RealGM.

RealGM tracks NBA draft picks, two-way and free-agent players who are on international rosters – a view no first-party NBA/ESPN endpoint provides.

Requires a headless browser (see realgm_players()).

Usage

realgm_players_abroad()

Value

A hoopR_data tibble with one row per player:

col_name	types	description
player	character	Player name.
pos	character	Position.
ht	character	Listed height.
wt	integer	Listed weight (lbs).
nba_status	character	NBA contract / rights status.
team_s	character	Current overseas team(s) and NBA affiliation.
gp	integer	Games played.
mpg	numeric	Minutes per game.
ppg	numeric	Points per game.
rpg	numeric	Rebounds per game.
apg	numeric	Assists per game.

Examples

## Not run: 
  try(realgm_players_abroad())

## End(Not run)

RealGM NBA Rookie Scale

Description

Get the current NBA rookie-scale salary table from RealGM.

One row per first-round pick with the four contract-year amounts and the qualifying-offer percentage. Dollar figures are the formatted strings RealGM publishes.

Requires a headless browser (see realgm_players()).

Usage

realgm_rookie_scale()

Value

A hoopR_data tibble with one row per first-round pick (pick, x1st_year_salary, x2nd_year_salary, x3rd_year_option_salary, the 4th-year option increase and qualifying-offer increase).

Examples

## Not run: 
  try(realgm_rookie_scale())

## End(Not run)

RealGM NBA Salary Cap History

Description

Get the NBA salary-cap history (and projections) from RealGM.

One row per season with the cap, luxury-tax line, both aprons, bi-annual exception and the mid-level exception tiers. Dollar figures are returned as the formatted strings RealGM publishes (e.g. "$140,588,000").

Requires a headless browser (see realgm_players()).

Usage

realgm_salary_cap()

Value

A hoopR_data tibble with one row per season:

col_name	types	description
season	character	Season (e.g. `2025-2026`).
salary_cap	character	Salary cap.
luxury_tax	character	Luxury-tax threshold.
x1st_apron	character	First apron.
x2nd_apron	character	Second apron.
bae	character	Bi-annual exception.
non_taxpayer_mle	character	Non-taxpayer mid-level exception.
taxpayer_mle	character	Taxpayer mid-level exception.
team_room_mle	character	Room mid-level exception.

Examples

## Not run: 
  try(realgm_salary_cap())

## End(Not run)

RealGM NBA Standings

Description

Get the current NBA standings (both conferences) from RealGM.

One row per team with record, win pct, games back, streak, last-ten, scoring margin and home/away/division/conference splits. The Eastern and Western conference tables are stacked and labelled by a conference column.

Requires a headless browser (see realgm_players()).

Usage

realgm_standings()

Value

A hoopR_data tibble with one row per team:

col_name	types	description
number	integer	Conference rank.
team	character	Team name.
w	integer	Wins.
l	integer	Losses.
pct	numeric	Win percentage.
gb	numeric	Games back.
l10	character	Last-ten record.
strk	character	Current streak.
ppg	numeric	Points per game.
oppg	numeric	Opponent points per game.
diff	numeric	Scoring margin.
home	character	Home record.
away	character	Away record.
conference	character	`Eastern` or `Western`.

Examples

## Not run: 
  try(realgm_standings())

## End(Not run)

RealGM NBA Team Stats

Description

Get season team statistics from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_team_stats(
  season = most_recent_nba_season(),
  stat_type = "Averages",
  season_type = "Regular_Season"
)

Arguments

season

Season (the year the season ends, e.g. 2026). Defaults to most_recent_nba_season().

stat_type

Statistic family. One of "Averages" (default), "Totals", "Advanced_Stats" or "Misc_Stats".

season_type

Season segment. One of "Regular_Season" (default), "Playoffs", "Preseason" or "Summer_League".

Value

A hoopR_data tibble (one row per team) carrying the requested season, stat_type and season_type as columns. Columns vary by stat_type; for "Averages": team, gp, mpg, ppg, rpg, apg, etc.

Examples

## Not run: 
  try(realgm_team_stats(season = 2025, stat_type = "Averages"))

## End(Not run)

RealGM NBA Teams Index

Description

Get the NBA team index, with division and conference, from RealGM.

Requires a headless browser (see realgm_players()).

Usage

realgm_teams()

Value

A hoopR_data tibble with one row per team:

col_name	types	description
team	character	Team name.
division	character	Division (e.g. `Atlantic`).
conference	character	`Eastern` or `Western`.

Examples

## Not run: 
  try(realgm_teams())

## End(Not run)

RealGM NBA Transactions Log

Description

Get the NBA league transactions log from RealGM.

One row per transaction (signings, waivers, two-way conversions, G-League assignments/recalls, trades), each tagged with its date. RealGM publishes the transactions as a dated narrative list rather than a table, so this parses the page DOM directly.

Requires a headless browser (see realgm_players()).

Usage

realgm_transactions()

Value

A hoopR_data tibble with one row per transaction:

col_name	types	description
date	Date	Transaction date.
transaction	character	Transaction description.

Examples

## Not run: 
  try(realgm_transactions())

## End(Not run)

College Basketball Data API Key Registration

Description

Save your CollegeBasketballData API key as the system environment variable CBBD_API_KEY.

Usage

cbbd_key()

has_cbbd_key()

check_cbbd_key()

Details

The ⁠cbbd_*()⁠ functions wrap the CollegeBasketballData API, the men's college basketball sibling of CollegeFootballData. The API requires a free API key (Bearer token). Request one at https://collegebasketballdata.com/key.

Using the key:
Save the key for consistent usage by adding CBBD_API_KEY=XXXX-YOUR-API-KEY-HERE-XXXXX to your .Renviron file (easily accessed via usethis::edit_r_environ()). Run usethis::edit_r_environ(), a new script will pop open named .Renviron, THEN paste the following in the new script that pops up (without quotations)

CBBD_API_KEY = XXXX-YOUR-API-KEY-HERE-XXXXX

Save the script and restart your R session. If set correctly, from then on you should be able to use any of the ⁠cbbd_*()⁠ functions without any other changes.

For less consistent usage:
At the beginning of every session or within an R environment, save your API key as the environment variable CBBD_API_KEY (with quotations) using a command like the following.

Sys.setenv(CBBD_API_KEY = "XXXX-YOUR-API-KEY-HERE-XXXXX")

Value

cbbd_key() - Returns the CBBD_API_KEY environment variable, or NA_character_ if it is unset.

has_cbbd_key() - Returns a logical: TRUE if a key is stored, FALSE otherwise.

check_cbbd_key() - Called for its side effect; errors if no key is stored in the environment.

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

Retry http request with optional proxy

Description

This is a thin wrapper around httr2 for NBA Stats API requests.

Usage

request_with_proxy(
  url,
  params = list(),
  origin = "https://stats.nba.com",
  referer = "https://www.nba.com/",
  proxy = NULL,
  ...
)

Arguments

url

Request url

params

list of params

origin

Origin url

referer

Referer url

proxy

Optional proxy config. NULL (default) lets libcurl honor the standard http_proxy / https_proxy / no_proxy environment variables. A single URL string (e.g. "http://host:port") is forwarded to httr2::req_proxy(url = proxy). A named list is spread as keyword args into httr2::req_proxy() (url, port, username, password, auth) for full control over authenticated proxies.

...

Additional arguments (currently unused).

RotoWire NBA Injury Report

Description

Get the current NBA injury report from RotoWire.

One row per injured player with team, position, the injury, the current designation (Out / Doubtful / Questionable / GTD / Day-To-Day) and a link to the player's RotoWire page. The projected return date is RotoWire subscriber-only content and is returned as NA for non-subscribers.

This is the live replacement for the defunct RotoWorld injuries feed. See also bref_injuries() for the Basketball-Reference injury report.

Usage

rotowire_injuries()

Value

A hoopR_data tibble with one row per injured player:

col_name	types	description
player_id	character	RotoWire player id.
player	character	Player name.
first_name	character	First name.
last_name	character	Last name.
team	character	Team abbreviation.
position	character	Position.
injury	character	Injury (body part / description).
status	character	Injury designation (Out, GTD, Questionable, ...).
return_date	character	Projected return (`NA` unless a subscriber).
url	character	RotoWire player page URL.

Examples


  try(rotowire_injuries())

Spotrac NBA Team Salary Cap

Description

Get team salary-cap allocations from Spotrac.

Returns one row per team with cap allocations, cap space, active-player counts and average age for a season. No API key is required.

Usage

spotrac_team_cap(season = most_recent_nba_season())

Arguments

season

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_nba_season().

Value

A hoopR_data tibble with one row per team (columns reflect Spotrac's table; dollar figures are returned as numeric):

col_name	types	description
rank	integer	Spotrac cap rank.
team	character	Team abbreviation.
record	character	Win-loss record.
players_active	integer	Number of active players.
avg_age_team	numeric	Average roster age.
total_cap_allocations	numeric	Total cap allocations (USD).
cap_space_all	numeric	Cap space / over-the-cap amount (USD).
season	integer	Season (echoes the `season` argument).

Examples


  try(spotrac_team_cap(season = 2024))

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.

Bart Torvik Season Schedule & Results

Description

Get the full game-by-game schedule and results for a season from barttorvik.com.

Pulls Bart Torvik's "super schedule" (the ⁠{year}_super_sked.json⁠ file): one row per game with the pre-game prediction, both teams' adjusted efficiencies and tempo, the final result, and post-game game-quality metrics. No API key is required. Data is available from 2008 to present.

Usage

torvik_game_schedule(year = most_recent_mbb_season())

Arguments

year

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per game (key columns shown; the ⁠_1⁠/⁠_2⁠ suffixes denote team1 and team2):

col_name	types	description
muid	character	Matchup unique id.
date	character	Game date (M/D/YY).
conmatch	character	Conference matchup descriptor.
matchup	character	Ranked-matchup descriptor.
prediction	character	Pre-game prediction (favorite, score, win %).
ttq	numeric	Torvik Thrill Quotient (game excitement).
conf	numeric	Conference-game flag.
venue	numeric	Venue / neutral-site flag.
team1	character	Team 1 name.
t1oe	numeric	Team 1 offensive efficiency in the game.
t1de	numeric	Team 1 defensive efficiency in the game.
team2	character	Team 2 name.
t2oe	numeric	Team 2 offensive efficiency in the game.
t2de	numeric	Team 2 defensive efficiency in the game.
gp	numeric	Game-played flag (1 if completed).
result	character	Final result string.
tempo	numeric	Game tempo (possessions).
possessions	numeric	Possessions in the game.
t1pts	numeric	Team 1 points.
t2pts	numeric	Team 2 points.
winner	character	Winning team.
loser	character	Losing team.
gamevalue	numeric	Game quality value.
t1ppp	numeric	Team 1 points per possession.
t2ppp	numeric	Team 2 points per possession.
overtimes	numeric	Number of overtimes.
year	integer	Season (echoes the `year` argument).

Additional adjusted-efficiency, quality, and ranking columns (t1adjo, t2adjd, t1qual, mismatch, t1rk, ...) are also returned.

Examples


  try(torvik_game_schedule(year = 2024))

Bart Torvik Game Stats

Description

Get per-game team statistics from barttorvik.com.

Pulls one row per team-game for a season (the getgamestats.php export): adjusted and raw offensive/defensive efficiency, the four factors on both ends, tempo, the result, pre-game win probability, and the opposing coach. No API key is required. barttorvik does not publish column headers for this file, so the column names below are mapped from its observed positional layout. Data is available from 2008 to present.

Usage

torvik_game_stats(year = most_recent_mbb_season())

Arguments

year

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per team-game:

col_name	types	description
date	character	Game date (M/D/YY).
type	numeric	Game-type flag.
team	character	Team name.
conf	character	Team conference.
opp	character	Opponent name.
venue	character	Venue relative to `team` (`H`/`A`/`N`).
result	character	Result string (e.g. `⁠L, 78-73⁠`).
adj_oe	numeric	Adjusted offensive efficiency.
adj_de	numeric	Adjusted defensive efficiency.
oe	numeric	Raw offensive efficiency (points/100 poss).
off_efg	numeric	Offensive effective field goal percentage.
off_to	numeric	Offensive turnover percentage.
off_or	numeric	Offensive rebound percentage.
off_ftr	numeric	Offensive free-throw rate.
de	numeric	Raw defensive efficiency (points allowed/100 poss).
def_efg	numeric	Defensive effective field goal percentage allowed.
def_to	numeric	Defensive turnover percentage forced.
def_or	numeric	Defensive (opponent) rebound percentage.
def_ftr	numeric	Defensive free-throw rate allowed.
game_score	numeric	Bart Torvik single-game quality score.
opp_conf	character	Opponent conference.
year	integer	Season (4-digit ending-year).
tempo	numeric	Game tempo (possessions).
muid	character	Matchup unique id.
coach	character	Team head coach.
opp_coach	character	Opponent head coach.
win_prob	numeric	Pre-game win probability for `team`.

Examples


  try(torvik_game_stats(year = 2024))

Bart Torvik NCAA Tournament Results

Description

Get historical NCAA tournament performance from barttorvik.com, by team, coach, conference or seed.

Returns raw and adjusted NCAA tournament results, including PASE (performance above seed expectation) and PAKE (performance above KenPom expectation) plus round-by-round appearance counts. No API key is required. Data runs from 2000 to present.

Usage

torvik_ncaa_results(min_year, max_year, type = "team")

Arguments

min_year

(integer required): Minimum tournament year (4-digit, e.g. 2010).

max_year

(integer required): Maximum tournament year (4-digit, e.g. 2024).

type

(character optional): Aggregation level. One of team (default), coach, conf, or seed.

Value

A hoopR_data tibble with one row per team/coach/conference/seed:

col_name	types	description
rk	integer	Rank within the queried split.
team	character	Team / coach / conference / seed (per `type`).
pake	numeric	Performance above KenPom expectation (wins).
pase	numeric	Performance above seed expectation (wins).
wins	integer	Total tournament wins.
loss	integer	Total tournament losses.
w_percent	numeric	Tournament win percentage.
r64	integer	Round of 64 appearances.
r32	integer	Round of 32 appearances.
s16	integer	Sweet 16 appearances.
e8	integer	Elite 8 appearances.
f4	integer	Final 4 appearances.
f2	integer	Championship-game appearances.
champ	integer	National championships.
top2	integer	Top-2 (runner-up or champion) finishes.
f4_percent	numeric	Final 4 rate.
champ_percent	numeric	Championship rate.
min_year	integer	Minimum year queried (echoes `min_year`).
max_year	integer	Maximum year queried (echoes `max_year`).
type	character	Aggregation level queried (echoes `type`).

Examples


  try(torvik_ncaa_results(min_year = 2010, max_year = 2024, type = "conf"))

Bart Torvik Player Season Stats

Description

Get player advanced season statistics from barttorvik.com.

Pulls every player's advanced season stat line for a year (the getadvstats.php CSV export). No API key is required. barttorvik does not publish column headers for this file, so the column names below are mapped from Bart Torvik's standard player advanced-stats layout (consistent from 2010 onward). Data is available from 2008 to present.

Usage

torvik_player_stats(year = most_recent_mbb_season())

Arguments

year

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per player (key columns shown):

col_name	types	description
player_name	character	Player name.
team	character	Team name.
conf	character	Conference abbreviation.
games	integer	Games played.
min_pct	numeric	Percentage of available minutes played.
o_rtg	numeric	Offensive rating (points produced per 100 poss).
usage	numeric	Usage rate.
e_fg	numeric	Effective field goal percentage.
ts_pct	numeric	True shooting percentage.
orb_pct	numeric	Offensive rebound percentage.
drb_pct	numeric	Defensive rebound percentage.
ast_pct	numeric	Assist percentage.
to_pct	numeric	Turnover percentage.
ft_pct	numeric	Free-throw percentage.
two_p_pct	numeric	Two-point field goal percentage.
three_p_pct	numeric	Three-point field goal percentage.
blk_pct	numeric	Block percentage.
stl_pct	numeric	Steal percentage.
ftr	numeric	Free-throw rate.
class	character	Class (Fr/So/Jr/Sr).
height	character	Listed height.
porpag	numeric	Points over replacement per adjusted game.
adj_oe	numeric	Adjusted offensive efficiency.
year	integer	Season (4-digit ending-year).
player_id	integer	Bart Torvik player id.
hometown	character	Player hometown.
bpm	numeric	Box plus/minus.
obpm	numeric	Offensive box plus/minus.
dbpm	numeric	Defensive box plus/minus.
role	character	Bart Torvik player role/position label.
pts	numeric	Points per game.

Additional made/attempt splits (ftm/fta, two_pm/two_pa, three_pm/three_pa), rim/mid/dunk shooting splits, defensive ratings (drtg, adrtg, stops), and game-box averages (oreb, dreb, ast, stl, blk) are also returned.

Examples


  try(torvik_player_stats(year = 2024))

Bart Torvik T-Rank Ratings

Description

Get year-end / current T-Rank team ratings and adjusted efficiencies from barttorvik.com.

Pulls the full T-Rank team table for a season (the ⁠{year}_team_results.csv⁠ file). No API key is required. Data is available from 2008 to present.

Usage

torvik_ratings(year = most_recent_mbb_season())

Arguments

year

(integer required): Season, in 4-digit ending-year format (e.g. 2024 for the 2023-24 season). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per team:

col_name	types	description
rank	integer	Overall T-Rank (barthag) rank.
team	character	Team name.
conf	character	Conference abbreviation.
record	character	Overall win-loss record.
adjoe	numeric	Adjusted offensive efficiency (pts/100 poss).
oe_rank	integer	National rank of adjusted offensive efficiency.
adjde	numeric	Adjusted defensive efficiency (pts/100 poss).
de_rank	integer	National rank of adjusted defensive efficiency.
barthag	numeric	Power rating: win probability vs. an average team.
proj_w	numeric	Projected wins.
proj_l	numeric	Projected losses.
pro_con_w	numeric	Projected conference wins.
pro_con_l	numeric	Projected conference losses.
con_rec	character	Conference record.
sos	numeric	Strength of schedule.
ncsos	numeric	Non-conference strength of schedule.
consos	numeric	Conference strength of schedule.
qual_o	numeric	Quality-adjusted offensive efficiency.
qual_d	numeric	Quality-adjusted defensive efficiency.
qual_barthag	numeric	Quality-adjusted power rating.
wab	numeric	Wins above bubble.
wab_rk	integer	National rank of wins above bubble.
adjt	numeric	Adjusted tempo (possessions per 40 minutes).
year	integer	Season (4-digit ending-year; echoes the `year` argument).

Additional projected / opponent / conference split columns (proj_sos, opp_oe, con_adj_oe, con_pf, fun, ...) are also returned.

Examples


  try(torvik_ratings(year = 2024))

Bart Torvik Team Four Factors

Description

Get team four-factor and shooting splits from barttorvik.com.

Pulls the season four-factors table (the ⁠{year}_fffinal.csv⁠ file): effective field goal %, turnover %, offensive/defensive rebound %, free-throw rate, plus 2P/3P/FT shooting splits and assist rates – each paired with its national rank. No API key is required. Data is available from 2008 to present.

Usage

torvik_team_factors(year = most_recent_mbb_season())

Arguments

year

(integer required): Season, in 4-digit ending-year format (e.g. 2024). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per team. Each statistic is paired with an interspersed national-rank column (rk, rk_2, ...):

col_name	types	description
team_name	character	Team name.
e_fg_percent	numeric	Effective field goal percentage (offense).
e_fg_percent_def	numeric	Effective field goal percentage allowed (defense).
ftr	numeric	Free-throw rate (offense).
ftr_def	numeric	Free-throw rate allowed (defense).
or_percent	numeric	Offensive rebound percentage.
dr_percent	numeric	Defensive rebound percentage.
to_percent	numeric	Turnover percentage (offense).
to_percent_def	numeric	Turnover percentage forced (defense).
x3p_percent	numeric	Three-point percentage (offense).
x3p_d_percent	numeric	Three-point percentage allowed (defense).
x2p_percent	numeric	Two-point percentage (offense).
x2p_percent_d	numeric	Two-point percentage allowed (defense).
ft_percent	numeric	Free-throw percentage (offense).
ft_percent_d	numeric	Free-throw percentage allowed (defense).
x3p_rate	numeric	Three-point attempt rate (offense).
x3p_rate_d	numeric	Three-point attempt rate allowed (defense).
arate	numeric	Assist rate (offense).
arate_d	numeric	Assist rate allowed (defense).
year	integer	Season (echoes the `year` argument).

Examples


  try(torvik_team_factors(year = 2024))

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)

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.

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.

Value

Returns a logical value (TRUE/FALSE)

Build/update hoopR NBA Stats database

Description

update_nba_stats_db() writes one or more NBA Stats API datasets into a database. Mirrors the NBA / MBB ⁠update_*_db()⁠ shape but points at the ⁠load_nba_stats_*⁠ family. Each dataset is written to its own table, named ⁠nba_stats_<dataset>⁠.

Usage

update_nba_stats_db(
  dbdir = ".",
  dbname = "hoopR_db",
  datasets = NULL,
  seasons = TRUE,
  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.

datasets

Character vector of dataset shortnames (see Details).

seasons

Optional integer vector of seasons to load. Defaults to all available seasons (seasons = TRUE).

db_connection

A DBIConnection object. When supplied, dbdir and dbname are ignored.

Details

Unlike update_nba_db(), there is no historical "play-by-play table" default to preserve, so datasets is required.

Valid datasets values: "coaches", "draft", "game_lineups", "game_rosters", "lineups", "officials", "pbp", "player_boxscores", "player_game_logs", "player_season_stats", "possessions", "rosters", "schedule", "shots", "standings", "team_boxscores", "team_season_stats".

Value

Invisibly returns TRUE on success.

year to season (XXXX -> XXXX-YY)

Description

year to season (XXXX -> XXXX-YY)

Usage

year_to_season(year)

Arguments

year

Four digit year (XXXX)

Package {hoopR}

hoopR: Access Men's Basketball Play by Play Data

Description

Details

Author(s)

See Also

Deterministic blocked fuzzy matcher (greedy within block)

Description

Usage

Arguments

Value

Normalize a college team name for cross-source matching (contracting form)

Description

Usage

Normalize a person name for cross-source matching

Description

Usage

Normalize a team name for cross-source matching

Description

Usage

Reduce a timestamp (UTC datetime, ISO string, or Date) to the local ET date

Description

Usage

Internal: parse a Basketball-Reference HTML table by id using data-stat keys

Description

Usage

Arguments

Value

Internal: GET a Basketball-Reference page and return the response body text

Description

Usage

Arguments

Value

Build player roster lookup from boxscore data

Description

Capture the calling function's formal arguments

Description

Usage

Details

Value

Internal: perform a GET against the CollegeBasketballData API

Description

Usage

Arguments

Value

Internal: fetch a URL and return the parsed HTML document

Description

Usage

Arguments

Value

Minimal brace-template interpolator

Description

Usage

Arguments

Details

Value

Fetch a KenPom page as parsed HTML using an authenticated cookie jar

Description

Usage

Arguments

Value

KenPom headers as a named list (for httr2 req_headers)

Description

Usage

Build an httr2 request with KenPom headers and cookie jar

Description

Usage

Arguments

Value

Internal: extract and parse the Next.js ⁠__NEXT_DATA__⁠ JSON from a page

Description

Usage

Arguments

Value

Internal: coerce a currency-formatted character vector to numeric

Description

Usage

Arguments

Value

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

Internal: extract and parse the Next.js `⁠__NEXT_DATA__⁠` JSON from a page

Internal: fetch a RealGM page and parse it into an `xml_document`

Internal: finalize a RealGM table as a `hoopR_data` tibble