Build player roster lookup from boxscore data
Description
Build player roster lookup from boxscore data
Add players on court in NBA Stats API play-by-play
Description
Add players on court in NBA Stats API play-by-play
Add players on court in NBA Stats API V3 play-by-play
Description
Add players on court in NBA Stats API V3 play-by-play
Convert V3 PBP columns to V2-compatible format
Description
Convert V3 PBP columns to V2-compatible format
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())bref_awards(season = most_recent_nba_season())
Arguments
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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).
|
See Also
Other Basketball-Reference Functions:
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_awards(season = 2024))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())bref_draft(season = most_recent_nba_season())
Arguments
season |
(integer required): Draft year (e.g. |
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).
|
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_draft(season = 2024))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()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. |
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_injuries())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")bref_player_bios(letter = "a")
Arguments
letter |
(character required): Single letter |
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).
|
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_player_bios(letter = "a"))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())bref_player_game_log(player_id, season = most_recent_nba_season())
Arguments
player_id |
(character required): Basketball-Reference player id slug
(e.g. |
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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.
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_players_stats(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_player_game_log(player_id = "jokicni01", season = 2024))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")bref_players_stats(season = most_recent_nba_season(), table = "per_game")
Arguments
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
table |
(character optional): Which stat table to return. One of
|
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.
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_standings(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_players_stats(season = 2024, table = "per_game"))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())bref_standings(season = most_recent_nba_season())
Arguments
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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).
|
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_team_roster(),
bref_teams_stats()
Examples
try(bref_standings(season = 2024))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())bref_team_roster(team, season = most_recent_nba_season())
Arguments
team |
(character required): Basketball-Reference team abbreviation
(e.g. |
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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).
|
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_teams_stats()
Examples
try(bref_team_roster(team = "BOS", season = 2024))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")bref_teams_stats(season = most_recent_nba_season(), table = "per_game")
Arguments
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
table |
(character optional): Which team table to return. One of
|
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).
|
See Also
Other Basketball-Reference Functions:
bref_awards(),
bref_draft(),
bref_injuries(),
bref_player_bios(),
bref_player_game_log(),
bref_players_stats(),
bref_standings(),
bref_team_roster()
Examples
try(bref_teams_stats(season = 2024, table = "per_game"))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)cbbd_conferences() cbbd_conferences_history(conference = NULL)
Arguments
conference |
(character optional): Conference abbreviation filter
(e.g. |
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"))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 )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. |
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))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)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. |
season_type |
(character optional): One of |
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 |
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"))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()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. |
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())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)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. |
team |
(character required): Team name (e.g. |
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
|
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))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()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
|
shooting_plays_only |
(logical optional): If |
player_id |
(integer required): Athlete id. |
season |
(integer required): Season, 4-digit ending-year (e.g. |
team |
(character required): Team name (e.g. |
date |
(character required): Date-time in ISO 8601 format
(e.g. |
utc_offset |
(numeric optional): UTC offset (hours) for the date. |
tournament |
(character required): Tournament name (e.g. |
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 (same columns as
cbbd_plays_game()).
A hoopR_data tibble with one row per play (same columns as
cbbd_plays_game()).
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())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 )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. |
season_type |
(character optional): One of |
week |
(integer optional): Poll week filter. |
poll_type |
(character optional): One of |
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"))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 )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. |
team |
(character optional): Team name filter (e.g. |
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))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 )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. |
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))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 )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. |
season_type |
(character optional): One of |
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"))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)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
|
player_id |
(integer required): Athlete id. |
season |
(integer required): Season, 4-digit ending-year (e.g. |
team |
(character required): Team name (e.g. |
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()).
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"))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)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. |
season |
(integer optional): Season, in 4-digit format ending-year
(e.g. |
team |
(character optional): Team name filter (e.g. |
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. |
See Also
Other CBD Teams Functions:
cbbd_teams_directory(),
cbbd_teams_season_overview()
Examples
try(cbbd_teams(conference = "ACC")) try(cbbd_teams_roster(season = 2024, team = "Duke"))try(cbbd_teams(conference = "ACC")) try(cbbd_teams_roster(season = 2024, team = "Duke"))
CBD Team Directory
Description
Get the full team directory and conference metadata for a season from the CollegeBasketballData API.
Usage
cbbd_teams_directory(season = most_recent_mbb_season())cbbd_teams_directory(season = most_recent_mbb_season())
Arguments
season |
(integer required): Season, in 4-digit format ending-year
(e.g. |
Value
A named list of two hoopR_data tibbles, teams and conferences.
Both carry the season as attributes: season (integer) and
season_label (character, the upstream season label).
teams: one row per team
| col_name | type | 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 display name (school and mascot). |
| short_display_name | character | Short display name. |
| conference_id | integer | Conference id for the season; joins to id in conferences.
|
conferences: one row per conference
| col_name | type | description |
| id | integer | Conference id. |
| name | character | Conference name. |
| abbreviation | character | Conference abbreviation. |
See Also
Other CBD Teams Functions:
cbbd_teams(),
cbbd_teams_season_overview()
Examples
try(cbbd_teams_directory(season = 2025))try(cbbd_teams_directory(season = 2025))
CBD Team Season Overview
Description
Get a stored full-season overview of one team from the CollegeBasketballData API.
Usage
cbbd_teams_season_overview(team_id, season = most_recent_mbb_season())cbbd_teams_season_overview(team_id, season = most_recent_mbb_season())
Arguments
team_id |
(integer required): CollegeBasketballData team id. See
|
season |
(integer required): Season, in 4-digit format ending-year
(e.g. |
Value
A named list of hoopR_data tibbles, one per section of the overview.
team, record, ratings, efficiency and sources are one row each;
shooting (one row per shot bucket), players (one row per player) and
schedule (one row per game) are row tables. shooting also carries the
attributes tracked_attempts (integer) and coverage, and players carries
coverage: a list of state, reason, coveredGames and eligibleGames.
A section upstream leaves empty comes back as a 0-column tibble. Types
follow the values: a field upstream sends as null parses as logical NA,
a whole-number value as integer, and a nullable object sent as null
(e.g. the adjusted ratings) as one NA column in place of its fields.
team: one row
| col_name | type | description |
| team_id | integer | CollegeBasketballData team id. |
| season | integer | Season, as the 4-digit ending year (e.g. 2025 for 2024-25). |
| season_label | character | Season label as upstream formats it. |
| generated_at | character | When upstream built this overview (ISO 8601, UTC). |
| format_version | integer | Version of the upstream overview format. |
| mascot | character | Team mascot. |
| school | character | School name. |
| source_id | character | Source (ESPN) team id. |
| conference_id | integer | Conference id. |
| conference_name | character | Conference name. |
| conference_abbreviation | character | Conference abbreviation. |
record: one row
| col_name | type | description |
| overall_wins | integer | Wins in all games. |
| overall_games | integer | Number of all games in the record. |
| overall_losses | integer | Losses in all games. |
| overall_unresolved | integer | All games without a final result yet. |
| complete | logical | Whether every game in the record has a final result. |
| conference_wins | integer | Wins in conference games. |
| conference_games | integer | Number of conference games in the record. |
| conference_losses | integer | Losses in conference games. |
| conference_unresolved | integer | Conference games without a final result yet. |
| unknown_conference_games | integer | Games whose conference-game status is unknown. |
| unknown_eligibility_games | integer | Games whose eligibility for the overview is unknown. |
ratings: one row
| col_name | type | description |
| elo | double | Elo rating. |
| srs | double | Simple Rating System rating: average scoring margin adjusted for strength of schedule. |
| polls_ap_date | character | Date of the AP poll the standing comes from (YYYY-MM-DD). |
| polls_ap_rank | integer | AP poll rank; NA when unranked. |
| polls_ap_week | integer | Week of that AP poll. |
| polls_ap_state | character | AP poll standing (e.g. ranked). |
| polls_ap_season_type | character | Season type of that AP poll (regular or postseason). |
| polls_coaches_date | character | Date of the Coaches poll the standing comes from (YYYY-MM-DD). |
| polls_coaches_rank | integer | Coaches poll rank; NA when unranked. |
| polls_coaches_week | integer | Week of that Coaches poll. |
| polls_coaches_state | character | Coaches poll standing (e.g. ranked). |
| polls_coaches_season_type | character | Season type of that Coaches poll (regular or postseason). |
| adjusted_net_rank | integer | Rank of the adjusted net rating among the rated teams (1 is best). |
| adjusted_net_value | double | Adjusted net efficiency: adjusted offense minus adjusted defense. |
| adjusted_defense_rank | integer | Rank of the adjusted defense rating among the rated teams (1 is best). |
| adjusted_defense_value | double | Opponent-adjusted defensive efficiency: points allowed per 100 possessions against an average offense (lower is better). |
| adjusted_offense_rank | integer | Rank of the adjusted offense rating among the rated teams (1 is best). |
| adjusted_offense_value | double | Opponent-adjusted offensive efficiency: points scored per 100 possessions against an average defense. |
| adjusted_population | integer | Number of teams in the adjusted ratings. |
efficiency: one row; each defense_ column is the opponents' version of its offense_ twin
| col_name | type | description |
| pace | double | Pace: possessions per 40 minutes. |
| defense_points | integer | Points allowed. |
| defense_box_score_fouls | integer | Opponents' personal fouls. |
| defense_box_score_blocks | integer | Opponents' blocked shots. |
| defense_box_score_steals | integer | Opponents' steals. |
| defense_box_score_assists | integer | Opponents' assists. |
| defense_box_score_minutes | integer | Opponents' minutes played (team minutes). |
| defense_box_score_rebounds_total | integer | Opponents' total rebounds. |
| defense_box_score_rebounds_defensive | integer | Opponents' defensive rebounds. |
| defense_box_score_rebounds_offensive | integer | Opponents' offensive rebounds. |
| defense_box_score_turnovers | integer | Opponents' turnovers credited to players. |
| defense_box_score_field_goals_pct | double | Opponents' field goals percentage (0-100). |
| defense_box_score_field_goals_made | integer | Opponents' field goals made. |
| defense_box_score_field_goals_attempted | integer | Opponents' field goals attempted. |
| defense_box_score_free_throws_pct | double | Opponents' free throws percentage (0-100). |
| defense_box_score_free_throws_made | integer | Opponents' free throws made. |
| defense_box_score_free_throws_attempted | integer | Opponents' free throws attempted. |
| defense_box_score_flagrant_fouls | integer | Opponents' flagrant fouls. |
| defense_box_score_points_in_paint | integer | Opponents' points in the paint. |
| defense_box_score_team_turnovers | integer | Opponents' team turnovers (not credited to a player). |
| defense_box_score_technical_fouls | integer | Opponents' technical fouls. |
| defense_box_score_fast_break_points | integer | Opponents' fast-break points. |
| defense_box_score_true_shooting_pct | double | Opponents' true shooting percentage (0-100). |
| defense_box_score_points_off_turnovers | integer | Opponents' points off turnovers. |
| defense_box_score_two_point_field_goals_pct | double | Opponents' two-point field goals percentage (0-100). |
| defense_box_score_two_point_field_goals_made | integer | Opponents' two-point field goals made. |
| defense_box_score_two_point_field_goals_attempted | integer | Opponents' two-point field goals attempted. |
| defense_box_score_three_point_field_goals_pct | double | Opponents' three-point field goals percentage (0-100). |
| defense_box_score_three_point_field_goals_made | integer | Opponents' three-point field goals made. |
| defense_box_score_three_point_field_goals_attempted | integer | Opponents' three-point field goals attempted. |
| defense_raw_rating | double | Points allowed per 100 opponent possessions, not adjusted for opponent. |
| defense_possessions | integer | Opponent possessions. |
| defense_turnover_pct | double | Opponents' turnovers per 100 possessions. |
| defense_free_throw_rate | double | Opponents' free throw attempts per 100 field goal attempts. |
| defense_offensive_rebound_pct | double | Opponents' offensive rebound percentage (0-100). |
| defense_effective_field_goal_pct | double | Opponents' effective field goal percentage (0-100). |
| offense_points | integer | Points scored. |
| offense_box_score_fouls | integer | Team personal fouls. |
| offense_box_score_blocks | integer | Team blocked shots. |
| offense_box_score_steals | integer | Team steals. |
| offense_box_score_assists | integer | Team assists. |
| offense_box_score_minutes | integer | Team minutes played (team minutes). |
| offense_box_score_rebounds_total | integer | Team total rebounds. |
| offense_box_score_rebounds_defensive | integer | Team defensive rebounds. |
| offense_box_score_rebounds_offensive | integer | Team offensive rebounds. |
| offense_box_score_turnovers | integer | Team turnovers credited to players. |
| offense_box_score_field_goals_pct | double | Team field goals percentage (0-100). |
| offense_box_score_field_goals_made | integer | Team field goals made. |
| offense_box_score_field_goals_attempted | integer | Team field goals attempted. |
| offense_box_score_free_throws_pct | double | Team free throws percentage (0-100). |
| offense_box_score_free_throws_made | integer | Team free throws made. |
| offense_box_score_free_throws_attempted | integer | Team free throws attempted. |
| offense_box_score_flagrant_fouls | integer | Team flagrant fouls. |
| offense_box_score_points_in_paint | integer | Team points in the paint. |
| offense_box_score_team_turnovers | integer | Team team turnovers (not credited to a player). |
| offense_box_score_technical_fouls | integer | Team technical fouls. |
| offense_box_score_fast_break_points | integer | Team fast-break points. |
| offense_box_score_true_shooting_pct | double | Team true shooting percentage (0-100). |
| offense_box_score_points_off_turnovers | integer | Team points off turnovers. |
| offense_box_score_two_point_field_goals_pct | double | Team two-point field goals percentage (0-100). |
| offense_box_score_two_point_field_goals_made | integer | Team two-point field goals made. |
| offense_box_score_two_point_field_goals_attempted | integer | Team two-point field goals attempted. |
| offense_box_score_three_point_field_goals_pct | double | Team three-point field goals percentage (0-100). |
| offense_box_score_three_point_field_goals_made | integer | Team three-point field goals made. |
| offense_box_score_three_point_field_goals_attempted | integer | Team three-point field goals attempted. |
| offense_raw_rating | double | Points scored per 100 possessions, not adjusted for opponent. |
| offense_possessions | integer | Possessions. |
| offense_turnover_pct | double | Team turnovers per 100 possessions. |
| offense_free_throw_rate | double | Team free throw attempts per 100 field goal attempts. |
| offense_offensive_rebound_pct | double | Team offensive rebound percentage (0-100). |
| offense_effective_field_goal_pct | double | Team effective field goal percentage (0-100). |
| coverage_state | character | Whether the play-by-play this section needs is available (e.g. available, partial). |
| coverage_reason | character | Why coverage is not complete (e.g. unclassified_shots); NA when available. |
| coverage_covered_games | integer | Games with the data this section needs. |
| coverage_eligible_games | integer | Games eligible for this section. |
| pace_games | integer | Games in the pace sample. |
shooting: one row per shot bucket
| col_name | type | description |
| key | character | Shot bucket: at_rim, two_point_jumper or three_point_jumper. |
| made | integer | Field goals made from the bucket. |
| attempts | integer | Field goal attempts from the bucket. |
| attempt_pct | double | Share of the team's classified tracked attempts taken from the bucket (0-100). |
| field_goal_pct | double | Field goal percentage from the bucket (0-100). |
players: one row per player
| col_name | type | description |
| name | character | Player name. |
| games | integer | Games played. |
| points | integer | Points. |
| assists | integer | Assists. |
| minutes | integer | Minutes played. |
| complete | logical | Whether upstream marks the player's season line as complete. |
| has_stats | logical | Whether the player has recorded statistics this season. |
| on_roster | logical | Whether the player is on the team's roster. |
| position | character | Position (e.g. G, F, C). |
| rebounds | integer | Rebounds. |
| usage_pct | double | Usage percentage (0-100): share of team possessions the player used while on the floor. |
| athlete_id | integer | CollegeBasketballData athlete id. |
| usage_games | integer | Games in the usage sample. |
| points_per_game | double | Points per game. |
| minutes_per_game | double | Minutes per game. |
| true_shooting_pct | double | True shooting percentage (0-100). |
| effective_field_goal_pct | double | Effective field goal percentage (0-100). |
| season_stats_fouls | integer | Personal fouls. |
| season_stats_blocks | integer | Blocked shots. |
| season_stats_starts | integer | Games started. |
| season_stats_steals | integer | Steals. |
| season_stats_assists | integer | Assists. |
| season_stats_turnovers | integer | Turnovers. |
| season_stats_free_throw_rate | double | Free throw attempts per 100 field goal attempts. |
| season_stats_assist_turnover_ratio | double | Assists per turnover. |
| season_stats_offensive_rebound_pct | double | Offensive rebound percentage (0-100). |
| season_stats_advanced_games | integer | Games in the advanced-stat sample. |
| season_stats_advanced_porpag | double | PORPAG: points over replacement per adjusted game. |
| season_stats_advanced_net_rating | double | Net rating: offensive rating minus defensive rating. |
| season_stats_advanced_defensive_rating | double | Defensive rating: points allowed per 100 possessions while on the floor. |
| season_stats_advanced_offensive_rating | double | Offensive rating: points produced per 100 possessions. |
| season_stats_advanced_win_shares_per40 | double | Win shares per 40 minutes. |
| season_stats_advanced_win_shares_total | double | Win shares. |
| season_stats_advanced_win_shares_defensive | double | Defensive win shares. |
| season_stats_advanced_win_shares_offensive | double | Offensive win shares. |
| season_stats_rebounds_total | integer | Total rebounds. |
| season_stats_rebounds_defensive | integer | Defensive rebounds. |
| season_stats_rebounds_offensive | integer | Offensive rebounds. |
| season_stats_field_goals_pct | double | Field goals percentage (0-100). |
| season_stats_field_goals_made | integer | Field goals made. |
| season_stats_field_goals_attempted | integer | Field goals attempted. |
| season_stats_free_throws_pct | double | Free throws percentage (0-100). |
| season_stats_free_throws_made | integer | Free throws made. |
| season_stats_free_throws_attempted | integer | Free throws attempted. |
| season_stats_two_point_field_goals_pct | double | Two-point field goals percentage (0-100). |
| season_stats_two_point_field_goals_made | integer | Two-point field goals made. |
| season_stats_two_point_field_goals_attempted | integer | Two-point field goals attempted. |
| season_stats_three_point_field_goals_pct | double | Three-point field goals percentage (0-100). |
| season_stats_three_point_field_goals_made | integer | Three-point field goals made. |
| season_stats_three_point_field_goals_attempted | integer | Three-point field goals attempted. |
schedule: one row per game
| col_name | type | description |
| id | integer | CollegeBasketballData game id. |
| venue | character | Venue name. |
| result | character | Result for the team: W or L; NA until final. |
| status | character | Game status (e.g. final). |
| game_type | character | Upstream game type code (e.g. STD, TRNMNT). |
| location | character | Where the team played: home, away or neutral. |
| opponent | character | Opponent school name. |
| start_date | character | Tipoff (ISO 8601, UTC). |
| opponent_id | integer | Opponent's CollegeBasketballData team id. |
| season_type | character | Season type: regular or postseason. |
| team_points | integer | Points scored by the team. |
| eligibility | character | Whether the game counts toward the overview (e.g. counted). |
| calendar_date | character | Local calendar date of the game (YYYY-MM-DD). |
| start_time_tbd | logical | Whether the tipoff time is to be determined. |
| conference_game | logical | Whether the game is a conference game. |
| opponent_points | integer | Points scored by the opponent. |
| opponent_has_profile | logical | Whether the opponent has its own season overview. |
sources: one row
| col_name | type | description |
| notes | character | Upstream notes on how the overview is built, joined with a semicolon. |
| latest_final_start_date | character | Tipoff (ISO 8601, UTC) of the latest final game included. |
| leaderboard_updated_at | character | When the leaderboard data behind the player rows last updated (ISO 8601); NA when upstream sends none. |
See Also
Other CBD Teams Functions:
cbbd_teams(),
cbbd_teams_directory()
Examples
try(cbbd_teams_season_overview(team_id = 72, season = 2025))try(cbbd_teams_season_overview(team_id = 72, season = 2025))
CBD Venues
Description
Get college basketball venues from the CollegeBasketballData API.
Usage
cbbd_venues()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())try(cbbd_venues())
Check Status function
Description
Check Status function
Usage
check_status(res)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)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(...)csv_from_url(...)
Arguments
... |
Arguments passed on to
|
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
Reference data
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)espn_basketball_player_core(payload, athlete_id)
Arguments
payload |
list. One athlete's core-v2 |
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 |
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
See Also
Other Basketball Analytics Utilities:
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
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)# 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 Women's College Basketball Athletes Index
Get ESPN NBA 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, ... )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 |
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. |
... |
Additional arguments; currently unused but retained for
forward compatibility. Proxy configuration should use
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_athletes_index(season = 2025, limit = 50) espn_nba_athletes_index(season = 2025, limit = 50)espn_mbb_athletes_index(season = 2025, limit = 50) espn_nba_athletes_index(season = 2025, limit = 50)
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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_award(award_id = 344, season = 2024) # MVP award id = 33 espn_nba_award(award_id = 33, season = 2024)espn_mbb_award(award_id = 344, season = 2024) # MVP award id = 33 espn_nba_award(award_id = 33, season = 2024)
Get ESPN MBB Calendar
Description
Get ESPN MBB Calendar
Get ESPN Women's College Basketball Calendar
Get ESPN NBA Calendar
Get ESPN NBA Calendar
Usage
espn_mbb_calendar(season = most_recent_mbb_season()) espn_nba_calendar(season = most_recent_nba_season())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. |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_calendar(season = 2025) espn_nba_calendar(season = 2025)espn_mbb_calendar(season = 2025) espn_nba_calendar(season = 2025)
Get ESPN MBB Single-Coach Detail
Description
Returns biography, current team / college refs, and counts of career record entries + per-season coaching entries for one MBB head coach.
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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_coach(coach_id = 32116) espn_nba_coach(coach_id = 52120)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.
Returns a coach's career record by type in long format (one row per
stat in the record's stats[] array). record_type codes commonly
populated: 0 = Total, 1 = Pre Season, 2 = Regular Season, 3 = Post
Season. Use espn_nba_coaches() to discover coach_ids for a season.
Usage
espn_mbb_coach_record(coach_id, record_type = 0L, ...) espn_nba_coach_record(coach_id, record_type = 0L, ...)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 |
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.
A long tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_coach_record(coach_id = 32116, record_type = 2) espn_nba_coach_record(coach_id = 52120, record_type = 2)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, $refs to team/college/
person). ESPN's coverage of this endpoint is sparse; many
(coach × season) combinations return 404.
Per-season coach detail (name, birth info, $refs 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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_coach_season(coach_id = 32116, season = 2025) espn_nba_coach_season(coach_id = 52120, season = 2025)espn_mbb_coach_season(coach_id = 32116, season = 2025) espn_nba_coach_season(coach_id = 52120, season = 2025)
Get ESPN Women's College Basketball Coaches
Description
Get ESPN Women's College Basketball Coaches
Get ESPN Women's College Basketball Coaches
Get ESPN NBA Coaches
Get ESPN NBA Coaches
Usage
espn_mbb_coaches(season = most_recent_mbb_season(), ...) espn_nba_coaches(season = most_recent_nba_season(), ...)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
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_coaches(season = 2025) espn_nba_coaches(season = 2025)espn_mbb_coaches(season = 2025) espn_nba_coaches(season = 2025)
Get ESPN conference names and IDs
Description
Get ESPN conference names and IDs
Get ESPN NBA Conferences
Get ESPN NBA Conferences
Usage
espn_mbb_conferences() espn_nba_conferences()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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_conferences()) try(espn_nba_conferences())try(espn_mbb_conferences()) try(espn_nba_conferences())
Get ESPN MBB Franchise Detail
Description
Returns franchise-level metadata for a men's college basketball program. Franchise IDs are stable across program reorganization or rebrands.
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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_franchise(franchise_id = 150) espn_nba_franchise(franchise_id = 13)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(...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_franchises() espn_nba_franchises()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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_futures(season = 2025) espn_nba_futures(season = 2025)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)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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))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))
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, ...)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
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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)
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, ...)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 |
... |
Additional arguments; currently unused. |
Value
A single-row tibble.
A single-row tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_game_official_detail(event_id = 401256760, order = 1) espn_nba_game_official_detail(event_id = 401283399, order = 1)espn_mbb_game_official_detail(event_id = 401256760, order = 1) espn_nba_game_official_detail(event_id = 401283399, order = 1)
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, ...)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 |
... |
Additional arguments; currently unused. |
Value
A single-row tibble.
A single-row tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_game_play(event_id = 401256760, play_id = 401256760101805901) espn_nba_game_play(event_id = 401283399, play_id = 4012833994)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, ...)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.
A long tibble with one row per on-court athlete.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_game_play_personnel(event_id = 401256760, play_id = 401256760101805901) espn_nba_game_play_personnel(event_id = 401283399, play_id = 4012833994)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, ...)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).
A long tibble with one row per (category x stat).
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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 Women's College Basketball Event Win Probabilities
Get ESPN NBA 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, ...)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 |
... |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_game_probabilities(event_id = "401256760", limit = 50) espn_nba_game_probabilities(event_id = "401283399", limit = 50)espn_mbb_game_probabilities(event_id = "401256760", limit = 50) espn_nba_game_probabilities(event_id = "401283399", limit = 50)
Get ESPN MBB Event Prop Bets (Long Format)
Description
Returns prop-bet markets for one MBB event + provider in long format:
one row per (athlete × prop type). Each row has american / decimal /
fraction odds plus the current target (e.g. over/under line). Hits the
core-v2 competitions/{id}/odds/{provider_id}/propBets endpoint and
auto-paginates.
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, ...)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 |
... |
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).
A long tibble with one row per (athlete × prop type).
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_game_propbets(event_id = 401256760, provider_id = 58) espn_nba_game_propbets(event_id = 401283399, provider_id = 58)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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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, ...)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.
A single-row tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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 Women's College Basketball Injuries
Get ESPN NBA Injuries
Get ESPN NBA Injuries
Usage
espn_mbb_injuries(season = most_recent_mbb_season(), ...) espn_nba_injuries(season = most_recent_nba_season(), ...)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. |
... |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_injuries() espn_nba_injuries()espn_mbb_injuries() espn_nba_injuries()
Get ESPN Women's College Basketball League Leaders
Description
Get ESPN Women's College Basketball League Leaders
Get ESPN Women's College Basketball League Leaders
Get ESPN NBA 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, ...)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
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_leaders(season = 2025, season_type = 2) espn_nba_leaders(season = 2024, season_type = 2)espn_mbb_leaders(season = 2025, season_type = 2) espn_nba_leaders(season = 2024, season_type = 2)
Get ESPN MBB News
Description
Get ESPN MBB News
Get ESPN Women's College Basketball News
Get ESPN NBA News
Get ESPN NBA News
Usage
espn_mbb_news(limit = 50) espn_nba_news(limit = 50)espn_mbb_news(limit = 50) espn_nba_news(limit = 50)
Arguments
limit |
integer. Maximum number of articles to return. Default |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_news(limit = 5) espn_nba_news(limit = 5)espn_mbb_news(limit = 5) espn_nba_news(limit = 5)
Get ESPN Women's College Basketball Athlete Awards
Description
Get ESPN Women's College Basketball Athlete Awards
Get ESPN Women's College Basketball Athlete Awards
Get ESPN NBA Athlete Awards
Get ESPN NBA Athlete Awards
Usage
espn_mbb_player_awards(athlete_id, ...) espn_nba_player_awards(athlete_id, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_player_awards(athlete_id = "4593919") espn_nba_player_awards(athlete_id = "1966")espn_mbb_player_awards(athlete_id = "4593919") espn_nba_player_awards(athlete_id = "1966")
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, ...)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 |
... |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)# 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)
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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_player_eventlog_v2(athlete_id = 4683735, season = 2025) espn_nba_player_eventlog_v2(athlete_id = 1966, season = 2025)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 Women's College Basketball Athlete Info
Get ESPN NBA Athlete Info
Get ESPN NBA Athlete Info
Usage
espn_mbb_player_info(athlete_id, ...) espn_nba_player_info(athlete_id, ...)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
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_player_info(athlete_id = "4593919") espn_nba_player_info(athlete_id = "1966")espn_mbb_player_info(athlete_id = "4593919") espn_nba_player_info(athlete_id = "1966")
Get ESPN Women's College Basketball Athlete Overview
Description
Get ESPN Women's College Basketball Athlete Overview
Get ESPN Women's College Basketball Athlete Overview
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 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(), ... )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 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 |
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)# 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)
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)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_player_stats(athlete_id = 4593919, year = 2021)) try(espn_nba_player_stats(athlete_id = 1966, year = 2022))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, ...)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.
A single-row tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_position(position_id = 1) espn_nba_position(position_id = 1)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(...)espn_mbb_positions(...) espn_nba_positions(...)
Arguments
... |
Additional arguments; currently unused. |
Value
A tibble with one row per position.
A tibble with one row per position.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_positions() espn_nba_positions()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), ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_powerindex(season = 2025) espn_nba_powerindex(season = 2025)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()espn_mbb_rankings()
Value
Returns a tibble
| col_name | types | description |
| id | integer | Id. |
| name | character | Display name. |
| short_name | character | Short display name. |
| type | character | Record type / category. |
| headline | character | News headline. |
| short_headline | character | Short news headline. |
| current | integer | Current. |
| previous | integer | Previous. |
| points | numeric | Points scored. |
| first_place_votes | integer | First place votes. |
| trend | character | Trend. |
| date | character | Date in YYYY-MM-DD format. |
| last_updated | character | Last updated. |
| record_summary | character | Win-loss record summary string. |
| team_id | integer | Unique team identifier. |
| team_uid | character | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
| team_location | character | Team city or location string. |
| team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
| team_nickname | character | Team nickname. |
| team_abbreviation | character | Short team abbreviation (e.g. 'LAS'). |
| team_color | character | Team primary color (hex without leading '#'). |
| team_logo | character | Team logo image URL. |
| occurrence_number | integer | Occurrence number. |
| occurrence_type | character | Occurrence type. |
| occurrence_last | logical | Occurrence last. |
| occurrence_value | character | Occurrence value. |
| occurrence_display_value | character | Occurrence display value. |
| season_year | integer | Season year string ('YYYY-YY' format). |
| season_start_date | character | Date in YYYY-MM-DD format. |
| season_end_date | character | Date in YYYY-MM-DD format. |
| season_display_name | character | Season display label. |
| season_type_type | integer | Season type type. |
| season_type_name | character | Season type name. |
| season_type_abbreviation | character | Season type abbreviation. |
| season_futures_ref | character | Season futures ref. |
| first_occurrence_type | character | First occurrence type. |
| first_occurrence_value | character | First occurrence value. |
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Examples
# Get current AP and Coaches Poll rankings try(espn_mbb_rankings())# 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)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. |
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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 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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_awards(season = 2024) espn_nba_season_awards(season = 2024)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, ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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)
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), ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_groups(season = 2025) espn_nba_season_groups(season = 2025)espn_mbb_season_groups(season = 2025) espn_nba_season_groups(season = 2025)
Get ESPN Women's College Basketball Season Info
Description
Get ESPN Women's College Basketball Season Info
Get ESPN Women's College Basketball Season Info
Get ESPN NBA 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(), ...)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
|
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 |
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 |
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_info(season = 2025) espn_nba_season_info(season = 2025)espn_mbb_season_info(season = 2025) espn_nba_season_info(season = 2025)
Get ESPN MBB Season Leaders (Long Format)
Description
Returns the per-category leaderboard for one (MBB season x season-type), in long format. Each row is one (category x rank) entry, e.g. "Points Per Game x rank 1 x LeBron James".
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), ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_leaders(season = 2025) espn_nba_season_leaders(season = 2025)espn_mbb_season_leaders(season = 2025) espn_nba_season_leaders(season = 2025)
Get ESPN MBB Season Ranking Detail
Description
Returns the per-week snapshot index for one ranking source (e.g. AP
Top 25). Each row is one weekly snapshot; the ref URL resolves to
the actual ranked teams for that (season-type x week) and will be
wrapped by a forthcoming espn_LOWERMBB_week_ranking().
Returns the per-week snapshot index for one ranking source (e.g. AP
Top 25). Each row is one weekly snapshot; the ref URL resolves to
the actual ranked teams for that (season-type x week) and will be
wrapped by a forthcoming espn_nba_week_ranking().
Usage
espn_mbb_season_ranking(ranking_id, season = most_recent_mbb_season(), ...) espn_nba_season_ranking(ranking_id, season = most_recent_nba_season(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_ranking(ranking_id = 1, season = 2025) espn_nba_season_ranking(ranking_id = 1, season = 2025)espn_mbb_season_ranking(ranking_id = 1, season = 2025) espn_nba_season_ranking(ranking_id = 1, season = 2025)
Get ESPN MBB Season Rankings Index
Description
Returns the index of season-level rankings recorded for one MBB season.
Typical sources: AP Top 25 (id 1), Coaches Poll (id 2). Pass an
ranking_id to espn_mbb_season_ranking() for the ranked teams.
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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_rankings(season = 2025) espn_nba_season_rankings(season = 2025)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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_type(season_type = 2, season = 2025) espn_nba_season_type(season_type = 2, season = 2025)espn_mbb_season_type(season_type = 2, season = 2025) espn_nba_season_type(season_type = 2, season = 2025)
Get ESPN MBB Season Types Index
Description
Returns the index of season-type IDs that exist for one MBB season
(typically 1 = preseason, 2 = regular, 3 = postseason, 4 = off-season).
Pass an ID to espn_mbb_season_type() for the start/end dates and
whether that type carries groups, standings, or legs.
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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_types(season = 2025) espn_nba_season_types(season = 2025)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).
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, ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_week(week = 5, season = 2025) espn_nba_season_week(week = 5, season = 2025)espn_mbb_season_week(week = 5, season = 2025) espn_nba_season_week(week = 5, season = 2025)
Get ESPN MBB Season Weeks Index
Description
Returns the list of week IDs for one (MBB season x season-type). MBB uses a week structure inherited from ESPN's schema, but week-level rankings are populated only for college (MBB / WBB).
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), ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_season_weeks(season = 2025) espn_nba_season_weeks(season = 2025)espn_mbb_season_weeks(season = 2025) espn_nba_season_weeks(season = 2025)
Get ESPN Women's College Basketball Seasons
Description
Get ESPN Women's College Basketball Seasons
Get ESPN Women's College Basketball Seasons
Get ESPN NBA Seasons
Get ESPN NBA Seasons
Usage
espn_mbb_seasons(...) espn_nba_seasons(...)espn_mbb_seasons(...) espn_nba_seasons(...)
Arguments
... |
Additional arguments; currently unused but retained for
forward compatibility. Proxy configuration should use
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_seasons() espn_nba_seasons()espn_mbb_seasons() espn_nba_seasons()
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)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. |
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_standings(2021)) try(espn_nba_standings(year = 2021))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(), ...)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
|
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.
ESPN's roster endpoint ignores the season, so a season before the current
one is built from that season's published player box scores (name, jersey,
position and headshot from the athlete's last game; bio columns NA), and
errors when none are published.
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.
ESPN's roster endpoint ignores the season, so a season before the current
one is built from that season's published player box scores (name, jersey,
position and headshot from the athlete's last game; bio columns NA), and
errors when none are published.
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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)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
A teams data frame
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_team_current_roster(team_id = 150)) try(espn_nba_team_current_roster(team_id = 13))try(espn_mbb_team_current_roster(team_id = 150)) try(espn_nba_team_current_roster(team_id = 13))
Get ESPN Women's College Basketball Team Injuries
Description
Get ESPN Women's College Basketball Team Injuries
Get ESPN Women's College Basketball Team Injuries
Get ESPN NBA Team Injuries
Get ESPN NBA Team Injuries
Usage
espn_mbb_team_injuries(team_id, ...) espn_nba_team_injuries(team_id, ...)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 |
... |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_injuries(team_id = "150") espn_nba_team_injuries(team_id = "13")espn_mbb_team_injuries(team_id = "150") espn_nba_team_injuries(team_id = "13")
Get ESPN MBB Team News
Description
Get ESPN MBB Team News
Get ESPN Women's College Basketball Team News
Get ESPN NBA Team News
Get ESPN NBA Team News
Usage
espn_mbb_team_news(team_id, limit = 25) espn_nba_team_news(team_id, limit = 25)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. |
limit |
integer. Maximum number of articles to return. Default |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_news(team_id = "150", limit = 5) espn_nba_team_news(team_id = "13", limit = 5)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.
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, ... )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 |
... |
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_odds_records(team_id = 150, season = 2026) espn_nba_team_odds_records(team_id = 13, season = 2026)espn_mbb_team_odds_records(team_id = 150, season = 2026) espn_nba_team_odds_records(team_id = 13, season = 2026)
Get ESPN MBB Team Record (Per Season Type)
Description
Returns the long-format record breakdown for an MBB team in one season and season-type. Each row is one record category.
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), ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_record(team_id = 150, season = 2025) espn_nba_team_record(team_id = 13, season = 2025)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, ...)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 |
season_type |
Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason. |
... |
Additional arguments; currently unused. |
Value
A long tibble.
A long tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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)
Get ESPN Women's College Basketball Team Schedule
Description
Get ESPN Women's College Basketball Team Schedule
Get ESPN Women's College Basketball Team Schedule
Get ESPN NBA 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, ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_schedule(team_id = "150", season = 2025) espn_nba_team_schedule(team_id = "13", season = 2025)espn_mbb_team_schedule(team_id = "150", season = 2025) espn_nba_team_schedule(team_id = "13", season = 2025)
Get ESPN MBB Team Roster (Per-Season, core-v2)
Description
Returns the per-season team roster as a tibble of athlete IDs from
seasons/{y}/teams/{id}/athletes. Distinct from espn_mbb_team_roster()
which targets a site-v2 endpoint optimized for the current season; this
core-v2 variant is era-correct and available back to ESPN's earliest
season for each league.
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(), ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_season_roster(team_id = 150, season = 2025) espn_nba_team_season_roster(team_id = 13, season = 2025)espn_mbb_team_season_roster(team_id = 150, season = 2025) espn_nba_team_season_roster(team_id = 13, season = 2025)
Get ESPN MBB Team Season Statistics (Long Format with Rank)
Description
Returns the full team-season-type statistics sheet for one MBB team in
long format: one row per (category x stat). Each row carries the team's
league rank for that stat where ESPN provides it (rank +
rank_display_value). Complements espn_mbb_team_record() (W-L only)
with the full stat package.
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, ... )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).
A long tibble with one row per (category x stat).
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_team_season_statistics(team_id = 150, season = 2024) espn_nba_team_season_statistics(team_id = 13, season = 2024)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)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_team_stats(team_id = 150, year = 2020)) try(espn_nba_team_stats(team_id = 13, year = 2020))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()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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
try(espn_mbb_teams()) try(espn_nba_teams())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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_tournament(tournament_id = 3) espn_nba_tournament(tournament_id = 1)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 $refs 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 $refs 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, ...)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.
A single-row tibble.
Author(s)
Saiem Gilani
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_tournament_season(tournament_id = 3, season = 2024) espn_nba_tournament_season(tournament_id = 1, season = 2024)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, ...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_tournament_seasons(tournament_id = 3) espn_nba_tournament_seasons(tournament_id = 1)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(...)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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_tournaments() espn_nba_tournaments()espn_mbb_tournaments() espn_nba_tournaments()
Get ESPN Women's College Basketball Venues
Description
Get ESPN Women's College Basketball Venues
Get ESPN Women's College Basketball Venues
Get ESPN NBA Venues
Get ESPN NBA Venues
Usage
espn_mbb_venues(...) espn_nba_venues(...)espn_mbb_venues(...) espn_nba_venues(...)
Arguments
... |
Additional arguments; currently unused but retained for
forward compatibility. Proxy configuration should use
|
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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_venues() espn_nba_venues()espn_mbb_venues() espn_nba_venues()
Get ESPN MBB Per-Week Ranking Detail
Description
Returns the long-format ranked teams for one (season x season-type x week x ranking-source). Typically 25 rows for MBB (AP Top 25).
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, ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_rankings(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_week_ranking(ranking_id = 1, week = 5, season = 2025) espn_nba_week_ranking(ranking_id = 1, week = 5, season = 2025)espn_mbb_week_ranking(ranking_id = 1, week = 5, season = 2025) espn_nba_week_ranking(ranking_id = 1, week = 5, season = 2025)
Get ESPN MBB Per-Week Rankings Index
Description
Returns the index of ranking sources available for one (MBB season x
season-type x week). Typical sources: AP Top 25 (id 1), Coaches Poll
(id 2). Pass an id to espn_mbb_week_ranking() for the ranked teams.
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, ... )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
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_wp()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_week_rankings(week = 5, season = 2025) espn_nba_week_rankings(week = 5, season = 2025)espn_mbb_week_rankings(week = 5, season = 2025) espn_nba_week_rankings(week = 5, season = 2025)
Men's College Basketball win probability chart data from ESPN
Description
Men's College Basketball win probability chart data from ESPN
Get NBA win probability chart data from ESPN
Usage
espn_mbb_wp(game_id) espn_nba_wp(game_id)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). |
See Also
Other ESPN MBB Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_rankings(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings()
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_mbb_wp(game_id = 401256760) espn_nba_wp(game_id = 401283399)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 $refs 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(), ...)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
|
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 single-row tibble.
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
See Also
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)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
Get ESPN NBA Free Agents
Usage
espn_nba_freeagents(season = most_recent_nba_season(), ...)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
|
Details
Calls the ESPN core-v2 endpoint
https://sports.core.api.espn.com/v2/sports/basketball/leagues/nba/seasons/{year}/freeagents.
As of 2026-05, this endpoint returns HTTP 500 for every season tested and
there is no documented replacement; the function consequently returns an
empty tibble and emits a CLI error message. It is retained so that downstream
code does not break if ESPN restores the endpoint, but should not be relied
on in the meantime.
Value
A hoopR_data tibble with one row per free agent:
| col_name | types | description |
| season | integer | Season identifier (4-digit year or 'YYYY-YY' string). |
| athlete_id | character | Unique athlete identifier (ESPN). |
| athlete_name | character | Athlete display name (ESPN). |
| position | character | Listed roster position (G, F, C, etc.). |
| prior_team_id | character | |
| status | character | Status label. |
| signed_team_id | character | |
| signed_date | character | |
| contract_value | character | |
| contract_term_years | character |
Author(s)
Saiem Gilani
See Also
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_player_contracts(),
espn_nba_team_depthchart(),
espn_nba_transactions()
Examples
espn_nba_freeagents(season = 2025)espn_nba_freeagents(season = 2025)
Get ESPN NBA Athlete Contracts Index
Description
Returns the index of contract seasons recorded for an NBA athlete from
sports.core.api.espn.com/v2/sports/basketball/leagues/nba/athletes/{athlete_id}/contracts.
Each row is one contract year — pass the season to
espn_nba_player_contract() for the full contract record.
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(), ...)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
See Also
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_team_depthchart(),
espn_nba_transactions()
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)# 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(), ...)espn_nba_team_depthchart(team_id, season = most_recent_nba_season(), ...)
Arguments
team_id |
ESPN team identifier. |
season |
Season year. Defaults to most recent NBA season. |
... |
Additional arguments; currently unused. |
Details
Get ESPN NBA Team Depth Chart (Long Format)
Value
A long tibble with one row per athlete depth entry.
| col_name | types | description |
| league | character | League slug. |
| team_id | character | ESPN team id. |
| season | integer | Season year. |
| depthchart_id | character | Depth chart id (typically "1"). |
| depthchart_name | character | Depth chart name. |
| position | character | Position code (pg/sg/sf/pf/c). |
| rank | integer | Depth rank (1 = starter). |
| athlete_id | character | ESPN athlete id. |
| athlete_ref | character | $ref URL to athlete-in-season. |
| position_ref | character | $ref URL to position resource.
|
Author(s)
Saiem Gilani
See Also
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_transactions()
Examples
espn_nba_team_depthchart(team_id = 13, season = 2025)espn_nba_team_depthchart(team_id = 13, season = 2025)
Get ESPN NBA Transactions
Description
Get ESPN NBA Transactions
Get ESPN NBA Transactions
Usage
espn_nba_transactions(season = most_recent_nba_season(), limit = 100, ...)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
|
... |
Additional arguments; currently unused but retained for
forward compatibility. Proxy configuration should use
|
Details
Calls the ESPN site-v2 endpoint
https://site.api.espn.com/apis/site/v2/sports/basketball/nba/transactions?season={year}&limit={limit}.
Releases have a NULL to_team_id; those are stored as NA. Returns an
empty tibble rather than erroring when no transactions are available.
Value
A hoopR_data tibble with one row per transaction:
| col_name | types | description |
| transaction_id | character | |
| date | character | Date in YYYY-MM-DD format. |
| type | character | Record type / category. |
| description | character | Long-form description text. |
| team_id | character | Unique team identifier. |
| athlete_id | character | Unique athlete identifier (ESPN). |
| athlete_name | character | Athlete display name (ESPN). |
| from_team_id | character | |
| to_team_id | character |
Author(s)
Saiem Gilani
See Also
Other ESPN NBA Functions:
espn_mbb_athletes_index(),
espn_mbb_award(),
espn_mbb_calendar(),
espn_mbb_coach(),
espn_mbb_coach_record(),
espn_mbb_coach_season(),
espn_mbb_coaches(),
espn_mbb_conferences(),
espn_mbb_franchise(),
espn_mbb_franchises(),
espn_mbb_futures(),
espn_mbb_game_all(),
espn_mbb_game_odds(),
espn_mbb_game_official_detail(),
espn_mbb_game_play(),
espn_mbb_game_play_personnel(),
espn_mbb_game_player_box(),
espn_mbb_game_probabilities(),
espn_mbb_game_propbets(),
espn_mbb_game_team_linescores(),
espn_mbb_game_team_roster_entry(),
espn_mbb_injuries(),
espn_mbb_leaders(),
espn_mbb_news(),
espn_mbb_player_awards(),
espn_mbb_player_career_stats(),
espn_mbb_player_eventlog_v2(),
espn_mbb_player_info(),
espn_mbb_player_overview(),
espn_mbb_player_seasons(),
espn_mbb_player_stats(),
espn_mbb_position(),
espn_mbb_positions(),
espn_mbb_powerindex(),
espn_mbb_scoreboard(),
espn_mbb_season_awards(),
espn_mbb_season_group(),
espn_mbb_season_groups(),
espn_mbb_season_info(),
espn_mbb_season_leaders(),
espn_mbb_season_ranking(),
espn_mbb_season_rankings(),
espn_mbb_season_type(),
espn_mbb_season_types(),
espn_mbb_season_week(),
espn_mbb_season_weeks(),
espn_mbb_seasons(),
espn_mbb_standings(),
espn_mbb_team(),
espn_mbb_team_current_roster(),
espn_mbb_team_injuries(),
espn_mbb_team_news(),
espn_mbb_team_odds_records(),
espn_mbb_team_record(),
espn_mbb_team_record_detail(),
espn_mbb_team_schedule(),
espn_mbb_team_season_roster(),
espn_mbb_team_season_statistics(),
espn_mbb_team_stats(),
espn_mbb_teams(),
espn_mbb_tournament(),
espn_mbb_tournament_season(),
espn_mbb_tournament_seasons(),
espn_mbb_tournaments(),
espn_mbb_venues(),
espn_mbb_week_ranking(),
espn_mbb_week_rankings(),
espn_mbb_wp(),
espn_nba_draft_pick(),
espn_nba_freeagents(),
espn_nba_player_contracts(),
espn_nba_team_depthchart()
Examples
espn_nba_transactions(season = 2025, limit = 10)espn_nba_transactions(season = 2025, limit = 10)
EuroLeague Clubs
Description
Get the clubs in a season.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons/{season_code}/clubs
Usage
euroleague_clubs(competition_code, season_code)euroleague_clubs(competition_code, season_code)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per club:
| col_name | types | description |
| code | character | EuroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| name | character | Display name. |
| abbreviated_name | character | Abbreviated display name. |
| editorial_name | character | Editorial (long-form) display name. |
| tv_code | character | Three-letter broadcast abbreviation of the club. |
| is_virtual | logical | Whether the club is a placeholder rather than a real club. |
| sponsor | character | Club sponsor. |
| club_permanent_name | character | Permanent club name independent of sponsor naming. |
| club_permanent_alias | character | Permanent club alias independent of sponsor naming. |
| address | character | Street address. |
| website | character | Official website URL. |
| tickets_url | character | Ticketing URL. |
| twitter_account | character | Twitter / X handle. |
| venue_code | character | Code of the venue the club or game plays at (Utf8 join key). |
| city | character | City the club is based in. |
| president | character | Club president. |
| phone | character | Contact phone number. |
| images_crest | character | URL of the club crest image. |
| country_code | character | ISO country code. |
| country_name | character | Country name. |
See Also
Other Euroleague:
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_clubs(competition_code = "E", season_code = "E2025") })try({ euroleague_clubs(competition_code = "E", season_code = "E2025") })
EuroLeague Competitions
Description
Get the competitions of the EuroLeague Competition Engine (EuroLeague E,
EuroCup U, ...).
Endpoint: GET https://api-live.euroleague.net/v2/competitions
Usage
euroleague_competitions()euroleague_competitions()
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per competition:
| col_name | types | description |
| name | character | Display name. |
| code | character | EuroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_competitions() })try({ euroleague_competitions() })
EuroLeague Game Box Score (live API)
Description
Get the box score of one game from the live API: one row per player plus each side's team-only and totals rows, with by-quarter scores, referees and attendance repeated on every row.
Endpoint: GET https://live.euroleague.net/api/Boxscore?gamecode={game_code}&seasoncode={season_code}
Stats holds one object per side (Team, Coach, PlayersStats, tmr =
team-only rebounds, totr = totals). Each side's players become rows tagged
row_type = "player", followed by the side's "team" and "total" rows.
Every row also carries the game's attendance and referees and, for the
row's side, team_name, coach, the points scored per quarter
(by_quarter_q1 ...) and the cumulative score at the end of each quarter
(end_of_quarter_q1 ...).
Usage
euroleague_game_boxscore(game_code, season_code)euroleague_game_boxscore(game_code, season_code)
Arguments
game_code |
(integer required): Game number within the season (1-based;
the |
season_code |
(character required): Competition code + start year:
|
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
The live API's codes are space-padded fixed-width strings
(TEAM = "IST "); every string cell is stripped. Its "no such game"
answer is an empty 200 body, returned as a zero-row tibble with the
documented columns (not an error). A 404 raises hoopR_no_data, a 400 / 422
hoopR_invalid_request, any other failure hoopR_fetch_error (all inherit
hoopR_error).
Value
A hoopR_data tibble with one row per player plus two per side:
| col_name | types | description |
| row_type | character | Row kind: player, team (team-only rebounds) or total (side totals). |
| team_name | character | Club display name. |
| coach | character | Head coach name. |
| attendance | character | Attendance, as reported by the box score (repeated on every row). |
| referees | character | Referees of the game, comma-separated SURNAME, GIVEN NAME (repeated on every row). |
| by_quarter_q1 | integer | Points the row's team scored in quarter 1 (from the box score's ByQuarter block). |
| by_quarter_q2 | integer | Points the row's team scored in quarter 2 (from the box score's ByQuarter block). |
| by_quarter_q3 | integer | Points the row's team scored in quarter 3 (from the box score's ByQuarter block). |
| by_quarter_q4 | integer | Points the row's team scored in quarter 4 (from the box score's ByQuarter block). |
| end_of_quarter_q1 | integer | Score of the row's team at the end of quarter 1 (cumulative; from the box score's EndOfQuarter block). |
| end_of_quarter_q2 | integer | Score of the row's team at the end of quarter 2 (cumulative; from the box score's EndOfQuarter block). |
| end_of_quarter_q3 | integer | Score of the row's team at the end of quarter 3 (cumulative; from the box score's EndOfQuarter block). |
| end_of_quarter_q4 | integer | Score of the row's team at the end of quarter 4 (cumulative; from the box score's EndOfQuarter block). |
| player_id | character | EuroLeague player code (Utf8 join key; space padding stripped; blank on team rows). |
| is_starter | integer | Whether the player started (1 / 0). |
| is_playing | integer | Whether the player appeared in the game (1 / 0). |
| team | character | EuroLeague club code of the team (Utf8 join key; space padding stripped). |
| dorsal | character | Jersey number as displayed. |
| player | character | Player display name (SURNAME, GIVEN NAME). |
| minutes | character | Minutes played (mm:ss). |
| points | integer | Points. |
| field_goals_made2 | integer | Two-point field goals made. |
| field_goals_attempted2 | integer | Two-point field goals attempted. |
| field_goals_made3 | integer | Three-point field goals made. |
| field_goals_attempted3 | integer | Three-point field goals attempted. |
| free_throws_made | integer | Free throws made. |
| free_throws_attempted | integer | Free throws attempted. |
| offensive_rebounds | integer | Offensive rebounds. |
| defensive_rebounds | integer | Defensive rebounds. |
| total_rebounds | integer | Total rebounds. |
| assistances | integer | Assists. |
| steals | integer | Steals. |
| turnovers | integer | Turnovers. |
| blocks_favour | integer | Blocks made. |
| blocks_against | integer | Shots blocked by the opponent. |
| fouls_commited | integer | Personal fouls committed. |
| fouls_received | integer | Fouls drawn. |
| valuation | integer | Performance index rating (PIR). |
| plusminus | numeric | Plus/minus. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ box <- euroleague_game_boxscore(game_code = 1, season_code = "E2025") box[box$row_type == "player", c("team", "player", "minutes", "points", "valuation")] })try({ box <- euroleague_game_boxscore(game_code = 1, season_code = "E2025") box[box$row_type == "player", c("team", "player", "minutes", "points", "valuation")] })
EuroLeague Game Header
Description
Get the header of one game from the live API: teams, codes, coaches, score by quarter, venue, referees, one row.
Endpoint: GET https://live.euroleague.net/api/Header?gamecode={game_code}&seasoncode={season_code}
The header is a flat object: teams, codes, coaches, the score and the
cumulative score at the end of each quarter (score_quarter1_a ...),
venue, capacity (as reported; its semantics are unverified) and referees.
Team A is the home side as measured on one game.
Usage
euroleague_game_header(game_code, season_code)euroleague_game_header(game_code, season_code)
Arguments
game_code |
(integer required): Game number within the season (1-based;
the |
season_code |
(character required): Competition code + start year:
|
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
The live API's codes are space-padded fixed-width strings
(TEAM = "IST "); every string cell is stripped. Its "no such game"
answer is an empty 200 body, returned as a zero-row tibble with the
documented columns (not an error). A 404 raises hoopR_no_data, a 400 / 422
hoopR_invalid_request, any other failure hoopR_fetch_error (all inherit
hoopR_error).
Value
A hoopR_data tibble with one row (the game):
| col_name | types | description |
| live | logical | Whether the game is in progress. |
| round | character | Round label (e.g. Round 1). |
| date | character | Game date (venue local, dd/mm/yyyy). |
| hour | character | Scheduled tip-off time (venue local, HH:MM). |
| stadium | character | Venue name. |
| capacity | character | Capacity as reported by the API (equals the box score's attendance on the captured game; semantics unverified). |
| team_a | character | Display name of team A (= the home side, measured on one game). |
| team_b | character | Display name of team B (= the away side, measured on one game). |
| code_team_a | character | EuroLeague club code of team A (= the home side, measured on one game); Utf8 join key. |
| tv_code_a | character | Three-letter broadcast abbreviation of team A. |
| code_team_b | character | EuroLeague club code of team B (= the away side, measured on one game); Utf8 join key. |
| tv_code_b | character | Three-letter broadcast abbreviation of team B. |
| im_a | character | Crest image file name of team A. |
| im_b | character | Crest image file name of team B. |
| score_a | character | Score of team A (= the home side, measured on one game). |
| score_b | character | Score of team B (= the away side, measured on one game). |
| coach_a | character | Head coach of team A. |
| coach_b | character | Head coach of team B. |
| game_time | character | Elapsed game time (mm:ss). |
| remaining_partial_time | character | Time remaining in the current period (mm:ss). |
| wid | character | Live-feed widget identifier of the game. |
| quarter | character | Current period of the game. |
| foults_a | character | Team fouls of team A in the current period (sic: the API spells it this way). |
| foults_b | character | Team fouls of team B in the current period (sic: the API spells it this way). |
| timeouts_a | character | Timeouts used by team A. |
| timeouts_b | character | Timeouts used by team B. |
| score_quarter1_a | integer | Score of team A at the end of quarter 1 (cumulative). |
| score_quarter2_a | integer | Score of team A at the end of quarter 2 (cumulative). |
| score_quarter3_a | integer | Score of team A at the end of quarter 3 (cumulative). |
| score_quarter4_a | integer | Score of team A at the end of quarter 4 (cumulative). |
| score_extra_time_a | integer | Points scored by team A in overtime (0 when none). |
| score_quarter1_b | integer | Score of team B at the end of quarter 1 (cumulative). |
| score_quarter2_b | integer | Score of team B at the end of quarter 2 (cumulative). |
| score_quarter3_b | integer | Score of team B at the end of quarter 3 (cumulative). |
| score_quarter4_b | integer | Score of team B at the end of quarter 4 (cumulative). |
| score_extra_time_b | integer | Points scored by team B in overtime (0 when none). |
| phase | character | Phase name (Regular Season, Playoffs, ...). |
| phase_reduced_name | character | Short phase name. |
| competition | character | Competition name. |
| competition_reduced_name | character | Short competition name. |
| pcom | character | Competition code of the live feed (E = EuroLeague, U = EuroCup). |
| referee1 | character | First referee. |
| referee2 | character | Second referee. |
| referee3 | character | Third referee. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_game_header(game_code = 1, season_code = "E2025") })try({ euroleague_game_header(game_code = 1, season_code = "E2025") })
EuroLeague Game Play-by-Play
Description
Get the play-by-play of one game from the live API, one row per play.
Endpoint: GET https://live.euroleague.net/api/PlayByPlay?gamecode={game_code}&seasoncode={season_code}
The body carries one array per period (FirstQuarter, SecondQuarter,
ThirdQuarter, ForthQuarter (sic), ExtraTime) beside the two team names
and codes. The arrays are unrolled in game order with a leading quarter
column (1-4; 5 for every overtime period, which the body does not split
further) and the team_a / team_b / code_team_a / code_team_b header
fields repeated on every row. Team A is the home side as measured on one
game.
Usage
euroleague_game_pbp(game_code, season_code)euroleague_game_pbp(game_code, season_code)
Arguments
game_code |
(integer required): Game number within the season (1-based;
the |
season_code |
(character required): Competition code + start year:
|
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
The live API's codes are space-padded fixed-width strings
(TEAM = "IST "); every string cell is stripped. Its "no such game"
answer is an empty 200 body, returned as a zero-row tibble with the
documented columns (not an error). A 404 raises hoopR_no_data, a 400 / 422
hoopR_invalid_request, any other failure hoopR_fetch_error (all inherit
hoopR_error).
Value
A hoopR_data tibble with one row per play:
| col_name | types | description |
| quarter | integer | Period of the play: 1-4, or 5 for every overtime period. |
| team_a | character | Display name of team A (= the home side, measured on one game). |
| team_b | character | Display name of team B (= the away side, measured on one game). |
| code_team_a | character | EuroLeague club code of team A (= the home side, measured on one game); Utf8 join key. |
| code_team_b | character | EuroLeague club code of team B (= the away side, measured on one game); Utf8 join key. |
| type | integer | Play type (engine integer). |
| numberofplay | integer | Sequence number of the play within the game. |
| codeteam | character | EuroLeague club code of the team on the play (Utf8 join key; blank on administrative plays). |
| player_id | character | EuroLeague player code (Utf8 join key; space padding stripped; blank on team rows). |
| playtype | character | Play type code (BP = begin period, 2FGM, 3FGA, FTM, AS = assist, TO, RV, CM, ...). |
| player | character | Player display name (SURNAME, GIVEN NAME). |
| team | character | Display name of the team on the play (null on administrative plays). |
| dorsal | character | Jersey number as displayed. |
| minute | integer | Game minute of the event (1-based; 41+ in overtime). |
| markertime | character | Game clock at the play (mm:ss remaining in the period). |
| points_a | integer | Running score of team A (= the home side, measured on one game) after the event. |
| points_b | integer | Running score of team B (= the away side, measured on one game) after the event. |
| comment | character | Free-text annotation of the play. |
| playinfo | character | Play description. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ pbp <- euroleague_game_pbp(game_code = 1, season_code = "E2025") table(pbp$codeteam[pbp$playtype %in% c("2FGM", "3FGM", "FTM")]) })try({ pbp <- euroleague_game_pbp(game_code = 1, season_code = "E2025") table(pbp$codeteam[pbp$playtype %in% c("2FGM", "3FGM", "FTM")]) })
EuroLeague Game Points (shot chart)
Description
Get the shot chart of one game from the live API: one row per made / missed
field goal and per made free throw, with coord_x / coord_y in centimeters
from the hoop.
Endpoint: GET https://live.euroleague.net/api/Points?gamecode={game_code}&seasoncode={season_code}
Points is the shot-chart source: one row per field-goal attempt
(id_action 2FGM / 2FGA / 3FGM / 3FGA) and per made free throw
(FTM), with coord_x / coord_y, zone, the fastbreak /
second_chance / points_off_turnover flags, the running score
(points_a / points_b), minute, the game clock (console) and a utc
timestamp. Team A is the home side as measured on one game.
Usage
euroleague_game_points(game_code, season_code)euroleague_game_points(game_code, season_code)
Arguments
game_code |
(integer required): Game number within the season (1-based;
the |
season_code |
(character required): Competition code + start year:
|
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only
wraps it (wrap-only: payloads are not redistributed as release assets). This
function mirrors sdv-py's euroleague_game_points(): same arguments,
defaults and snake_case columns, one row per sdv-py row.
Coordinate frame, as measured in the reference capture (E2025 game 1, 158 rows; U2025 game 1, 176 rows):
-
Units: integer centimeters. Origin: the hoop. 2FG radii run 8-512 cm, 3FG radii 722-925 cm (the FIBA arc is 675 cm), zone
A(rim) sits at radius 8-33 cm. -
Both teams are mapped onto one basket;
coord_ygrows away from the baseline toward the court (-6 to 865 cm for every team on the E game, -69 to 1028 on the U game; 3FG rows sit at y 414-865). Negative y is behind the hoop (the U game has a few rows up to 69 cm behind it, i.e. under or behind the backboard). -
coord_xis signed left / right of the hoop (-683 to 696 cm); 3-point zoneHis x < 0 andIis x > 0. Which sideline is positive (from the shooter's view or from the scorer's table) is UNVERIFIED from the data alone. -
Free throws are not located:
FTMrows carrycoord_x = coord_y = -1andzone = ""(a sentinel, not a spot 1 cm from the hoop). Filter them out before plotting. -
zoneletters A-I: A rim, B / C close left / right, D / E mid, F / G long two, H / I three.
The live API's codes are space-padded fixed-width strings
(TEAM = "IST "); every string cell is stripped. Its "no such game"
answer is an empty 200 body, returned as a zero-row tibble with the
documented columns (not an error). A 404 raises hoopR_no_data, a 400 / 422
hoopR_invalid_request, any other failure hoopR_fetch_error (all inherit
hoopR_error).
Value
A hoopR_data tibble with one row per shot:
| col_name | types | description |
| num_anot | integer | Sequence number of the scoring annotation within the game. |
| team | character | EuroLeague club code of the team (Utf8 join key; space padding stripped). |
| id_player | character | EuroLeague player code (Utf8 join key; space padding stripped). |
| player | character | Player display name (SURNAME, GIVEN NAME). |
| id_action | character | Shot type code: 2FGM / 2FGA / 3FGM / 3FGA (made / attempted field goal) or FTM (made free throw). |
| action | character | Shot type label (Two Pointer, Three Pointer, Free Throw In, ...). |
| points | integer | Points the shot is worth (1, 2 or 3). |
| coord_x | integer | Shot x in integer centimeters from the hoop, signed left/right of it (-683 to 696 cm measured): both teams are mapped onto one basket; 3-point zone H is x < 0 and I is x > 0; which sideline is positive (from the shooter's view or from the scorer's table) is UNVERIFIED from the data alone. Made free throws (FTM) carry the -1 sentinel. |
| coord_y | integer | Shot y in integer centimeters from the hoop, growing away from the baseline toward the court (-6 to 865 cm measured; 3FG rows at 414-865): both teams are mapped onto one basket, negative y is behind the hoop. Made free throws (FTM) carry the -1 sentinel. |
| zone | character | Court zone letter: A rim, B/C close left/right, D/E mid, F/G long two, H/I three; blank on free throws. |
| fastbreak | character | Whether the shot came on a fast break (0 / 1 as a string). |
| second_chance | character | Whether the shot was a second-chance attempt (0 / 1 as a string). |
| points_off_turnover | character | Whether the shot came off a turnover (0 / 1 as a string). |
| minute | integer | Game minute of the event (1-based; 41+ in overtime). |
| console | character | Game clock at the event (mm:ss remaining in the period). |
| points_a | integer | Running score of team A (= the home side, measured on one game) after the event. |
| points_b | integer | Running score of team B (= the away side, measured on one game) after the event. |
| utc | character | UTC timestamp of the event (yyyymmddHHMMSS). |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ shots <- euroleague_game_points(game_code = 1, season_code = "E2025") shots[shots$id_action != "FTM", c("team", "id_action", "coord_x", "coord_y", "zone")] })try({ shots <- euroleague_game_points(game_code = 1, season_code = "E2025") shots[shots$id_action != "FTM", c("team", "id_action", "coord_x", "coord_y", "zone")] })
EuroLeague Game Report
Description
Get the report of one game: date, round, phase, both clubs with score and last-5 form, one row.
Endpoint: GET https://api-live.euroleague.net/v3/competitions/{competition_code}/seasons/{season_code}/games/{game_code}/report
Usage
euroleague_game_report(competition_code, season_code, game_code)euroleague_game_report(competition_code, season_code, game_code)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
game_code |
(integer required): Game number within the season (1-based;
the |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row (the game):
| col_name | types | description |
| game_code | character | Game number within the season (1-based; Utf8 join key). |
| round | integer | Round number within the season. |
| round_alias | character | Short alias of the round. |
| round_name | character | Display name of the round. |
| played | logical | Whether the game has been played. |
| date | character | Scheduled tip-off (ISO 8601, venue local time). |
| confirmed_date | logical | Whether the game date is confirmed. |
| confirmed_hour | logical | Whether the tip-off time is confirmed. |
| local_time_zone | integer | UTC offset of the venue, in hours. |
| local_date | character | Scheduled tip-off in venue local time (ISO 8601). |
| utc_date | character | Scheduled tip-off in UTC (ISO 8601). |
| local_last5_form | character | Home side: results of the last five games, oldest first (W / L), JSON-encoded. |
| road_last5_form | character | Away side: results of the last five games, oldest first (W / L), JSON-encoded. |
| season_name | character | Season: display name. |
| season_code | character | Season code: competition code + start year, e.g. E2025 for 2025-26 (Utf8 join key). |
| season_alias | character | Season: short display alias. |
| season_competition_code | character | Season: competition code (E = EuroLeague, U = EuroCup; Utf8 join key). |
| season_year | integer | Season: start year of the season. |
| season_start_date | character | Season: start date (ISO 8601). |
| group_id | character | Group: provider identifier for the entity (Utf8 join key). |
| group_order | integer | Group: display order within the roster. |
| group_name | character | Group: display name. |
| group_raw_name | character | Group: group name as stored by the engine. |
| phase_type_code | character | Phase type code (RS = regular season, PO = playoffs, ...). |
| phase_type_alias | character | Phase type: short display alias. |
| phase_type_name | character | Phase type: display name. |
| phase_type_is_group_phase | logical | Phase type: whether the phase is played in groups. |
| local_club_code | character | Home side: club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| local_club_name | character | Home side: club: display name. |
| local_club_abbreviated_name | character | Home side: club: abbreviated display name. |
| local_club_editorial_name | character | Home side: club: editorial (long-form) display name. |
| local_club_tv_code | character | Home side: club: three-letter broadcast abbreviation of the club. |
| local_club_is_virtual | logical | Home side: club: whether the club is a placeholder rather than a real club. |
| local_club_images_crest | character | Home side: club: URL of the club crest image. |
| local_score | integer | Home side: final score of the side. |
| local_standings_score | integer | Home side: score of the side as counted for the standings. |
| road_club_code | character | Away side: club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| road_club_name | character | Away side: club: display name. |
| road_club_abbreviated_name | character | Away side: club: abbreviated display name. |
| road_club_editorial_name | character | Away side: club: editorial (long-form) display name. |
| road_club_tv_code | character | Away side: club: three-letter broadcast abbreviation of the club. |
| road_club_is_virtual | logical | Away side: club: whether the club is a placeholder rather than a real club. |
| road_club_images_crest | character | Away side: club: URL of the club crest image. |
| road_score | integer | Away side: final score of the side. |
| road_standings_score | integer | Away side: score of the side as counted for the standings. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_game_report(competition_code = "E", season_code = "E2025", game_code = 1) })try({ euroleague_game_report(competition_code = "E", season_code = "E2025", game_code = 1) })
EuroLeague Game Stats (Competition Engine box score)
Description
Get the box score of one game from the Competition Engine: one row with the
local and road sides flattened to prefixed columns; each side's players
list is kept JSON-encoded.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons/{season_code}/games/{game_code}/stats
For one row per player use euroleague_game_boxscore() (the live API).
Usage
euroleague_game_stats(competition_code, season_code, game_code)euroleague_game_stats(competition_code, season_code, game_code)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
game_code |
(integer required): Game number within the season (1-based;
the |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row (the game). The local_players /
road_players cells are JSON text: semantically equal to sdv-py's, not
byte-equal (separators and unicode escaping differ):
| col_name | types | description |
| local_coach_code | character | Home side: head coach code (Utf8 join key). |
| local_coach_name | character | Home side: head coach name. |
| local_players | character | Home side: per-player box-score rows for the side, JSON-encoded. |
| local_team_time_played | numeric | Home side: team-only (not attributed to a player): seconds played. |
| local_team_valuation | numeric | Home side: team-only (not attributed to a player): performance index rating (PIR). |
| local_team_points | numeric | Home side: team-only (not attributed to a player): points. |
| local_team_field_goals_made2 | numeric | Home side: team-only (not attributed to a player): two-point field goals made. |
| local_team_field_goals_attempted2 | numeric | Home side: team-only (not attributed to a player): two-point field goals attempted. |
| local_team_field_goals_made3 | numeric | Home side: team-only (not attributed to a player): three-point field goals made. |
| local_team_field_goals_attempted3 | numeric | Home side: team-only (not attributed to a player): three-point field goals attempted. |
| local_team_free_throws_made | numeric | Home side: team-only (not attributed to a player): free throws made. |
| local_team_free_throws_attempted | numeric | Home side: team-only (not attributed to a player): free throws attempted. |
| local_team_field_goals_made_total | numeric | Home side: team-only (not attributed to a player): field goals made. |
| local_team_field_goals_attempted_total | numeric | Home side: team-only (not attributed to a player): field goals attempted. |
| local_team_accuracy_made | numeric | Home side: team-only (not attributed to a player): shots made (accuracy numerator). |
| local_team_accuracy_attempted | numeric | Home side: team-only (not attributed to a player): shots attempted (accuracy denominator). |
| local_team_total_rebounds | numeric | Home side: team-only (not attributed to a player): total rebounds. |
| local_team_defensive_rebounds | numeric | Home side: team-only (not attributed to a player): defensive rebounds. |
| local_team_offensive_rebounds | numeric | Home side: team-only (not attributed to a player): offensive rebounds. |
| local_team_assistances | numeric | Home side: team-only (not attributed to a player): assists. |
| local_team_steals | numeric | Home side: team-only (not attributed to a player): steals. |
| local_team_turnovers | numeric | Home side: team-only (not attributed to a player): turnovers. |
| local_team_blocks_favour | numeric | Home side: team-only (not attributed to a player): blocks made. |
| local_team_blocks_against | numeric | Home side: team-only (not attributed to a player): shots blocked by the opponent. |
| local_team_fouls_commited | numeric | Home side: team-only (not attributed to a player): personal fouls committed. |
| local_team_fouls_received | numeric | Home side: team-only (not attributed to a player): fouls drawn. |
| local_team_plus_minus | numeric | Home side: team-only (not attributed to a player): plus/minus. |
| local_total_time_played | numeric | Home side: totals: seconds played. |
| local_total_valuation | numeric | Home side: totals: performance index rating (PIR). |
| local_total_points | numeric | Home side: totals: points. |
| local_total_field_goals_made2 | numeric | Home side: totals: two-point field goals made. |
| local_total_field_goals_attempted2 | numeric | Home side: totals: two-point field goals attempted. |
| local_total_field_goals_made3 | numeric | Home side: totals: three-point field goals made. |
| local_total_field_goals_attempted3 | numeric | Home side: totals: three-point field goals attempted. |
| local_total_free_throws_made | numeric | Home side: totals: free throws made. |
| local_total_free_throws_attempted | numeric | Home side: totals: free throws attempted. |
| local_total_field_goals_made_total | numeric | Home side: totals: field goals made. |
| local_total_field_goals_attempted_total | numeric | Home side: totals: field goals attempted. |
| local_total_accuracy_made | numeric | Home side: totals: shots made (accuracy numerator). |
| local_total_accuracy_attempted | numeric | Home side: totals: shots attempted (accuracy denominator). |
| local_total_total_rebounds | numeric | Home side: totals: total rebounds. |
| local_total_defensive_rebounds | numeric | Home side: totals: defensive rebounds. |
| local_total_offensive_rebounds | numeric | Home side: totals: offensive rebounds. |
| local_total_assistances | numeric | Home side: totals: assists. |
| local_total_steals | numeric | Home side: totals: steals. |
| local_total_turnovers | numeric | Home side: totals: turnovers. |
| local_total_blocks_favour | numeric | Home side: totals: blocks made. |
| local_total_blocks_against | numeric | Home side: totals: shots blocked by the opponent. |
| local_total_fouls_commited | numeric | Home side: totals: personal fouls committed. |
| local_total_fouls_received | numeric | Home side: totals: fouls drawn. |
| local_total_plus_minus | numeric | Home side: totals: plus/minus. |
| road_coach_code | character | Away side: head coach code (Utf8 join key). |
| road_coach_name | character | Away side: head coach name. |
| road_players | character | Away side: per-player box-score rows for the side, JSON-encoded. |
| road_team_time_played | numeric | Away side: team-only (not attributed to a player): seconds played. |
| road_team_valuation | numeric | Away side: team-only (not attributed to a player): performance index rating (PIR). |
| road_team_points | numeric | Away side: team-only (not attributed to a player): points. |
| road_team_field_goals_made2 | numeric | Away side: team-only (not attributed to a player): two-point field goals made. |
| road_team_field_goals_attempted2 | numeric | Away side: team-only (not attributed to a player): two-point field goals attempted. |
| road_team_field_goals_made3 | numeric | Away side: team-only (not attributed to a player): three-point field goals made. |
| road_team_field_goals_attempted3 | numeric | Away side: team-only (not attributed to a player): three-point field goals attempted. |
| road_team_free_throws_made | numeric | Away side: team-only (not attributed to a player): free throws made. |
| road_team_free_throws_attempted | numeric | Away side: team-only (not attributed to a player): free throws attempted. |
| road_team_field_goals_made_total | numeric | Away side: team-only (not attributed to a player): field goals made. |
| road_team_field_goals_attempted_total | numeric | Away side: team-only (not attributed to a player): field goals attempted. |
| road_team_accuracy_made | numeric | Away side: team-only (not attributed to a player): shots made (accuracy numerator). |
| road_team_accuracy_attempted | numeric | Away side: team-only (not attributed to a player): shots attempted (accuracy denominator). |
| road_team_total_rebounds | numeric | Away side: team-only (not attributed to a player): total rebounds. |
| road_team_defensive_rebounds | numeric | Away side: team-only (not attributed to a player): defensive rebounds. |
| road_team_offensive_rebounds | numeric | Away side: team-only (not attributed to a player): offensive rebounds. |
| road_team_assistances | numeric | Away side: team-only (not attributed to a player): assists. |
| road_team_steals | numeric | Away side: team-only (not attributed to a player): steals. |
| road_team_turnovers | numeric | Away side: team-only (not attributed to a player): turnovers. |
| road_team_blocks_favour | numeric | Away side: team-only (not attributed to a player): blocks made. |
| road_team_blocks_against | numeric | Away side: team-only (not attributed to a player): shots blocked by the opponent. |
| road_team_fouls_commited | numeric | Away side: team-only (not attributed to a player): personal fouls committed. |
| road_team_fouls_received | numeric | Away side: team-only (not attributed to a player): fouls drawn. |
| road_team_plus_minus | numeric | Away side: team-only (not attributed to a player): plus/minus. |
| road_total_time_played | numeric | Away side: totals: seconds played. |
| road_total_valuation | numeric | Away side: totals: performance index rating (PIR). |
| road_total_points | numeric | Away side: totals: points. |
| road_total_field_goals_made2 | numeric | Away side: totals: two-point field goals made. |
| road_total_field_goals_attempted2 | numeric | Away side: totals: two-point field goals attempted. |
| road_total_field_goals_made3 | numeric | Away side: totals: three-point field goals made. |
| road_total_field_goals_attempted3 | numeric | Away side: totals: three-point field goals attempted. |
| road_total_free_throws_made | numeric | Away side: totals: free throws made. |
| road_total_free_throws_attempted | numeric | Away side: totals: free throws attempted. |
| road_total_field_goals_made_total | numeric | Away side: totals: field goals made. |
| road_total_field_goals_attempted_total | numeric | Away side: totals: field goals attempted. |
| road_total_accuracy_made | numeric | Away side: totals: shots made (accuracy numerator). |
| road_total_accuracy_attempted | numeric | Away side: totals: shots attempted (accuracy denominator). |
| road_total_total_rebounds | numeric | Away side: totals: total rebounds. |
| road_total_defensive_rebounds | numeric | Away side: totals: defensive rebounds. |
| road_total_offensive_rebounds | numeric | Away side: totals: offensive rebounds. |
| road_total_assistances | numeric | Away side: totals: assists. |
| road_total_steals | numeric | Away side: totals: steals. |
| road_total_turnovers | numeric | Away side: totals: turnovers. |
| road_total_blocks_favour | numeric | Away side: totals: blocks made. |
| road_total_blocks_against | numeric | Away side: totals: shots blocked by the opponent. |
| road_total_fouls_commited | numeric | Away side: totals: personal fouls committed. |
| road_total_fouls_received | numeric | Away side: totals: fouls drawn. |
| road_total_plus_minus | numeric | Away side: totals: plus/minus. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_game_stats(competition_code = "E", season_code = "E2025", game_code = 1) })try({ euroleague_game_stats(competition_code = "E", season_code = "E2025", game_code = 1) })
EuroLeague Games
Description
Get the games of a season.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons/{season_code}/games
Usage
euroleague_games(competition_code, season_code, limit = NULL, offset = NULL)euroleague_games(competition_code, season_code, limit = NULL, offset = NULL)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
limit |
(integer optional): Page size (number of rows to return). |
offset |
(integer optional): Row offset into the full list. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per game:
| col_name | types | description |
| id | character | Provider identifier for the entity (Utf8 join key). |
| identifier | character | Season-qualified game identifier, e.g. E2025_1. |
| game_code | character | Game number within the season (1-based; Utf8 join key). |
| round | integer | Round number within the season. |
| round_alias | character | Short alias of the round. |
| round_name | character | Display name of the round. |
| played | logical | Whether the game has been played. |
| date | character | Scheduled tip-off (ISO 8601, venue local time). |
| confirmed_date | logical | Whether the game date is confirmed. |
| confirmed_hour | logical | Whether the tip-off time is confirmed. |
| local_time_zone | integer | UTC offset of the venue, in hours. |
| local_date | character | Scheduled tip-off in venue local time (ISO 8601). |
| utc_date | character | Scheduled tip-off in UTC (ISO 8601). |
| audience | integer | Attendance. |
| audience_confirmed | logical | Whether the attendance figure is confirmed. |
| social_feed | character | Social-media hashtag or feed tag for the game. |
| operations_code | character | Engine operations code of the game. |
| referee4 | character | Fourth referee (null unless a fourth official is assigned). |
| is_neutral_venue | logical | Whether the game is played at a neutral venue. |
| game_status | character | Game status (scheduled, live, result). |
| season_name | character | Season: display name. |
| season_code | character | Season code: competition code + start year, e.g. E2025 for 2025-26 (Utf8 join key). |
| season_alias | character | Season: short display alias. |
| season_competition_code | character | Season: competition code (E = EuroLeague, U = EuroCup; Utf8 join key). |
| season_year | integer | Season: start year of the season. |
| season_start_date | character | Season: start date (ISO 8601). |
| group_id | character | Group: provider identifier for the entity (Utf8 join key). |
| group_order | integer | Group: display order within the roster. |
| group_name | character | Group: display name. |
| group_raw_name | character | Group: group name as stored by the engine. |
| phase_type_code | character | Phase type code (RS = regular season, PO = playoffs, ...). |
| phase_type_alias | character | Phase type: short display alias. |
| phase_type_name | character | Phase type: display name. |
| phase_type_is_group_phase | logical | Phase type: whether the phase is played in groups. |
| local_club_code | character | Home side: club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| local_club_name | character | Home side: club: display name. |
| local_club_abbreviated_name | character | Home side: club: abbreviated display name. |
| local_club_editorial_name | character | Home side: club: editorial (long-form) display name. |
| local_club_tv_code | character | Home side: club: three-letter broadcast abbreviation of the club. |
| local_club_is_virtual | logical | Home side: club: whether the club is a placeholder rather than a real club. |
| local_club_images_crest | character | Home side: club: URL of the club crest image. |
| local_score | integer | Home side: final score of the side. |
| local_standings_score | integer | Home side: score of the side as counted for the standings. |
| local_partials_partials1 | integer | Home side: quarter scores: points scored in the 1st quarter. |
| local_partials_partials2 | integer | Home side: quarter scores: points scored in the 2nd quarter. |
| local_partials_partials3 | integer | Home side: quarter scores: points scored in the 3rd quarter. |
| local_partials_partials4 | integer | Home side: quarter scores: points scored in the 4th quarter. |
| road_club_code | character | Away side: club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| road_club_name | character | Away side: club: display name. |
| road_club_abbreviated_name | character | Away side: club: abbreviated display name. |
| road_club_editorial_name | character | Away side: club: editorial (long-form) display name. |
| road_club_tv_code | character | Away side: club: three-letter broadcast abbreviation of the club. |
| road_club_is_virtual | logical | Away side: club: whether the club is a placeholder rather than a real club. |
| road_club_images_crest | character | Away side: club: URL of the club crest image. |
| road_score | integer | Away side: final score of the side. |
| road_standings_score | integer | Away side: score of the side as counted for the standings. |
| road_partials_partials1 | integer | Away side: quarter scores: points scored in the 1st quarter. |
| road_partials_partials2 | integer | Away side: quarter scores: points scored in the 2nd quarter. |
| road_partials_partials3 | integer | Away side: quarter scores: points scored in the 3rd quarter. |
| road_partials_partials4 | integer | Away side: quarter scores: points scored in the 4th quarter. |
| referee1_code | character | First referee: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| referee1_name | character | First referee: display name. |
| referee1_alias | character | First referee: short display alias. |
| referee1_country_code | character | First referee: ISO country code. |
| referee1_country_name | character | First referee: country name. |
| referee1_images_vertical_small | character | First referee: URL of the small portrait image. |
| referee1_active | logical | First referee: whether the record is currently active. |
| referee2_code | character | Second referee: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| referee2_name | character | Second referee: display name. |
| referee2_alias | character | Second referee: short display alias. |
| referee2_country_code | character | Second referee: ISO country code. |
| referee2_country_name | character | Second referee: country name. |
| referee2_images_vertical_small | character | Second referee: URL of the small portrait image. |
| referee2_active | logical | Second referee: whether the record is currently active. |
| referee3_code | character | Third referee: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| referee3_name | character | Third referee: display name. |
| referee3_alias | character | Third referee: short display alias. |
| referee3_country_code | character | Third referee: ISO country code. |
| referee3_country_name | character | Third referee: country name. |
| referee3_images_vertical_small | character | Third referee: URL of the small portrait image. |
| referee3_active | logical | Third referee: whether the record is currently active. |
| venue_name | character | Venue: display name. |
| venue_code | character | Code of the venue the club or game plays at (Utf8 join key). |
| venue_capacity | integer | Venue: seating capacity of the venue. |
| venue_address | character | Venue: street address. |
| venue_images_medium | character | Venue: URL of the medium-size venue image. |
| venue_active | logical | Venue: whether the record is currently active. |
| venue_notes | character | Venue: venue notes. |
| winner_code | character | Winning club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| winner_name | character | Winning club: display name. |
| winner_abbreviated_name | character | Winning club: abbreviated display name. |
| winner_editorial_name | character | Winning club: editorial (long-form) display name. |
| winner_tv_code | character | Winning club: three-letter broadcast abbreviation of the club. |
| winner_is_virtual | logical | Winning club: whether the club is a placeholder rather than a real club. |
| winner_images_crest | character | Winning club: URL of the club crest image. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_games(competition_code = "E", season_code = "E2025") })try({ euroleague_games(competition_code = "E", season_code = "E2025") })
EuroLeague People
Description
Get the people (players, coaches) in a season.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons/{season_code}/people
Usage
euroleague_people(competition_code, season_code, limit = NULL, offset = NULL)euroleague_people(competition_code, season_code, limit = NULL, offset = NULL)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
limit |
(integer optional): Page size (number of rows to return). |
offset |
(integer optional): Row offset into the full list. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per person-club registration:
| col_name | types | description |
| type | character | Person type code (J = player, E = coach, ...). |
| type_name | character | Person type name. |
| active | logical | Whether the record is currently active. |
| start_date | character | Start date (ISO 8601). |
| end_date | character | End date (ISO 8601). |
| order | integer | Display order within the roster. |
| dorsal | character | Jersey number as displayed. |
| dorsal_raw | character | Jersey number as stored by the engine. |
| position | integer | Position code of the player (engine integer). |
| position_name | character | Position name of the player. |
| last_team | character | Previous club of the person. |
| external_id | character | External (statistics-provider) identifier of the person (Utf8 join key). |
| person_code | character | Person: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| person_name | character | Person: display name. |
| person_alias | character | Person: short display alias. |
| person_alias_raw | character | Person: short alias as stored by the engine. |
| person_passport_name | character | Person: given name as on the passport. |
| person_passport_surname | character | Person: surname as on the passport. |
| person_jersey_name | character | Person: name printed on the jersey. |
| person_abbreviated_name | character | Person: abbreviated display name. |
| person_country_code | character | Person: ISO country code. |
| person_country_name | character | Person: country name. |
| person_height | integer | Person: height in centimetres. |
| person_weight | integer | Person: weight in kilograms. |
| person_birth_date | character | Person: date of birth (ISO 8601). |
| person_birth_country_code | character | Person: birth country: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| person_birth_country_name | character | Person: birth country: display name. |
| person_twitter_account | character | Person: twitter / X handle. |
| person_instagram_account | character | Person: instagram handle. |
| person_facebook_account | character | Person: facebook handle. |
| person_is_referee | logical | Person: whether the person is a referee. |
| club_code | character | Club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| club_name | character | Club: display name. |
| club_abbreviated_name | character | Club: abbreviated display name. |
| club_editorial_name | character | Club: editorial (long-form) display name. |
| club_tv_code | character | Club: three-letter broadcast abbreviation of the club. |
| club_is_virtual | logical | Club: whether the club is a placeholder rather than a real club. |
| club_images_crest | character | Club: URL of the club crest image. |
| season_name | character | Season: display name. |
| season_code | character | Season code: competition code + start year, e.g. E2025 for 2025-26 (Utf8 join key). |
| season_alias | character | Season: short display alias. |
| season_competition_code | character | Season: competition code (E = EuroLeague, U = EuroCup; Utf8 join key). |
| season_year | integer | Season: start year of the season. |
| season_start_date | character | Season: start date (ISO 8601). |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_people(competition_code = "E", season_code = "E2025", limit = 50) })try({ euroleague_people(competition_code = "E", season_code = "E2025", limit = 50) })
EuroLeague Player Stats (season)
Description
Get season player stats, traditional (box-score totals or per-game averages) or advanced (eFG%, TS%, rebound / assist / turnover rates), one row per player.
Endpoint: GET https://api-live.euroleague.net/v3/competitions/{competition_code}/statistics/players/{mode}
Usage
euroleague_player_stats( competition_code, mode = c("traditional", "advanced"), season_mode = "Single", season_code = NULL, statistic_mode = "PerGame", limit = NULL, offset = NULL )euroleague_player_stats( competition_code, mode = c("traditional", "advanced"), season_mode = "Single", season_code = NULL, statistic_mode = "PerGame", limit = NULL, offset = NULL )
Arguments
competition_code |
(character required): |
mode |
(character default |
season_mode |
(character default |
season_code |
(character required by the API): Competition code +
start year, e.g. |
statistic_mode |
(character default |
limit |
(integer optional): Page size. |
offset |
(integer optional): Row offset into the full list. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per player. The columns depend on
mode:
mode = "traditional"
| col_name | types | description |
| player_ranking | integer | Rank of the player on the requested statistic mode. |
| games_played | numeric | Games played. |
| games_started | numeric | Games started. |
| minutes_played | numeric | Minutes played. |
| points_scored | numeric | Points scored. |
| two_pointers_made | numeric | Two-point field goals made. |
| two_pointers_attempted | numeric | Two-point field goals attempted. |
| two_pointers_percentage | character | Two-point field-goal percentage, formatted. |
| three_pointers_made | numeric | Three-point field goals made. |
| three_pointers_attempted | numeric | Three-point field goals attempted. |
| three_pointers_percentage | character | Three-point field-goal percentage, formatted. |
| free_throws_made | numeric | Free throws made. |
| free_throws_attempted | numeric | Free throws attempted. |
| free_throws_percentage | character | Free-throw percentage, formatted. |
| offensive_rebounds | numeric | Offensive rebounds. |
| defensive_rebounds | numeric | Defensive rebounds. |
| total_rebounds | numeric | Total rebounds. |
| assists | numeric | Assists. |
| steals | numeric | Steals. |
| turnovers | numeric | Turnovers. |
| blocks | numeric | Blocks made. |
| blocks_against | numeric | Shots blocked by the opponent. |
| fouls_commited | numeric | Personal fouls committed. |
| fouls_drawn | numeric | Fouls drawn. |
| pir | numeric | Performance index rating (PIR). |
| player_code | character | Player: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| player_name | character | Player: display name. |
| player_age | integer | Age of the player in years. |
| player_image_url | character | Player: URL of the image. |
| player_team_code | character | Player: euroLeague club code (Utf8 join key). |
| player_team_tv_codes | character | Player: three-letter broadcast abbreviation(s) of the club. |
| player_team_name | character | Player: club display name. |
| player_team_image_url | character | Player: URL of the club crest image. |
mode = "advanced"
| col_name | types | description |
| player_ranking | integer | Rank of the player on the requested statistic mode. |
| games_played | numeric | Games played. |
| minutes_played | numeric | Minutes played. |
| effective_field_goal_percentage | character | Effective field-goal percentage, formatted. |
| true_shooting_percentage | character | True shooting percentage, formatted. |
| offensive_rebounds_percentage | character | Offensive rebound percentage, formatted. |
| defensive_rebounds_percentage | character | Defensive rebound percentage, formatted. |
| rebounds_percentage | character | Total rebound percentage, formatted. |
| assists_to_turnovers_ratio | numeric | Assist-to-turnover ratio. |
| assists_ratio | character | Assist ratio (assists per 100 possessions used), formatted. |
| turnovers_ratio | character | Turnover ratio (turnovers per 100 possessions used), formatted. |
| two_point_attempts_ratio | character | Share of field-goal attempts that are two-pointers, formatted. |
| three_point_attempts_ratio | character | Share of field-goal attempts that are three-pointers, formatted. |
| free_throws_rate | character | Free-throw rate (free-throw attempts per field-goal attempt), formatted. |
| possesions | numeric | Possessions (sic: the API spells it this way). |
| player_code | character | Player: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| player_name | character | Player: display name. |
| player_age | integer | Age of the player in years. |
| player_image_url | character | Player: URL of the image. |
| player_team_code | character | Player: euroLeague club code (Utf8 join key). |
| player_team_tv_codes | character | Player: three-letter broadcast abbreviation(s) of the club. |
| player_team_name | character | Player: club display name. |
| player_team_image_url | character | Player: URL of the club crest image. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_player_stats(competition_code = "E", season_code = "E2025", limit = 25) euroleague_player_stats(competition_code = "E", season_code = "E2025", mode = "advanced") })try({ euroleague_player_stats(competition_code = "E", season_code = "E2025", limit = 25) euroleague_player_stats(competition_code = "E", season_code = "E2025", mode = "advanced") })
EuroLeague Rounds
Description
Get the rounds of a season.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons/{season_code}/rounds
Usage
euroleague_rounds(competition_code, season_code)euroleague_rounds(competition_code, season_code)
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per round:
| col_name | types | description |
| season_code | character | Season code: competition code + start year, e.g. E2025 for 2025-26 (Utf8 join key). |
| phase_type_code | character | Phase type code (RS = regular season, PO = playoffs, ...). |
| round | integer | Round number within the season. |
| index | integer | Ordinal position of the round within the season. |
| name | character | Display name. |
| min_game_start_date | character | Earliest game start in the round (ISO 8601). |
| max_game_start_date | character | Latest game start in the round (ISO 8601). |
| dates_formmated | character | Human-readable date range of the round (sic: the API spells it this way). |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_seasons(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_rounds(competition_code = "E", season_code = "E2025") })try({ euroleague_rounds(competition_code = "E", season_code = "E2025") })
EuroLeague Seasons
Description
Get the seasons of a competition.
Endpoint: GET https://api-live.euroleague.net/v2/competitions/{competition_code}/seasons
Usage
euroleague_seasons(competition_code)euroleague_seasons(competition_code)
Arguments
competition_code |
(character required): |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per season:
| col_name | types | description |
| name | character | Display name. |
| code | character | EuroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| alias | character | Short display alias. |
| competition_code | character | Competition code (E = EuroLeague, U = EuroCup; Utf8 join key). |
| year | integer | Start year of the season. |
| start_date | character | Start date (ISO 8601). |
| activation_date | character | Date the season was activated in the engine (ISO 8601). |
| end_date | character | End date (ISO 8601). |
| winner | numeric | Winning club of the season (null while in progress). |
| winner_code | character | Winning club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| winner_name | character | Winning club: display name. |
| winner_abbreviated_name | character | Winning club: abbreviated display name. |
| winner_editorial_name | character | Winning club: editorial (long-form) display name. |
| winner_tv_code | character | Winning club: three-letter broadcast abbreviation of the club. |
| winner_is_virtual | character | Winning club: whether the club is a placeholder rather than a real club. |
| winner_images_crest | character | Winning club: URL of the club crest image. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_standings(),
euroleague_team_stats()
Examples
try({ euroleague_seasons(competition_code = "E") })try({ euroleague_seasons(competition_code = "E") })
EuroLeague Standings
Description
Get the standings as of a round: basic (W-L, points, home / away / last-10 records), calendar (per-round result streaks), streaks (longest win / loss runs) or aheadbehind (records when ahead / behind / tied after Q1, the half and Q3), one row per team.
Endpoint: GET https://api-live.euroleague.net/v3/competitions/{competition_code}/seasons/{season_code}/rounds/{round}/{kind}
The standings live under a round, not the season: pass the round
number the table should be as of (the round column of
euroleague_rounds()). The season winner block of the payload is dropped
(it is null while the season is in progress).
Usage
euroleague_standings( competition_code, season_code, round, kind = c("basicstandings", "calendarstandings", "streaks", "aheadbehind") )euroleague_standings( competition_code, season_code, round, kind = c("basicstandings", "calendarstandings", "streaks", "aheadbehind") )
Arguments
competition_code |
(character required): |
season_code |
(character required): Competition code + start year,
e.g. |
round |
(integer required): Round number within the season; the standings are as of this round. |
kind |
(character default |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per team. The columns depend on
kind:
kind = "basicstandings"
| col_name | types | description |
| position | integer | Position code of the player (engine integer). |
| position_change | character | Movement since the previous round (Up, Down, Equal). |
| games_played | integer | Games played. |
| games_won | integer | Games won. |
| games_lost | integer | Games lost. |
| qualified | logical | Whether the team has clinched qualification for the next phase. |
| win_percentage | character | Win percentage, formatted (e.g. 100%). |
| points_difference | character | Points for minus points against, signed and formatted (e.g. +19). |
| points_for | integer | Points scored. |
| points_against | integer | Points conceded. |
| home_record | character | Home win-loss record (W-L). |
| away_record | character | Away win-loss record (W-L). |
| neutral_record | character | Neutral-venue win-loss record (W-L). |
| overtime_record | character | Overtime win-loss record (W-L). |
| last_ten_record | character | Win-loss record over the last ten games (W-L). |
| group_name | character | Group: display name. |
| last5_form | character | Results of the last five games, oldest first (W / L), JSON-encoded. |
| club_code | character | Club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| club_name | character | Club: display name. |
| club_abbreviated_name | character | Club: abbreviated display name. |
| club_editorial_name | character | Club: editorial (long-form) display name. |
| club_tv_code | character | Club: three-letter broadcast abbreviation of the club. |
| club_is_virtual | logical | Club: whether the club is a placeholder rather than a real club. |
| club_images_crest | character | Club: URL of the club crest image. |
kind = "calendarstandings" (the streaks cell is JSON text: semantically
equal to sdv-py's, not byte-equal – separators and unicode escaping differ)
| col_name | types | description |
| position | integer | Position code of the player (engine integer). |
| position_change | character | Movement since the previous round (Up, Down, Equal). |
| games_played | integer | Games played. |
| games_won | integer | Games won. |
| games_lost | integer | Games lost. |
| qualified | logical | Whether the team has clinched qualification for the next phase. |
| group_name | character | Group: display name. |
| streaks | character | Per-round result streaks: start date, end date and W-L record of each run, JSON-encoded. |
| club_code | character | Club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| club_name | character | Club: display name. |
| club_abbreviated_name | character | Club: abbreviated display name. |
| club_editorial_name | character | Club: editorial (long-form) display name. |
| club_tv_code | character | Club: three-letter broadcast abbreviation of the club. |
| club_is_virtual | logical | Club: whether the club is a placeholder rather than a real club. |
| club_images_crest | character | Club: URL of the club crest image. |
kind = "streaks"
| col_name | types | description |
| position | integer | Position code of the player (engine integer). |
| position_change | character | Movement since the previous round (Up, Down, Equal). |
| games_played | integer | Games played. |
| games_won | integer | Games won. |
| games_lost | integer | Games lost. |
| qualified | logical | Whether the team has clinched qualification for the next phase. |
| home_record | character | Home win-loss record (W-L). |
| away_record | character | Away win-loss record (W-L). |
| last10 | character | Win-loss record over the last ten games (W-L). |
| home_last5 | character | Win-loss record over the last five home games (W-L). |
| away_last5 | character | Win-loss record over the last five away games (W-L). |
| longest_wins_streak_current_season | integer | Longest winning streak this season. |
| longest_loses_streak_current_season | integer | Longest losing streak this season. |
| longest_wins_streak_any_season | integer | Longest winning streak in any season. |
| longest_loses_streak_any_season | integer | Longest losing streak in any season. |
| group_name | character | Group: display name. |
| club_code | character | Club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| club_name | character | Club: display name. |
| club_abbreviated_name | character | Club: abbreviated display name. |
| club_editorial_name | character | Club: editorial (long-form) display name. |
| club_tv_code | character | Club: three-letter broadcast abbreviation of the club. |
| club_is_virtual | logical | Club: whether the club is a placeholder rather than a real club. |
| club_images_crest | character | Club: URL of the club crest image. |
kind = "aheadbehind"
| col_name | types | description |
| position | integer | Position code of the player (engine integer). |
| position_change | character | Movement since the previous round (Up, Down, Equal). |
| games_played | integer | Games played. |
| games_won | integer | Games won. |
| games_lost | integer | Games lost. |
| qualified | logical | Whether the team has clinched qualification for the next phase. |
| wins_percentage | character | Win percentage, formatted (e.g. 100%). |
| quater1_ahead | character | Win-loss record when ahead after the 1st quarter (W-L; sic: the API spells quarter this way). |
| quater1_behind | character | Win-loss record when behind after the 1st quarter (W-L; sic: the API spells quarter this way). |
| quater1_tied | character | Win-loss record when tied after the 1st quarter (W-L; sic: the API spells quarter this way). |
| half1_ahead | character | Win-loss record when ahead at the half (W-L; sic: the API spells quarter this way). |
| half1_behind | character | Win-loss record when behind at the half (W-L; sic: the API spells quarter this way). |
| half1_tied | character | Win-loss record when tied at the half (W-L; sic: the API spells quarter this way). |
| quater3_ahead | character | Win-loss record when ahead after the 3rd quarter (W-L; sic: the API spells quarter this way). |
| quater3_behind | character | Win-loss record when behind after the 3rd quarter (W-L; sic: the API spells quarter this way). |
| quater3_tied | character | Win-loss record when tied after the 3rd quarter (W-L; sic: the API spells quarter this way). |
| group_name | character | Group: display name. |
| club_code | character | Club: euroLeague code of the entity (competition, season, club, person or venue; Utf8 join key). |
| club_name | character | Club: display name. |
| club_abbreviated_name | character | Club: abbreviated display name. |
| club_editorial_name | character | Club: editorial (long-form) display name. |
| club_tv_code | character | Club: three-letter broadcast abbreviation of the club. |
| club_is_virtual | logical | Club: whether the club is a placeholder rather than a real club. |
| club_images_crest | character | Club: URL of the club crest image. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_team_stats()
Examples
try({ euroleague_standings(competition_code = "E", season_code = "E2025", round = 1) euroleague_standings(competition_code = "E", season_code = "E2025", round = 1, kind = "streaks") })try({ euroleague_standings(competition_code = "E", season_code = "E2025", round = 1) euroleague_standings(competition_code = "E", season_code = "E2025", round = 1, kind = "streaks") })
EuroLeague Team Stats (season)
Description
Get season team stats, traditional (box-score totals or per-game averages) or advanced (eFG%, TS%, four-factor style rates), one row per team.
Endpoint: GET https://api-live.euroleague.net/v3/competitions/{competition_code}/statistics/teams/{mode}
Usage
euroleague_team_stats( competition_code, mode = c("traditional", "advanced"), season_mode = "Single", season_code = NULL, statistic_mode = "PerGame", limit = NULL, offset = NULL )euroleague_team_stats( competition_code, mode = c("traditional", "advanced"), season_mode = "Single", season_code = NULL, statistic_mode = "PerGame", limit = NULL, offset = NULL )
Arguments
competition_code |
(character required): |
mode |
(character default |
season_mode |
(character default |
season_code |
(character required by the API): Competition code +
start year, e.g. |
statistic_mode |
(character default |
limit |
(integer optional): Page size. |
offset |
(integer optional): Row offset into the full list. |
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only wraps it (wrap-only: payloads are not redistributed as release assets). This function mirrors its sdv-py twin of the same name: same arguments, defaults and snake_case columns, one row per sdv-py row.
A failed request raises a classed condition instead of returning an empty
frame, mirroring sdv-py's error vocabulary: a 404 is hoopR_no_data, a
400 / 422 is hoopR_invalid_request, any other failure (another status, a
transport error, a non-JSON body) is hoopR_fetch_error; all three inherit
hoopR_error.
Value
A hoopR_data tibble with one row per team. The columns depend on
mode:
mode = "traditional"
| col_name | types | description |
| team_ranking | integer | Rank of the team on the requested statistic mode. |
| games_played | numeric | Games played. |
| minutes_played | numeric | Minutes played. |
| points_scored | numeric | Points scored. |
| two_pointers_made | numeric | Two-point field goals made. |
| two_pointers_attempted | numeric | Two-point field goals attempted. |
| two_pointers_percentage | character | Two-point field-goal percentage, formatted. |
| three_pointers_made | numeric | Three-point field goals made. |
| three_pointers_attempted | numeric | Three-point field goals attempted. |
| three_pointers_percentage | character | Three-point field-goal percentage, formatted. |
| free_throws_made | numeric | Free throws made. |
| free_throws_attempted | numeric | Free throws attempted. |
| free_throws_percentage | character | Free-throw percentage, formatted. |
| offensive_rebounds | numeric | Offensive rebounds. |
| defensive_rebounds | numeric | Defensive rebounds. |
| total_rebounds | numeric | Total rebounds. |
| assists | numeric | Assists. |
| steals | numeric | Steals. |
| turnovers | numeric | Turnovers. |
| blocks | numeric | Blocks made. |
| blocks_against | numeric | Shots blocked by the opponent. |
| fouls_commited | numeric | Personal fouls committed. |
| fouls_drawn | numeric | Fouls drawn. |
| pir | numeric | Performance index rating (PIR). |
| team_code | character | EuroLeague club code (Utf8 join key). |
| team_tv_codes | character | Three-letter broadcast abbreviation(s) of the club. |
| team_name | character | Club display name. |
| team_image_url | character | URL of the club crest image. |
mode = "advanced"
| col_name | types | description |
| team_ranking | integer | Rank of the team on the requested statistic mode. |
| games_played | numeric | Games played. |
| effective_field_goal_percentage | character | Effective field-goal percentage, formatted. |
| true_shooting_percentage | character | True shooting percentage, formatted. |
| offensive_rebounds_percentage | character | Offensive rebound percentage, formatted. |
| defensive_rebounds_percentage | character | Defensive rebound percentage, formatted. |
| rebounds_percentage | character | Total rebound percentage, formatted. |
| assists_to_turnovers_ratio | numeric | Assist-to-turnover ratio. |
| assists_ratio | character | Assist ratio (assists per 100 possessions used), formatted. |
| turnovers_ratio | character | Turnover ratio (turnovers per 100 possessions used), formatted. |
| two_point_rate | character | Share of field-goal attempts that are two-pointers, formatted. |
| three_point_rate | character | Share of field-goal attempts that are three-pointers, formatted. |
| free_throws_rate | character | Free-throw rate (free-throw attempts per field-goal attempt), formatted. |
| points_from_two_pointers_percentage | character | Share of points from two-pointers, formatted. |
| points_from_three_pointers_percentage | character | Share of points from three-pointers, formatted. |
| points_from_free_throws_percentage | character | Share of points from free throws, formatted. |
| team_code | character | EuroLeague club code (Utf8 join key). |
| team_tv_codes | character | Three-letter broadcast abbreviation(s) of the club. |
| team_name | character | Club display name. |
| team_image_url | character | URL of the club crest image. |
See Also
Other Euroleague:
euroleague_clubs(),
euroleague_competitions(),
euroleague_game_boxscore(),
euroleague_game_header(),
euroleague_game_pbp(),
euroleague_game_points(),
euroleague_game_report(),
euroleague_game_stats(),
euroleague_games(),
euroleague_people(),
euroleague_player_stats(),
euroleague_rounds(),
euroleague_seasons(),
euroleague_standings()
Examples
try({ euroleague_team_stats(competition_code = "E", season_code = "E2025") euroleague_team_stats(competition_code = "E", season_code = "E2025", mode = "advanced") })try({ euroleague_team_stats(competition_code = "E", season_code = "E2025") euroleague_team_stats(competition_code = "E", season_code = "E2025", mode = "advanced") })
Get Fox Sports Basketball Boxscore
Description
Get Fox Sports Basketball Boxscore
Get Fox Sports Basketball Boxscore
Usage
fox_nba_boxscore(game_id) fox_mbb_boxscore(game_id)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
See Also
Other Fox Basketball Functions:
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_boxscore("106422"))try(fox_nba_boxscore("106422"))
Get Fox Sports Basketball Statistical Leaders
Description
Get Fox Sports Basketball Statistical Leaders
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)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 |
who |
|
page |
0-based page index (default |
Value
A hoopR_data tibble of leaderboard rows (entity_id + stat columns).
Author(s)
Saiem Gilani
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_league_leaders("scoring"))try(fox_nba_league_leaders("scoring"))
Get Fox Sports Basketball Game Odds
Description
Get Fox Sports Basketball Game Odds
Get Fox Sports Basketball Game Odds
Usage
fox_nba_odds(game_id) fox_mbb_odds(game_id)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
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_odds("106422"))try(fox_nba_odds("106422"))
Get Fox Sports Basketball Play-by-Play
Description
Get Fox Sports Basketball Play-by-Play
Get Fox Sports Basketball Play-by-Play
Usage
fox_nba_pbp(game_id) fox_mbb_pbp(game_id)fox_nba_pbp(game_id) fox_mbb_pbp(game_id)
Arguments
game_id |
Fox Bifrost event id (e.g. |
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
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_pbp("106422")) try(fox_mbb_pbp("262052"))try(fox_nba_pbp("106422")) try(fox_mbb_pbp("262052"))
Get Fox Sports Basketball Standings
Description
Get Fox Sports Basketball Standings
Get Fox Sports Basketball Standings
Usage
fox_nba_standings(team_id) fox_mbb_standings(team_id)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
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_standings("1"))try(fox_nba_standings("1"))
Get Fox Sports Basketball Team Game Log
Description
Get Fox Sports Basketball Team Game Log
Get Fox Sports Basketball Team Game Log
Usage
fox_nba_team_gamelog(team_id) fox_mbb_team_gamelog(team_id)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
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_team_gamelog("1"))try(fox_nba_team_gamelog("1"))
Get Fox Sports Basketball Team Roster
Description
Get Fox Sports Basketball Team Roster
Get Fox Sports Basketball Team Roster
Usage
fox_nba_team_roster(team_id) fox_mbb_team_roster(team_id)fox_nba_team_roster(team_id) fox_mbb_team_roster(team_id)
Arguments
team_id |
Fox Bifrost team id (e.g. |
Value
A hoopR_data tibble, one row per player: team_id, position_group,
player, position/age/etc. columns, athlete_id.
Author(s)
Saiem Gilani
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_stats,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_team_roster("1"))try(fox_nba_team_roster("1"))
Get Fox Sports Basketball Team Stat Leaders
Description
Get Fox Sports Basketball Team Stat Leaders
Get Fox Sports Basketball Team Stat Leaders
Usage
fox_nba_team_stats(team_id) fox_mbb_team_stats(team_id)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
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_teams,
fox_mbb_teams_all()
Examples
try(fox_nba_team_stats("1"))try(fox_nba_team_stats("1"))
Get Fox Sports Basketball Team Directory
Description
Get Fox Sports Basketball Team Directory
Get Fox Sports Basketball Team Directory
Usage
fox_nba_teams(team_id = "1") fox_mbb_teams(team_id = "1")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 |
Value
A hoopR_data tibble, one row per team: fox_team_id, fox_team_name, fox_section.
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_mbb_teams_all()
Examples
try(fox_nba_teams())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)fox_mbb_teams_all(max_id = 500, max_calls = 60)
Arguments
max_id |
Highest Fox team id to probe as a seed (default |
max_calls |
Safety cap on the number of standings calls (default |
Value
A hoopR_data tibble, one row per team: fox_team_id,
fox_team_name, fox_section.
See Also
Other Fox Basketball Functions:
fox_basketball_boxscore,
fox_basketball_league_leaders,
fox_basketball_odds,
fox_basketball_pbp,
fox_basketball_standings,
fox_basketball_team_gamelog,
fox_basketball_team_roster,
fox_basketball_team_stats,
fox_basketball_teams
Examples
try(fox_mbb_teams_all())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)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
For helper_espn_mbb_pbp(): a tibble with the columns of espn_mbb_game_all_plays_schema, or NULL
when the game has no play-by-play. home_score / away_score are rebuilt from the
scoring plays when that reproduces the header's official final, otherwise they are
ESPN's per-play values; the last column, score_source ("rebuilt" / "espn"), says which.
Returns a tibble
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)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
For helper_espn_nba_pbp(): a tibble with the columns of espn_nba_game_all_plays_schema, or NULL
when the game has no play-by-play. home_score / away_score are rebuilt from the
scoring plays when that reproduces the header's official final, otherwise they are
ESPN's per-play values; the last column, score_source ("rebuilt" / "espn"), says which.
Returns a tibble
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()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. |
See Also
Other Salary & Draft Functions:
nbadraft_mock_draft(),
spotrac_team_cap()
Examples
try(hoopshype_salaries())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)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))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)kp_coach_history(coach)
Arguments
coach |
Coach filter to select. |
Value
A data frame with 30 columns:
| col_name | types | description |
| year | numeric | 4-digit year. |
| team_rk | numeric | Team rk. |
| team | character | Team-side label or team identifier. |
| coach | character | Coach. |
| conf | character | character. |
| adj_t | character | Adj t. |
| adj_o | character | Adj o. |
| adj_d | character | Adj d. |
| off_e_fg_pct | character | Off e field goals percentage (0-1 decimal). |
| off_to_pct | character | Off to percentage (0-1 decimal). |
| off_or_pct | character | Off or percentage (0-1 decimal). |
| off_ft_rate | character | Off ft rate. |
| off_fg_2_pct | character | Off field goals 2 percentage (0-1 decimal). |
| off_fg_3_pct | character | Off field goals 3 percentage (0-1 decimal). |
| off_ft_pct | character | Off free throws percentage (0-1 decimal). |
| off_fg_3a_pct | character | Off field goals 3a percentage (0-1 decimal). |
| off_a_pct | character | Off a percentage (0-1 decimal). |
| off_apl | character | Off apl. |
| def_e_fg_pct | character | Def e field goals percentage (0-1 decimal). |
| def_to_pct | character | Def to percentage (0-1 decimal). |
| def_or_pct | character | Def or percentage (0-1 decimal). |
| def_ft_rate | character | Def ft rate. |
| def_fg_2_pct | character | Def field goals 2 percentage (0-1 decimal). |
| def_fg_3_pct | character | Def field goals 3 percentage (0-1 decimal). |
| def_blk_pct | character | Def blocks percentage (0-1 decimal). |
| def_fg_3a_pct | character | Def field goals 3a percentage (0-1 decimal). |
| def_a_pct | character | Def a percentage (0-1 decimal). |
| def_apl | character | Def apl. |
| foul2partic_pct | character | Foul2partic percentage (0-1 decimal). |
| wl | character | Wl. |
| wl_conf | character | Wl conf. |
| adj_t_rk | numeric | Adj t rk. |
| adj_o_rk | numeric | Adj o rk. |
| adj_d_rk | numeric | Adj d rk. |
| off_e_fg_pct_rk | numeric | Off e fg pct rk. |
| off_to_pct_rk | numeric | Off to pct rk. |
| off_or_pct_rk | numeric | Off or pct rk. |
| off_ft_rate_rk | numeric | Off ft rate rk. |
| off_fg_2_pct_rk | numeric | Off fg 2 pct rk. |
| off_fg_3_pct_rk | numeric | Off fg 3 pct rk. |
| off_ft_pct_rk | numeric | Off ft pct rk. |
| off_fg_3a_pct_rk | numeric | Off fg 3a pct rk. |
| off_a_pct_rk | numeric | Off a pct rk. |
| off_apl_rk | numeric | Off apl rk. |
| def_e_fg_pct_rk | numeric | Def e fg pct rk. |
| def_to_pct_rk | numeric | Def to pct rk. |
| def_or_pct_rk | numeric | Def or pct rk. |
| def_ft_rate_rk | numeric | Def ft rate rk. |
| def_fg_2_pct_rk | numeric | Def fg 2 pct rk. |
| def_fg_3_pct_rk | numeric | Def fg 3 pct rk. |
| def_blk_pct_rk | numeric | Def blk pct rk. |
| def_fg_3a_pct_rk | numeric | Def fg 3a pct rk. |
| def_a_pct_rk | numeric | Def a pct rk. |
| def_apl_rk | numeric | Def apl rk. |
| foul2partic_pct_rk | numeric | Foul2partic pct rk. |
| team_finish | character | Team finish. |
| ncaa_seed | numeric | Ncaa seed. |
See Also
Other KenPom Historical Functions:
kp_conf(),
kp_confhistory(),
kp_confstats(),
kp_pomeroy_archive_ratings(),
kp_program_ratings(),
kp_team_history()
Examples
try(kp_coach_history(coach = 'Leonard Hamilton'))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)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', |
Value
A list of named data frames:
Standings
| col_name | types | description |
| team | character | Team-side label or team identifier. |
| overall | character | Overall. |
| conf | character | character. |
| adj_em | numeric | Adj em. |
| adj_em_rk | numeric | Adj em rk. |
| adj_o | numeric | Adj o. |
| adj_o_rk | numeric | Adj o rk. |
| adj_d | numeric | Adj d. |
| adj_d_rk | numeric | Adj d rk. |
| adj_t | numeric | Adj t. |
| adj_t_rk | numeric | Adj t rk. |
| conf_sos | numeric | Conf sos. |
| conf_sos_rk | numeric | Conf sos rk. |
| next_game | character | Next game date or opponent. |
| year | numeric | 4-digit year. |
ConferencePlayOffense
| col_name | types | description |
| team | character | Team-side label or team identifier. |
| oe | numeric | Oe. |
| oe_rk | numeric | Oe rk. |
| e_fg_pct | numeric | E field goals percentage (0-1 decimal). |
| e_fg_pct_rk | numeric | E fg pct rk. |
| to_pct | numeric | To percentage (0-1 decimal). |
| to_pct_rk | numeric | To pct rk. |
| or_pct | numeric | Or percentage (0-1 decimal). |
| or_pct_rk | numeric | Or pct rk. |
| ft_rate | numeric | Ft rate. |
| ft_rate_rk | numeric | Ft rate rk. |
| fg_2_pct | numeric | Field goals 2 percentage (0-1 decimal). |
| fg_2_pct_rk | numeric | Fg 2 pct rk. |
| fg_3_pct | numeric | Field goals 3 percentage (0-1 decimal). |
| fg_3_pct_rk | numeric | Fg 3 pct rk. |
| ft_pct | numeric | Free throw percentage (0-1). |
| ft_pct_rk | numeric | Ft pct rk. |
| tempo | numeric | Tempo. |
| tempo_rk | numeric | Tempo rk. |
| year | numeric | 4-digit year. |
ConferencePlayDefense
| col_name | types | description |
| team | character | Team-side label or team identifier. |
| de | numeric | De. |
| de_rk | numeric | De rk. |
| e_fg_pct | numeric | E field goals percentage (0-1 decimal). |
| e_fg_pct_rk | numeric | E fg pct rk. |
| to_pct | numeric | To percentage (0-1 decimal). |
| to_pct_rk | numeric | To pct rk. |
| or_pct | numeric | Or percentage (0-1 decimal). |
| or_pct_rk | numeric | Or pct rk. |
| ft_rate | numeric | Ft rate. |
| ft_rate_rk | numeric | Ft rate rk. |
| fg_2_pct | numeric | Field goals 2 percentage (0-1 decimal). |
| fg_2_pct_rk | numeric | Fg 2 pct rk. |
| fg_3_pct | numeric | Field goals 3 percentage (0-1 decimal). |
| fg_3_pct_rk | numeric | Fg 3 pct rk. |
| blk_pct | numeric | Blocks percentage (0-1 decimal). |
| blk_pct_rk | numeric | Blk pct rk. |
| stl_pct | numeric | Steals percentage (0-1 decimal). |
| stl_pct_rk | numeric | Stl pct rk. |
| year | numeric | 4-digit year. |
AllKenPom
| col_name | types | description |
| rk | integer | Rk. |
| player | character | Player. |
| year | numeric | 4-digit year. |
ConferenceAggregateStats
| col_name | types | description |
| stat | character | Stat. |
| value | numeric | Numeric or string value field. |
| rk | numeric | Rk. |
| year | numeric | 4-digit year. |
WinningTrends
| col_name | types | description |
| stat | character | Stat. |
| count | character | Count of count. |
| value | numeric | Numeric or string value field. |
| rk | numeric | Rk. |
| year | numeric | 4-digit year. |
ConferenceComparison
| col_name | types | description |
| rk | numeric | Rk. |
| conference | character | Conference. |
| rating | numeric | Rating. |
| year | numeric | 4-digit year. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_confhistory(),
kp_confstats(),
kp_pomeroy_archive_ratings(),
kp_program_ratings(),
kp_team_history()
Examples
try(kp_conf(year = 2020, conf = 'ACC'))try(kp_conf(year = 2020, conf = 'ACC'))
Get KenPom's historical conference ratings
Description
Get KenPom's historical conference ratings
Usage
kp_confhistory(conf)kp_confhistory(conf)
Arguments
conf |
Used to limit to players in a specific conference. Allowed values are: 'A10', 'ACC', 'AE', 'AMER', 'ASUN', 'B10', 'B12', 'BE', 'BSKY', 'BSTH', 'BW', 'CAA', 'CUSA', 'HORZ', 'IND', IVY', 'MAAC', 'MAC', 'MEAC', 'MVC', 'MWC', 'NEC', 'OVC', 'P12', 'PAT', 'SB', 'SC', 'SEC', 'SLND', 'SUM', 'SWAC', 'WAC', 'WCC'. If you try to use a conference that doesn't exist for a given season, like 'IND' and '2018', you'll get an empty table, as kenpom.com doesn't serve 404 pages for invalid table queries like that. No filter applied by default. |
Value
A data frame with the following columns:
| col_name | types | description |
| year | integer | 4-digit year. |
| rank | character | Rank. |
| tempo | numeric | Tempo. |
| efficiency | numeric | Efficiency. |
| e_fg_pct | numeric | E field goals percentage (0-1 decimal). |
| to_pct | numeric | To percentage (0-1 decimal). |
| or_pct | numeric | Or percentage (0-1 decimal). |
| ft_rate | numeric | Ft rate. |
| fg_2_pct | numeric | Field goals 2 percentage (0-1 decimal). |
| fg_3_pct | numeric | Field goals 3 percentage (0-1 decimal). |
| ft_pct | numeric | Free throw percentage (0-1). |
| fg_3a_pct | numeric | Field goals 3a percentage (0-1 decimal). |
| a_pct | numeric | A percentage (0-1 decimal). |
| blk_pct | numeric | Blocks percentage (0-1 decimal). |
| stl_pct | numeric | Steals percentage (0-1 decimal). |
| home_record | character | Home win-loss record. |
| bids | character | Bids. |
| s16 | character | S16. |
| f4 | character | F4. |
| ch | character | Ch. |
| reg_season_champ | character | Reg season champ. |
| tourney_champ | character | Tourney champ. |
| best_team | character | Best team. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_conf(),
kp_confstats(),
kp_pomeroy_archive_ratings(),
kp_program_ratings(),
kp_team_history()
Examples
try(kp_confhistory(conf = 'ACC'))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())kp_confstats(year = most_recent_mbb_season())
Arguments
year |
Year (YYYY) |
Value
A data frame with the following columns:
| col_name | types | description |
| conf | character | character. |
| eff | numeric | Eff. |
| eff_rk | numeric | Eff rk. |
| tempo | numeric | Tempo. |
| tempo_rk | numeric | Tempo rk. |
| e_fg_pct | numeric | E field goals percentage (0-1 decimal). |
| e_fg_pct_rk | numeric | E fg pct rk. |
| to_pct | numeric | To percentage (0-1 decimal). |
| to_pct_rk | numeric | To pct rk. |
| or_pct | numeric | Or percentage (0-1 decimal). |
| or_pct_rk | numeric | Or pct rk. |
| ft_rate | numeric | Ft rate. |
| ft_rate_rk | numeric | Ft rate rk. |
| blk_pct | numeric | Blocks percentage (0-1 decimal). |
| blk_pct_rk | numeric | Blk pct rk. |
| stl_pct | numeric | Steals percentage (0-1 decimal). |
| stl_pct_rk | numeric | Stl pct rk. |
| fg_2_pct | numeric | Field goals 2 percentage (0-1 decimal). |
| fg_2_pct_rk | numeric | Fg 2 pct rk. |
| fg_3_pct | numeric | Field goals 3 percentage (0-1 decimal). |
| fg_3_pct_rk | numeric | Fg 3 pct rk. |
| ft_pct | numeric | Free throw percentage (0-1). |
| ft_pct_rk | numeric | Ft pct rk. |
| fg_3a_pct | numeric | Field goals 3a percentage (0-1 decimal). |
| fg_3a_pct_rk | numeric | Fg 3a pct rk. |
| a_pct | numeric | A percentage (0-1 decimal). |
| a_pct_rk | numeric | A pct rk. |
| home_w_l | character | Home team's wins losses. |
| home_w_l_pct | numeric | Home wins losses percentage (0-1 decimal). |
| home_w_l_rk | numeric | Home team's wins losses rk. |
| close | numeric | Close. |
| close_rk | numeric | Close rk. |
| blowouts | numeric | Blowouts. |
| blowouts_rk | numeric | Blowouts rk. |
| year | numeric | 4-digit year. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_conf(),
kp_confhistory(),
kp_pomeroy_archive_ratings(),
kp_program_ratings(),
kp_team_history()
Examples
try(kp_confstats(year=most_recent_mbb_season()))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)kp_pomeroy_archive_ratings(date)
Arguments
date |
Date (YYYY-MM-DD) |
Value
A data frame with 22 columns:
| col_name | types | description |
| adj_em_rk | numeric | Adj em rk. |
| team | character | Team-side label or team identifier. |
| conf | character | character. |
| adj_em | numeric | Adj em. |
| adj_o | numeric | Adj o. |
| adj_o_rk | numeric | Adj o rk. |
| adj_d | numeric | Adj d. |
| adj_d_rk | numeric | Adj d rk. |
| adj_t | numeric | Adj t. |
| adj_t_rk | numeric | Adj t rk. |
| final_rk | numeric | Final rk. |
| final_adj_em | numeric | Final adj em. |
| final_adj_o | numeric | Final adj o. |
| final_adj_o_rk | numeric | Final adj o rk. |
| final_adj_d | numeric | Final adj d. |
| final_adj_d_rk | numeric | Final adj d rk. |
| final_adj_t | numeric | Final adj t. |
| final_adj_t_rk | numeric | Final adj t rk. |
| rk_chg | numeric | Rk chg. |
| em_chg | numeric | Em chg. |
| adj_t_chg | numeric | Adj t chg. |
| ncaa_seed | numeric | Ncaa seed. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_conf(),
kp_confhistory(),
kp_confstats(),
kp_program_ratings(),
kp_team_history()
Examples
try(kp_pomeroy_archive_ratings(date='2018-11-22'))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())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: |
conf |
Used to limit to players in a specific conference. Allowed values are: 'A10', 'ACC', 'AE', 'AMER', |
conf_only |
Used to define whether stats should reflect conference games only. |
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))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()kp_program_ratings()
Value
A data frame with 17 columns:
| col_name | types | description |
| rk | numeric | Rk. |
| team | character | Team-side label or team identifier. |
| conf | character | character. |
| rtg | numeric | Rtg. |
| best_rk | numeric | Best rk. |
| best_yr | numeric | Best yr. |
| worst_rk | numeric | Worst rk. |
| worst_yr | numeric | Worst yr. |
| kp_median | numeric | Kp median. |
| top10 | numeric | Top10. |
| top25 | numeric | Top25. |
| top50 | numeric | Top50. |
| ch | numeric | Ch. |
| f4 | numeric | F4. |
| s16 | numeric | S16. |
| r1 | numeric | R1. |
| chg | numeric | Chg. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_conf(),
kp_confhistory(),
kp_confstats(),
kp_pomeroy_archive_ratings(),
kp_team_history()
Examples
try(kp_program_ratings())try(kp_program_ratings())
Get KenPom's team efficiency history
Description
Get KenPom's team efficiency history
Usage
kp_team_history(team)kp_team_history(team)
Arguments
team |
Team filter to select. |
Value
A data frame with the following columns:
| col_name | types | description |
| year | numeric | 4-digit year. |
| team_rk | numeric | Team rk. |
| team | character | Team-side label or team identifier. |
| coach | character | Coach. |
| conf | character | character. |
| adj_t | numeric | Adj t. |
| adj_o | numeric | Adj o. |
| adj_d | numeric | Adj d. |
| off_e_fg_pct | numeric | Off e field goals percentage (0-1 decimal). |
| off_to_pct | numeric | Off to percentage (0-1 decimal). |
| off_or_pct | numeric | Off or percentage (0-1 decimal). |
| off_ft_rate | numeric | Off ft rate. |
| off_fg_2_pct | numeric | Off field goals 2 percentage (0-1 decimal). |
| off_fg_3_pct | numeric | Off field goals 3 percentage (0-1 decimal). |
| off_ft_pct | numeric | Off free throws percentage (0-1 decimal). |
| off_fg_3a_pct | numeric | Off field goals 3a percentage (0-1 decimal). |
| off_a_pct | numeric | Off a percentage (0-1 decimal). |
| off_apl | numeric | Off apl. |
| def_e_fg_pct | numeric | Def e field goals percentage (0-1 decimal). |
| def_to_pct | numeric | Def to percentage (0-1 decimal). |
| def_or_pct | numeric | Def or percentage (0-1 decimal). |
| def_ft_rate | numeric | Def ft rate. |
| def_fg_2_pct | numeric | Def field goals 2 percentage (0-1 decimal). |
| def_fg_3_pct | numeric | Def field goals 3 percentage (0-1 decimal). |
| def_blk_pct | numeric | Def blocks percentage (0-1 decimal). |
| def_fg_3a_pct | numeric | Def field goals 3a percentage (0-1 decimal). |
| def_a_pct | numeric | Def a percentage (0-1 decimal). |
| def_apl | numeric | Def apl. |
| foul2partic_pct | numeric | Foul2partic percentage (0-1 decimal). |
| wl | character | Wl. |
| wl_conf | character | Wl conf. |
| adj_t_rk | numeric | Adj t rk. |
| adj_o_rk | numeric | Adj o rk. |
| adj_d_rk | numeric | Adj d rk. |
| off_e_fg_pct_rk | numeric | Off e fg pct rk. |
| off_to_pct_rk | numeric | Off to pct rk. |
| off_or_pct_rk | numeric | Off or pct rk. |
| off_ft_rate_rk | numeric | Off ft rate rk. |
| off_fg_2_pct_rk | numeric | Off fg 2 pct rk. |
| off_fg_3_pct_rk | numeric | Off fg 3 pct rk. |
| off_ft_pct_rk | numeric | Off ft pct rk. |
| off_fg_3a_pct_rk | numeric | Off fg 3a pct rk. |
| off_a_pct_rk | numeric | Off a pct rk. |
| off_apl_rk | numeric | Off apl rk. |
| def_e_fg_pct_rk | numeric | Def e fg pct rk. |
| def_to_pct_rk | numeric | Def to pct rk. |
| def_or_pct_rk | numeric | Def or pct rk. |
| def_ft_rate_rk | numeric | Def ft rate rk. |
| def_fg_2_pct_rk | numeric | Def fg 2 pct rk. |
| def_fg_3_pct_rk | numeric | Def fg 3 pct rk. |
| def_blk_pct_rk | numeric | Def blk pct rk. |
| def_fg_3a_pct_rk | numeric | Def fg 3a pct rk. |
| def_a_pct_rk | numeric | Def a pct rk. |
| def_apl_rk | numeric | Def apl rk. |
| foul2partic_pct_rk | numeric | Foul2partic pct rk. |
| team_finish | character | Team finish. |
| ncaa_seed | numeric | Ncaa seed. |
See Also
Other KenPom Historical Functions:
kp_coach_history(),
kp_conf(),
kp_confhistory(),
kp_confstats(),
kp_pomeroy_archive_ratings(),
kp_program_ratings()
Examples
try(kp_team_history(team = 'Florida St.'))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)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))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)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: |
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"))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()login(user_email = Sys.getenv("KP_USER"), user_pw = Sys.getenv("KP_PW")) kp_user_email() kp_password() has_kp_user_and_pw()
Arguments
user_email |
User subscription e-mail |
user_pw |
User subscription password |
Details
Using your KenPom subscription with the package:
Run usethis::edit_r_environ() and THEN paste the following in the new script that pops up (without quotations)
KP_USER = [email protected] KP_PW = XXX-YOUR-PASSWORD-XXX
You can save the login information for consistent usage by adding
KP_USER = [email protected] KP_PW = XXX-YOUR-PASSWORD-XXX ``` \cr to your .REnviron file (easily accessed via [**`usethis::edit_r_environ()`**](https://usethis.r-lib.org/reference/edit.html)).\cr \cr For less consistent usage:\cr At the beginning of every session or within an R environment, save your login e-mail and password as the environment variables `KP_USER` and `KP_PW` (with quotations) using a command like the following.\cr ```{r} Sys.setenv(KP_USER = "[email protected]") Sys.setenv(KP_PW = "XXX-YOUR-PASSWORD-XXX")
Load conference and division aliases (MBB / NBA) from the data repo
Description
Loads every name and id that a source (ESPN, NCAA, KenPom,
NBA Stats, SDV) uses for a group, with the seasons each alias is valid
for. Use it to map a source's conference id or name onto an SDV
group_id. load_mbb_group_aliases() reads the mbb_groups release tag
and load_nba_group_aliases() the nba_groups tag.
Usage
load_mbb_group_aliases(..., dbConnection = NULL, tablename = NULL) load_nba_group_aliases(..., dbConnection = NULL, tablename = NULL)load_mbb_group_aliases(..., dbConnection = NULL, tablename = NULL) load_nba_group_aliases(..., dbConnection = NULL, tablename = NULL)
Arguments
... |
Additional arguments passed to an underlying function that writes the data into a database. |
dbConnection |
A |
tablename |
The name of the data table within the database |
Value
Returns a hoopR_data tibble with one row per alias.
| col_name | types | description |
| league | character | League key: mbb or nba. |
| group_id | character | SDV group id, {league}:{slug}. |
| source | character | Source that uses the alias: espn, ncaa, kenpom or sdv (MBB); espn, nba_stats or sdv (NBA). |
| source_id | character | The source's own id for the group (e.g. ESPN group id, NCAA conference id), when it has one. |
| name_kind | character | Kind of alias: name, short_name, abbreviation, slug, or code. |
| value | character | The alias itself. |
| valid_from | integer | First season (ending year) the alias applies, inclusive; NA means unbounded. |
| valid_to | integer | Last season (ending year) the alias applies, inclusive; NA means unbounded.
|
Author(s)
Saiem Gilani
See Also
Other Conference and Division Group loader functions:
load_mbb_group_seasons(),
load_mbb_groups(),
load_mbb_team_group_seasons()
Examples
try(load_mbb_group_aliases()) try(load_nba_group_aliases())try(load_mbb_group_aliases()) try(load_nba_group_aliases())
Load conference and division names by season (MBB / NBA) from the data repo
Description
Loads one row per group per season it existed, with the
group's name, short name, abbreviation, and parent group as of that
season rather than today's labels, plus its member count.
load_mbb_group_seasons() reads the mbb_groups release tag and
load_nba_group_seasons() the nba_groups tag.
Usage
load_mbb_group_seasons(..., dbConnection = NULL, tablename = NULL) load_nba_group_seasons(..., dbConnection = NULL, tablename = NULL)load_mbb_group_seasons(..., dbConnection = NULL, tablename = NULL) load_nba_group_seasons(..., dbConnection = NULL, tablename = NULL)
Arguments
... |
Additional arguments passed to an underlying function that writes the data into a database. |
dbConnection |
A |
tablename |
The name of the data table within the database |
Value
Returns a hoopR_data tibble with one row per group-season.
| col_name | types | description |
| league | character | League key: mbb or nba. |
| group_id | character | SDV group id, {league}:{slug}. |
| season | integer | Season (ending year; 2025 = 2024-25). |
| level | character | Group level: league, subdivision, conference, or division. |
| name | character | Group name as of that season. |
| short_name | character | Group short name as of that season. |
| abbreviation | character | Group abbreviation as of that season. |
| parent_group_id | character | Parent group id as of that season (division to conference to subdivision or league). |
| n_teams | integer | Number of member teams that season. |
Author(s)
Saiem Gilani
See Also
Other Conference and Division Group loader functions:
load_mbb_group_aliases(),
load_mbb_groups(),
load_mbb_team_group_seasons()
Examples
try(load_mbb_group_seasons()) try(load_nba_group_seasons())try(load_mbb_group_seasons()) try(load_nba_group_seasons())
Load conference and division lineages (MBB / NBA) from the data repo
Description
Loads one row per group lineage – the league or subdivision,
each conference, and each division – with the first and last season
each had at least one member. A lineage keeps one group_id across
renames that keep continuity (American Athletic to American stays
mbb:american); a new body gets a new id. load_mbb_groups() reads the
mbb_groups release tag and load_nba_groups() the nba_groups tag.
See load_mbb_group_seasons() for per-season names and parents,
load_mbb_group_aliases() for the names and ids other sources use, and
load_mbb_team_group_seasons() for team membership.
Usage
load_mbb_groups(..., dbConnection = NULL, tablename = NULL) load_nba_groups(..., dbConnection = NULL, tablename = NULL)load_mbb_groups(..., dbConnection = NULL, tablename = NULL) load_nba_groups(..., dbConnection = NULL, tablename = NULL)
Arguments
... |
Additional arguments passed to an underlying function that writes the data into a database. |
dbConnection |
A |
tablename |
The name of the data table within the database |
Value
Returns a hoopR_data tibble with one row per group lineage.
| col_name | types | description |
| league | character | League key: mbb or nba. |
| group_id | character | SDV group id, {league}:{slug} (e.g. mbb:big-east, nba:atlantic); one id per lineage across renames. |
| level | character | Group level: league (NBA), subdivision (MBB Division I), conference, or division. |
| first_season | integer | First season (ending year) with at least one member. |
| last_season | integer | Last season (ending year) with at least one member. |
| notes | character | Lineage decisions and source caveats. |
Author(s)
Saiem Gilani
See Also
Other Conference and Division Group loader functions:
load_mbb_group_aliases(),
load_mbb_group_seasons(),
load_mbb_team_group_seasons()
Examples
try(load_mbb_groups()) try(load_nba_groups())try(load_mbb_groups()) try(load_nba_groups())
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 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 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 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_idis the athlete's CURRENT team, not their team in the requested season. Season team lives inload_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 )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 |
dbConnection |
A |
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 after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). |
| home_score | integer | Home team score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). |
| 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). |
| score_source | character | Where this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair. |
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. |
See Also
Other hoopR Loader Functions:
load_nba_pbp()
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_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 team conference membership by season (MBB / NBA) from the data repo
Description
Loads one row per team per season with the team's
subdivision, conference, and division that season, taken from the most
reliable per-season source and cross-checked against a second source
where one exists. Membership is never back-filled from today's
alignment. load_mbb_team_group_seasons() reads the mbb_groups
release tag and load_nba_team_group_seasons() the nba_groups tag.
Usage
load_mbb_team_group_seasons( seasons = most_recent_mbb_season(), ..., dbConnection = NULL, tablename = NULL ) load_nba_team_group_seasons( seasons = most_recent_nba_season(), ..., dbConnection = NULL, tablename = NULL )load_mbb_team_group_seasons( seasons = most_recent_mbb_season(), ..., dbConnection = NULL, tablename = NULL ) load_nba_team_group_seasons( seasons = most_recent_nba_season(), ..., dbConnection = NULL, tablename = NULL )
Arguments
seasons |
A vector of 4-digit season-ending years (2025 = 2024-25).
Published coverage runs from 2002 (MBB) or 1971 (NBA) through the most
recent season. Pass |
... |
Additional arguments passed to an underlying function that writes the data into a database. |
dbConnection |
A |
tablename |
The name of the data table within the database |
Value
Returns a hoopR_data tibble with one row per team-season.
| col_name | types | description |
| league | character | League key: mbb or nba. |
| season | integer | Season (ending year; 2025 = 2024-25). |
| team_id | character | ESPN team id. |
| team_id_source | character | Id system of team_id: espn. |
| team_name | character | Team name as of that season. |
| subdivision_id | character | SDV group id of the subdivision (mbb:d1); NA for the NBA. |
| conference_id | character | SDV group id of the conference. |
| division_id | character | SDV group id of the division; NA where the league or conference had none. |
| source | character | Source the membership came from: espn_standings, espn_core_groups or kenpom (MBB); nba_stats or curated (NBA). |
| sources_agree | logical | Whether a second source agrees; NA when only one source covers the season. |
| notes | character | Membership caveats. |
Author(s)
Saiem Gilani
See Also
Other Conference and Division Group loader functions:
load_mbb_group_aliases(),
load_mbb_group_seasons(),
load_mbb_groups()
Examples
try(load_mbb_team_group_seasons(seasons = most_recent_mbb_season())) try(load_nba_team_group_seasons(seasons = most_recent_nba_season()))try(load_mbb_team_group_seasons(seasons = most_recent_mbb_season())) try(load_nba_team_group_seasons(seasons = most_recent_nba_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 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 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 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_idis the athlete's CURRENT team, not their team in the requested season. Season team lives inload_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 )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 |
dbConnection |
A |
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 after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). |
| home_score | integer | Home team score after the play. Rebuilt from the scoring plays in feed order when that reaches the official final (score_source 'rebuilt'), otherwise ESPN's per-play value (score_source 'espn'). |
| 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. |
| score_source | character | Where this game's home_score/away_score come from: 'rebuilt' (summed from the scoring plays and equal to the official final on the last play) or 'espn' (ESPN's per-play values, kept when the rebuild misses the final or the game has no final). Absent from seasons published before the repair. |
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. |
See Also
Other hoopR Loader Functions:
load_mbb_pbp()
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_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 )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 |
... |
Additional arguments passed to an underlying function that writes the season data into a database. |
dbConnection |
A |
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()))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 )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. |
... |
Additional arguments passed to an underlying function that writes the season data into a database. |
dbConnection |
A |
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.
See Also
Other NBA Stats loader functions:
load_nba_stats_leaguedash()
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()))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 )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. |
table |
Name of the cube table to load. One of |
... |
Additional arguments passed to an underlying function that writes the season data into a database. |
dbConnection |
A |
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.
See Also
Other NBA Stats loader functions:
load_nba_stats_coaches()
Examples
try(load_nba_stats_leaguedash(seasons = most_recent_nba_stats_season(), table = "player_bio"))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())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: |
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.
See Also
Other NBA Crosswalk Functions:
nba_player_crosswalk(),
nba_schedule_crosswalk(),
nba_team_crosswalk()
Other MBB Crosswalk Functions:
mbb_player_crosswalk(),
mbb_schedule_crosswalk(),
mbb_team_crosswalk()
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_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 )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. |
... |
Additional arguments passed to an underlying function that writes the season data into a database. |
dbConnection |
A |
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()))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)mbb_player_crosswalk(season = most_recent_mbb_season(), min_confidence = 0.92)
Arguments
season |
Season year (4-digit, e.g. |
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). |
See Also
Other MBB Crosswalk Functions:
load_nba_team_crosswalk(),
mbb_schedule_crosswalk(),
mbb_team_crosswalk()
Examples
try(mbb_player_crosswalk(season = 2025))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 )mbb_schedule_crosswalk( season = most_recent_mbb_season(), include_kenpom = FALSE )
Arguments
season |
Season year (4-digit, e.g. |
include_kenpom |
Logical. When |
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. |
See Also
Other MBB Crosswalk Functions:
load_nba_team_crosswalk(),
mbb_player_crosswalk(),
mbb_team_crosswalk()
Examples
try(mbb_schedule_crosswalk(season = 2025))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.
Every source is read as of season:
-
espn_conferenceis the conference each team was in that season, under that season's name, from the SDV conference reference (load_mbb_team_group_seasons()andload_mbb_group_seasons()). The ESPN team list itself is today's Division I list, so a team that was not in a Division I conference that season has an NAespn_conference. -
fox_sectioncomes from Fox's per-conference standings for that season (league/standings?groupId=&season=), which start in 2017-18: earlier seasons get NAfox_*. Fox lists teams under the conference they joined the NEXT season, sofox_sectionis set to NA where it disagrees withespn_conference, and for any Fox conference with fewer than two agreeing teams that stay put the next season.fox_team_idis kept. -
bart_*comes from Torvik's{season}_team_results.csv(2008 on; earlier seasons get NAbart_*). -
kp_*comes fromteams_linksfor that season (2002-2026); a season it does not carry gets NAkp_*.
A source that fails raises an error instead of returning a crosswalk
whose columns are silently all NA. Torvik answering with no teams
(blocked or empty) for a season it covers, Fox returning no standings for
the season, and a missing conference reference raise an error of class
crosswalk_source_error.
Usage
mbb_team_crosswalk(season = most_recent_mbb_season(), fox = NULL)mbb_team_crosswalk(season = most_recent_mbb_season(), fox = NULL)
Arguments
season |
Season year (4-digit, ending year, e.g. |
fox |
An already-fetched frame with |
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 | Conference that season, under that season's name (NA if not in a Division I conference). |
| 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 that season (NA if unmatched or unconfirmed). |
| 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". |
See Also
Other MBB Crosswalk Functions:
load_nba_team_crosswalk(),
mbb_player_crosswalk(),
mbb_schedule_crosswalk()
Examples
try(mbb_team_crosswalk(season = 2025))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_mbb_season()
Most Recent NBA Season
Description
Most Recent NBA Season
Usage
most_recent_nba_season()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()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)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.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
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)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
![[Deprecated]](../help/figures/lifecycle-deprecated.svg)
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.
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() - 2), season_type = "Regular Season", ... ) nba_assisttracker( league_id = "00", per_mode = "PerGame", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_leagueleaders( active_flag = "", league_id = "00", per_mode = "Totals", scope = "S", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", stat_category = "PTS", ... ) nba_dunkscoreleaders( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", player_id = "", team_id = "", game_id = "", ... ) nba_gravityleaders( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... )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() - 2), season_type = "Regular Season", ... ) nba_assisttracker( league_id = "00", per_mode = "PerGame", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_leagueleaders( active_flag = "", league_id = "00", per_mode = "Totals", scope = "S", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", stat_category = "PTS", ... ) nba_dunkscoreleaders( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", player_id = "", team_id = "", game_id = "", ... ) nba_gravityleaders( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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")
nba_leagueleaders(league_id = '00')
nba_dunkscoreleaders(season = year_to_season(most_recent_nba_season() - 2))
nba_gravityleaders(season = year_to_season(most_recent_nba_season() - 2))
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)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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_assist_pct(ast = 8, fgm = 10, minutes = 36, team_fgm = 40, team_minutes = 240)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)nba_assist_to_turnover(ast, tov)
Arguments
ast, tov
|
Numeric vectors: assists, turnovers. |
Value
A numeric vector (NA when turnovers are 0).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_assist_to_turnover(ast = 8, tov = 3)nba_assist_to_turnover(ast = 8, tov = 3)
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")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 |
tag_column |
Name of the origin column |
join_key |
Single shared column name |
keep_cols |
Grouping key column(s) |
nest_col |
Name of the list-column |
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-columnsets <- 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
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, ... )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() - 2), 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() - 2), 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
See Also
Other NBA Boxscore Functions:
nba_boxscoretraditionalv3(),
nba_playbyplayv3()
Other NBA Player Tracking Functions:
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_teamdashboardbyclutch(),
nba_tracking_aggregate()
Other NBA Hustle Functions:
nba_leaguehustlestatsplayer()
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", ...)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
See Also
Other NBA Boxscore Functions:
nba_boxscoretraditionalv2(),
nba_playbyplayv3()
Other NBA Lineup Functions:
nba_fantasywidget(),
nba_possession_lineups(),
nba_rapm(),
nba_shot_zones(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Get NBA Stats API All Players
Description
Get NBA Stats API All Players
Get NBA Stats API All Players
Get NBA Stats API Player Info
Get NBA Stats API Player Info
Get NBA Stats API Playoff Series
Get NBA Stats API Playoff Series
Get NBA Stats API Team Roster
Get NBA Stats API Team Roster
Get NBA Stats API Common Team Years
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() - 2), ... ) 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() - 2), team_id = "1610612739", ... ) nba_commonteamyears(league_id = "00", ...)nba_commonallplayers( is_only_current_season = 0, league_id = "00", season = year_to_season(most_recent_nba_season() - 2), ... ) 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() - 2), 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
nba_commonallplayers(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_commonplayerinfo(league_id = '00', player_id = '2544')
nba_commonplayoffseries(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_commonteamroster(season = year_to_season(most_recent_nba_season() - 2), 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 Stats
Get NBA Stats API Cumulative Player Game Stats
Get NBA Stats API Cumulative Player Game Stats
Get NBA Stats API Cumulative Team Stats
Get NBA Stats API Cumulative Team Stats
Get NBA Stats API Cumulative Team Game 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() - 2), 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() - 2), season_type = "Regular Season", team_id = "1610612739", ... ) nba_cumestatsteamgames( league_id = "00", location = "", outcome = "", season = year_to_season(most_recent_nba_season() - 2), season_id = "", season_type = "Regular Season", team_id = 1610612739, vs_conference = "", vs_division = "", vs_team_id = "", ... )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() - 2), 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() - 2), season_type = "Regular Season", team_id = "1610612739", ... ) nba_cumestatsteamgames( league_id = "00", location = "", outcome = "", season = year_to_season(most_recent_nba_season() - 2), 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
nba_cumestatsplayer()
nba_cumestatsplayergames(player_id = '2544')
nba_cumestatsteam(game_ids = '0022201094', season = '2022-23', team_id = '1610612739')
nba_cumestatsteamgames(team_id = 1610612739, season = year_to_season(most_recent_nba_season() - 2))
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
Get NBA Data API Play-by-Play
Usage
nba_data_pbp(game_id = "0021900001", ...)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
data.nba.com serves this play-by-play for the 2016-17 through 2024-25 seasons (probed 2026-09-29). Earlier games are missing, and later ones come back without plays, which returns an empty result with a message.
nba_data_pbp(game_id = "0021900001")
Value
Returns a tibble
| col_name | types | description |
| game_id | character | Unique game identifier. |
| league | character | League. |
| period | integer | Period of the game (1-4 quarters; 5+ for OT). |
| event_num | integer | Sequential event number within the game (V2 PBP). |
| clock | character | Game clock value. |
| description | character | Long-form description text. |
| locX | integer | |
| locY | integer | |
| opt1 | integer | Opt1. |
| opt2 | integer | Opt2. |
| event_action_type | integer | Numeric event-action-type code (V2 PBP). |
| event_type | integer | Event / play type code (V2 PBP). |
| team_id | integer | Unique team identifier. |
| offense_team_id | integer | Unique identifier for offense team. |
| player1_id | integer | V2 PBP primary player ID (e.g. shooter / fouler). |
| player2_id | integer | V2 PBP secondary player ID (e.g. assister / fouled-by). |
| player3_id | integer | V2 PBP tertiary player ID (e.g. blocker). |
| home_score | integer | Home team score at the time of the play. |
| away_score | integer | Away team score at the time of the play. |
| order | integer | Display order within the result set. |
Event Message Types (event_type):
1 -> MAKE
2 -> MISS
3 -> FreeThrow
4 -> Rebound
5 -> Turnover
6 -> Foul
7 -> Violation
8 -> Substitution
9 -> Timeout
10 -> JumpBall
11 -> Ejection
12 -> StartOfPeriod
13 -> EndOfPeriod
14 -> Empty
Author(s)
Saiem Gilani
See Also
Other NBA PBP Functions:
nba_playbyplayv3(),
nba_schedule()
Defensive Rating (points allowed per 100 possessions)
Description
Defensive Rating (points allowed per 100 possessions)
Usage
nba_defensive_rating(opp_pts, poss)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.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_defensive_rating(opp_pts = 108, poss = 100)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 Board
Get NBA Stats API Draft Combine Stats
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 = "", ... )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)
nba_draftcombinedrillresults(season_year = most_recent_nba_season() - 1)
Draft Combine Non-stationary Shooting
nba_draftcombinenonstationaryshooting(season_year = most_recent_nba_season() - 1)
nba_draftcombineplayeranthro(season_year = most_recent_nba_season() - 1)
nba_draftcombinespotshooting(season_year = most_recent_nba_season() - 1)
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)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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_effective_fg_pct(fgm = 10, fg3m = 4, fga = 20)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 Fantasy Widget
Get NBA Stats API League Dashboard Lineups
Get NBA Stats API League Dashboard Lineups
Get NBA Stats API League Lineup Visual Data
Get NBA Stats API League Lineup Visual Data
Get NBA Stats API League Player On/Off Details
Get NBA Stats API League Player On/Off Details
Get NBA Stats API League Season Matchups
Get NBA Stats API League Season Matchups
Get NBA Stats API Matchups Rollup
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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_type = "Regular Season", ... )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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2))
nba_leaguedashlineups(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguelineupviz(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leagueplayerondetails(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
nba_leagueseasonmatchups(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_matchupsrollup(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA Fantasy Functions:
nba_playerindex()
Other NBA League Functions:
nba_leaguedashoppptshot(),
nba_leaguegamelog(),
nba_shotchartdetail()
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_possession_lineups(),
nba_rapm(),
nba_shot_zones(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Other NBA Player Functions:
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_playerindex()
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)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.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_four_factors(fgm = 40, fg3m = 12, fga = 88, fta = 25, ftm = 20, oreb = 10, tov = 13, opp_dreb = 33)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
Get NBA Stats API Franchise Leaders with Rank
Get NBA Stats API Franchise Leaders with Rank
Get NBA Stats API Franchise Players
Get NBA Stats API Franchise Players
Get NBA Stats API Franchise History
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", ...)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
nba_franchiseleaders(league_id = '00', team_id = '1610612739')
nba_franchiseleaderswrank(league_id = '00', team_id = '1610612739') nba_franchiseleaderswrank(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')
nba_franchiseplayers(league_id = '00', team_id = '1610612739') nba_franchiseplayers(league_id = '00', season_type = 'Playoffs', team_id = '1610612739')
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)nba_ft_rate(fta, fga)
Arguments
fta, fga
|
Numeric vectors: free-throw attempts, field-goal attempts. |
Value
A numeric vector.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_ft_rate(fta = 8, fga = 20)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)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.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
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)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)
Fetch an NBA Last Two Minute (L2M) report
Description
Retrieves and parses the Last Two Minute officiating report for a single NBA game from official.nba.com. A report is published for any game that is within 3 points (5 points before 2017-18) at any point in the last two minutes of the 4th quarter or overtime – not only playoff games. JSON reports exist only from 2019-01-01 onward. Port of the scraping logic in atlhawksfanatic/L2M (MIT, (c) 2019 atlhawksfanatic).
Usage
nba_l2m(game_id, proxy = NULL)nba_l2m(game_id, proxy = NULL)
Arguments
game_id |
character or numeric. A single all-digit NBA game id of at
most 10 digits; zero-padded to 10 digits automatically (e.g. |
proxy |
Optional proxy: a URL string (e.g. |
Value
Named list of hoopR_data tibbles:
calls – one row per graded play. decision is normalized to
CC/CNC/IC/INC (NCC->CNC, NCI->INC, trailing *
stripped; a real INC stays INC, while a blank or "Undetectable"
grade becomes NA and is never counted as INC). game_id is a
10-char zero-padded string. Player and team names are kept verbatim
(no ASCII folding).
| col_name | types | description |
| game_id | character | 10-digit zero-padded game id; joins to game and stats. |
| period | integer | Period number from period_name (4 = fourth quarter, 5+ = overtime). |
| period_name | character | Raw period label, e.g. Q4, or Q5 for the first overtime. |
| pc_time | character | Raw game clock string, MM:SS or MM:SS.t. |
| seconds_remaining | double | Seconds left in the period, parsed from pc_time. |
| call_type | character | Raw "Call: Type" label, whitespace untouched. |
| call | character | Upper-cased part of call_type before the colon, e.g. FOUL. |
| type | character | Upper-cased part of call_type after the colon, e.g. SHOOTING. |
| committing | character | Player, team or coach committing the graded action. |
| disadvantaged | character | Player or team disadvantaged by the graded action. |
| decision | character | Normalized grade: CC, CNC, IC or INC. |
| decision_raw | character | Raw grading code before normalization. |
| comment | character | Grader's free-text explanation of the ruling. |
| difficulty | character | Grader's difficulty rating, e.g. Observable or Difficult. |
| video_event_id | character | Report video event id (source field VideolLink); not a play-by-play event number. |
| pos_id | integer | Report possession id; rows sharing it belong to one possession. |
| pos_start | character | Game clock at the start of the possession. |
| pos_end | character | Game clock at the end of the possession. |
| pos_team_id | integer | NBA team id of the team in possession. |
game – one row of game metadata.
| col_name | types | description |
| game_id | character | 10-digit zero-padded game id; joins to calls and stats. |
| game_date | Date | Game date from the report's local tip-off timestamp. |
| season_type | character | Season type from the third digit of game_id, e.g. playoffs. |
| home_team_id | integer | NBA team id of the home team. |
| away_team_id | integer | NBA team id of the away team. |
| home_team_abbr | character | Home team three-letter abbreviation. |
| away_team_abbr | character | Away team three-letter abbreviation. |
| home_team_name | character | Home team nickname as published in the report. |
| away_team_name | character | Away team nickname as published in the report. |
| home_score | integer | Home team final score. |
| away_score | integer | Away team final score. |
| l2m_comments | character | Report-level note from the league; NA for almost every game. |
stats – 3 rows of error-count stats (Calls, Errors in Favor,
Possessions in Favor).
| col_name | types | description |
| game_id | character | 10-digit zero-padded game id; joins to calls and game. |
| stat_name | character | Statistic: Calls, Errors in Favor or Possessions in Favor. |
| home | integer | Value of stat_name for the home team. |
| away | integer | Value of stat_name for the away team. |
Errors
Raises a classed condition instead of returning on failure. Both classes
inherit from hoopR_error, so one handler can catch either:
-
hoopR_no_data– the game has no L2M report (common for regular-season games, games that did not reach the final two minutes, or very recent games): official.nba.com answers 403 with an S3AccessDeniedbody, or 404s the request. -
hoopR_fetch_error– the fetch failed (network error, rate limit, Akamai WAF block, any other HTTP status), or a 200 response is not a report: not valid JSON, JSON that is not an object, a payload without a one-rowgametable (an empty object or an error envelope, say), agame,l2morstatstable of the wrong shape, or a field the parser cannot read.
An invalid argument is an ordinary error, raised before any request.
Author(s)
Saiem Gilani
See Also
Other NBA Officiating Functions:
nba_l2m_games(),
nba_referee_assignments()
Examples
try({ l2m <- nba_l2m(game_id = "0042500405") head(l2m$calls) })try({ l2m <- nba_l2m(game_id = "0042500405") head(l2m$calls) })
Fetch the list of NBA games with a Last Two Minute report for a season
Description
Scrapes official.nba.com's season index page. JSON L2M reports exist only from 2019-01-01 onward; earlier seasons' index pages list PDFs, which this function ignores (use a release loader for that history once published). Port of the scraping logic in atlhawksfanatic/L2M (MIT, (c) 2019 atlhawksfanatic).
Usage
nba_l2m_games(season, proxy = NULL)nba_l2m_games(season, proxy = NULL)
Arguments
season |
integer, or a numeric-like string. NBA season, END year
(e.g. |
proxy |
Optional proxy: a URL string (e.g. |
Value
A hoopR_data tibble, one row per unique game id in page order:
| col_name | types | description |
| game_id | character | 10-digit zero-padded game id from the report link. |
| season | integer | Season end year passed in, stamped on every row. |
| season_type | character | Season type from the third digit of game_id, e.g. playoffs. |
| label | character | Matchup label text of the report link, edges trimmed. |
Errors
Raises a classed condition instead of returning on failure. Both classes
inherit from hoopR_error, so one handler can catch either:
-
hoopR_no_data– official.nba.com 404s the season's page (a season without one), or answers 403 with an S3AccessDeniedbody. -
hoopR_fetch_error– the fetch failed (network error, rate limit, Akamai WAF block, any other HTTP status), or a 200 response is missing the expected "Last Two Minute" page marker (an Akamai interstitial, a blank body, or a redesigned page) – checked here, not in.parse_nba_l2m_games(), so the parser itself never raises.
An invalid argument is an ordinary error, raised before any request.
Author(s)
Saiem Gilani
See Also
Other NBA Officiating Functions:
nba_l2m(),
nba_referee_assignments()
Examples
try({ games <- nba_l2m_games(season = 2026) head(games) })try({ games <- nba_l2m_games(season = 2026) head(games) })
Get NBA Stats API League Dashboard Player Tracking - Opponent Shots
Description
Get NBA Stats API League Dashboard Player Tracking - Opponent Shots
Get NBA Stats API League Dashboard Player Tracking - Opponent Shots
Get NBA Stats API League Dashboard Player Biographical Stats
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 by Player Clutch Splits
Get NBA Stats API League Dashboard Player Tracking - Player Shots
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 Stats
Get NBA Stats API League Dashboard Player Shot Locations
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 - Defense
Get NBA Stats API League Dashboard Player Tracking - Stats
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 Player Tracking - Team Defense
Get NBA Stats API League Dashboard by Team Clutch Splits
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 Player Tracking - Team Shots
Get NBA Stats API League Dashboard Team Stats
Get NBA Stats API League Dashboard Team Stats
Get NBA Stats API League Dashboard Team Shot Locations
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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_segment = "", season_type = "Regular Season", shot_clock_range = "", starter_bench = "", team_id = "", vs_conference = "", vs_division = "", ... )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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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
nba_leaguedashoppptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashplayerbiostats(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashplayerclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashplayerptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashplayerstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
Players Shooting by Shot Location
nba_leaguedashplayershotlocations(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashptdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
Players Tracking (Second Spectrum) Stats
nba_leaguedashptstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashptteamdefend(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashteamclutch(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashteamptshot(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguedashteamstats(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
Team Shooting by Shot Location
nba_leaguedashteamshotlocations(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA League Functions:
nba_fantasywidget(),
nba_leaguegamelog(),
nba_shotchartdetail()
Other NBA Player Tracking Functions:
nba_boxscoretraditionalv2(),
nba_playerdashboardbyclutch(),
nba_teamdashboardbyclutch(),
nba_tracking_aggregate()
Other NBA Player Functions:
nba_fantasywidget(),
nba_playerdashboardbyclutch(),
nba_playerindex()
Other NBA Shooting Functions:
nba_playerdashboardbyclutch(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Other NBA Clutch Functions:
nba_playerdashboardbyclutch(),
nba_teamdashboardbyclutch()
Other NBA Team Functions:
nba_teamdashboardbyclutch(),
nba_teams()
Get NBA Stats API League Game Log
Description
Get NBA Stats API League Game Log
Get NBA Stats API League Game Log
Get NBA Stats API League Standings
Get NBA Stats API League Standings
Get NBA Stats API League Standings V3
Get NBA Stats API League Standings V3
Get NBA Stats API Playoff Picture
Get NBA Stats API Playoff Picture
Get NBA Stats API League Game Streak Finder
Get NBA Stats API League Game Streak Finder
Get NBA Stats API In-Season Tournament Standings
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() - 2), season_type = "Regular Season", sorter = "DATE", ... ) nba_leaguestandings( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", season_year = "", ... ) nba_leaguestandingsv3( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), section = "group", ... )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() - 2), season_type = "Regular Season", sorter = "DATE", ... ) nba_leaguestandings( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", season_year = "", ... ) nba_leaguestandingsv3( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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
nba_leaguegamelog(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguestandings(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_leaguestandingsv3(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_playoffpicture(league_id = '00', season_id = paste0(2, most_recent_nba_season() - 2))
nba_leaguegamefinder(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_iststandings(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA League Functions:
nba_fantasywidget(),
nba_leaguedashoppptshot(),
nba_shotchartdetail()
Other NBA Game Finder Functions:
nba_playerindex(),
nba_teams()
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
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() - 2), 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() - 2), 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() - 2), 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() - 2), season_segment = "", season_type = "Regular Season", team_id = "", vs_conference = "", vs_division = "", weight = "", ... )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() - 2), 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() - 2), 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() - 2), 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() - 2), 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
nba_leaguehustlestatsplayer(league_id = '00') nba_leaguehustlestatsplayer(league_id = '00', team_id = '1610612761')
nba_leaguehustlestatsplayerleaders(league_id = '00')
nba_leaguehustlestatsteam(league_id = '00')
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
See Also
Other NBA Hustle Functions:
nba_boxscoretraditionalv2()
Net Rating
Description
Net Rating
Usage
nba_net_rating(off_rating, def_rating)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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_net_rating(off_rating = 115, def_rating = 108)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)nba_offensive_rating(pts, poss)
Arguments
pts, poss
|
Numeric vectors: points scored, possessions. |
Value
A numeric vector of points per 100 possessions.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_offensive_rating(pts = 115, poss = 100)nba_offensive_rating(pts = 115, poss = 100)
Offensive Rebound Percentage
Description
Offensive Rebound Percentage
Usage
nba_oreb_pct(oreb, opp_dreb)nba_oreb_pct(oreb, opp_dreb)
Arguments
oreb, opp_dreb
|
Numeric vectors: offensive rebounds, opponent defensive rebounds. |
Value
A numeric vector (0-100 scale).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_oreb_pct(oreb = 10, opp_dreb = 33)nba_oreb_pct(oreb = 10, opp_dreb = 33)
Pace (possessions per 48 minutes)
Description
Pace (possessions per 48 minutes)
Usage
nba_pace(poss, minutes)nba_pace(poss, minutes)
Arguments
poss |
Numeric vector of possessions (e.g. from |
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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_pace(poss = 100, minutes = 240)nba_pace(poss = 100, minutes = 240)
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)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. |
minutes |
Name of the minutes column. Defaults to |
per |
Minutes to scale to. Defaults to |
Value
df with the added per-minute columns.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
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"))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)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 |
per |
Possessions to scale to. Defaults to |
Value
df with the added per-possession columns.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
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"))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 V3
Get NBA Stats API play-by-play
Get NBA Stats API play-by-play
Get NBA Stats API play-by-play (Multiple Games)
Get NBA Stats API play-by-play (Multiple Games)
Get NBA Stats API Live play-by-play
Get NBA Stats API Live play-by-play
Get NBA Stats API Live Boxscore
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, ...)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 |
version |
Play-by-play version - |
p |
Optional progress object from |
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
See Also
Other NBA PBP Functions:
nba_data_pbp(),
nba_schedule()
Other NBA Live Functions:
nba_schedule()
Other NBA Boxscore Functions:
nba_boxscoretraditionalv2(),
nba_boxscoretraditionalv3()
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)nba_player_crosswalk(season = most_recent_nba_season(), min_confidence = 0.92)
Arguments
season |
NBA season per hoopR convention (default |
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).
See Also
Other NBA Crosswalk Functions:
load_nba_team_crosswalk(),
nba_schedule_crosswalk(),
nba_team_crosswalk()
Examples
try(nba_player_crosswalk())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() - 2), ...)nba_player_dict(season = year_to_season(most_recent_nba_season() - 2), ...)
Arguments
season |
Season in |
... |
Additional arguments passed to |
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).
|
See Also
Other NBA Dictionary Functions:
nba_player_headshot_url(),
nba_team_dict(),
nba_team_logo_url()
Examples
try(nba_player_dict())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")nba_player_headshot_url(player_id, size = "1040x760")
Arguments
player_id |
Player id(s) ( |
size |
Image size: |
Value
A character vector of headshot URLs.
See Also
Other NBA Dictionary Functions:
nba_player_dict(),
nba_team_dict(),
nba_team_logo_url()
Examples
nba_player_headshot_url(player_id = 201939) # Stephen Curry nba_player_headshot_url(c(2544, 201939), size = "260x190")nba_player_headshot_url(player_id = 201939) # Stephen Curry nba_player_headshot_url(c(2544, 201939), size = "260x190")
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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_type = "Regular Season", type_grouping = "Offensive", ... )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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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
nba_playerdashboardbyclutch(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Game Splits
nba_playerdashboardbygamesplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by General Splits
nba_playerdashboardbygeneralsplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Last N Games
nba_playerdashboardbylastngames(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Opponent
nba_playerdashboardbyopponent(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Shooting Splits
nba_playerdashboardbyshootingsplits(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Team Performance
nba_playerdashboardbyteamperformance(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Stats Dashboard by Team Performance
nba_playerdashboardbyyearoveryear(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Tracking (Second Spectrum) Stats - Passing
nba_playerdashptpass(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Tracking (Second Spectrum) Stats - Rebounding
nba_playerdashptreb(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Tracking (Second Spectrum) Stats - Defending
nba_playerdashptshotdefend(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
Player Tracking (Second Spectrum) Stats - Shooting
nba_playerdashptshots(player_id = '2544', season = year_to_season(most_recent_nba_season() - 2))
nba_synergyplaytypes(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA Player Functions:
nba_fantasywidget(),
nba_leaguedashoppptshot(),
nba_playerindex()
Other NBA Clutch Functions:
nba_leaguedashoppptshot(),
nba_teamdashboardbyclutch()
Other NBA Shooting Functions:
nba_leaguedashoppptshot(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Other NBA Player Tracking Functions:
nba_boxscoretraditionalv2(),
nba_leaguedashoppptshot(),
nba_teamdashboardbyclutch(),
nba_tracking_aggregate()
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() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_playercareerbycollegerollup( league_id = "00", per_mode = "Totals", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_playerfantasyprofilebargraph( league_id = "00", player_id = "2544", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... ) nba_playerestimatedmetrics( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... ) nba_playergamelog( date_from = "", date_to = "", league_id = "00", player_id = "2544", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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", ... )nba_playerindex( college = "", country = "", draft_pick = "", draft_round = "", draft_year = "", height = "", historical = 1, league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_playercareerbycollegerollup( league_id = "00", per_mode = "Totals", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), season_type = "Regular Season", ... ) nba_playerfantasyprofilebargraph( league_id = "00", player_id = "2544", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... ) nba_playerestimatedmetrics( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... ) nba_playergamelog( date_from = "", date_to = "", league_id = "00", player_id = "2544", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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
nba_playerindex()
nba_playerheadshot(player_id = '2544')
nba_playerawards(player_id = '2544')
nba_playercareerbycollege(college = 'Florida State', per_mode = 'PerGame')
nba_playercareerbycollegerollup(per_mode = 'Totals')
nba_playercareerstats(player_id = '2544')
nba_infographicfanduelplayer(game_id = "0022201086")
nba_playerfantasyprofile(player_id = '2544')
nba_playerfantasyprofilebargraph(player_id = '2544')
nba_playerestimatedmetrics()
nba_playergamelog(player_id = '2544')
nba_playergamelogs(player_id = '2544')
nba_playergamestreakfinder()
nba_playernextngames(player_id = '2544')
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
See Also
Other NBA Player Functions:
nba_fantasywidget(),
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch()
Other NBA Fantasy Functions:
nba_fantasywidget()
Other NBA Game Finder Functions:
nba_leaguegamelog(),
nba_teams()
Get NBA Possession-Level Stint Matrix
Description
Get NBA Possession-Level Stint Matrix
Get NBA Possession-Level Stint Matrix
Usage
nba_possession_lineups(game_id, ...)nba_possession_lineups(game_id, ...)
Arguments
game_id |
NBA Stats game id. 10-character zero-padded string
(e.g., |
... |
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
See Also
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_fantasywidget(),
nba_rapm(),
nba_shot_zones(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
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)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.
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_possessions(fga = 88, fta = 25, oreb = 10, tov = 13)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
Fit a Ridge-Regression RAPM Model from Possession Data
Usage
nba_rapm(possessions, ...)nba_rapm(possessions, ...)
Arguments
possessions |
A possession-level stint matrix as produced by
|
... |
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
See Also
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_fantasywidget(),
nba_possession_lineups(),
nba_shot_zones(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Fetch NBA/G-League/WNBA referee crew assignments for a date
Description
Retrieves referee crew assignments and replay-center officials for every
game on a date, from official.nba.com's get-game-officials endpoint
(covers NBA, G-League, and WNBA in one payload). Port of the scraping
logic in atlhawksfanatic/L2M
(MIT, (c) 2019 atlhawksfanatic).
Usage
nba_referee_assignments(date, league = "nba", proxy = NULL)nba_referee_assignments(date, league = "nba", proxy = NULL)
Arguments
date |
character or Date/POSIXct, length 1. Date to fetch. A
Date/POSIXct is formatted directly (never routed through |
league |
character(1). One of |
proxy |
Optional proxy: a URL string (e.g. |
Details
crew_position is the feed's slot order (1-4); slot 1 is inferred to be
the crew chief from that ordering – the API does not label roles
directly. season converts the feed's <type digit><START year> code to
an END year: START+1 for "nba"/"gl" (two-calendar-year seasons), START
unchanged for "wnba" (single-year seasons).
Value
Named list of hoopR_data tibbles:
officials – one row per game x filled crew slot. A slot whose
official's name is absent, null or empty is skipped. A field sent as
null, an array or an object reads as NA, never as a dropped or
duplicated row: an array or object name keeps its row, and the
official's id, with an NA official_name.
| col_name | types | description |
| league | character | League: nba, gl (G League) or wnba. |
| game_id | character | 10-digit zero-padded game id. |
| game_date | Date | Game date, parsed from the feed's MM/DD/YYYY. |
| season | integer | Season end year (start year + 1 for nba/gl, unchanged for wnba). |
| season_type | character | Season type from the first digit of the feed's season code. |
| game_code | character | League game code, YYYYMMDD/AWYHOM. |
| home_team_id | integer | Team id of the home team. |
| home_team_abbr | character | Home team three-letter abbreviation. |
| away_team_id | integer | Team id of the away team. |
| away_team_abbr | character | Away team three-letter abbreviation. |
| crew_position | integer | Feed slot order (1-4); slot 1 is the inferred crew chief. |
| official_id | integer | Official's person id from the feed. |
| official_name | character | Official's display name. |
| jersey_num | character | Official's jersey number, as a string. |
replay_center – the replay-center officials on duty that date, one
row per official. The rows are per date, not tied to a game or a league:
the feed can repeat the same rows in every league block (league only
records which block was read), and they can be present when the league
has no games.
| col_name | types | description |
| league | character | League block the row was read from (nba, gl or wnba); not league-specific. |
| game_date | Date | Date the replay-center official worked (not tied to one game). |
| official_id | integer | Replay-center official's person id from the feed. |
| official_name | character | Replay-center official's display name. |
A date with no games for the league is not an error: officials comes
back zero-row rather than raising, while replay_center can still hold
that date's replay-center officials.
Errors
Raises a classed condition instead of returning on failure. Both classes
inherit from hoopR_error, so one handler can catch either:
-
hoopR_no_data– official.nba.com 404s the endpoint, or answers 403 with an S3AccessDeniedbody. -
hoopR_fetch_error– the fetch failed (network error, rate limit, Akamai WAF block, any other HTTP status), or a 200 response is not valid JSON, is JSON that is not an object, or has the league'sTable/Table1rowsmissing or malformed (aTablerow without a 10-digitgame_id, or aTable1row without areplaycenter_officialname, included). The feed carries every league's block on every date, with zero rows on a day without games, so a missing block is never an empty day.
An invalid argument, including an impossible date such as "2026-02-31",
is an ordinary error, raised before any request.
Author(s)
Saiem Gilani
See Also
Other NBA Officiating Functions:
nba_l2m(),
nba_l2m_games()
Examples
try({ refs <- nba_referee_assignments(date = "2026-06-13") head(refs$officials) })try({ refs <- nba_referee_assignments(date = "2026-06-13") head(refs$officials) })
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), ... )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() reads the current season's schedule for each league from
its own CDN host: '00' (NBA) from cdn.nba.com, '10' (WNBA) from
cdn.wnba.com and '20' (G League) from cdn-gleague.nba.com. Any other
league_id is an error. season_type_description labels the id's third
digit; '5' is "Play-In Game" only for the NBA and NA for the other
leagues, which use it for other events. The WNBA's season is a single
year (e.g. "2026"). The CDN serves the current season alone, so a season
you pass that differs from it prints a message; the default is not compared.
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 of the schedule: 'YYYY-YY' for the NBA and G League, a 4-digit year for the WNBA. |
| league_id | character | League identifier ('00' = NBA, '10' = WNBA, '20' = G League). |
| season_type_id | character | Third digit of game_id (1 pre-season, 2 regular season, 3 all-star, 4 playoffs, 5 see details). |
| season_type_description | character | Label for season_type_id; NA where the digit has no label (see details). |
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
See Also
Other NBA Live Functions:
nba_playbyplayv3()
Other NBA PBP Functions:
nba_data_pbp(),
nba_playbyplayv3()
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())nba_schedule_crosswalk(season = most_recent_nba_season())
Arguments
season |
NBA season per hoopR convention (default |
Value
A hoopR_data tibble, one row per game.
See Also
Other NBA Crosswalk Functions:
load_nba_team_crosswalk(),
nba_player_crosswalk(),
nba_team_crosswalk()
Examples
try(nba_schedule_crosswalk())try(nba_schedule_crosswalk())
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
Fetch NBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone
Usage
nba_shot_zones(game_id, ...)nba_shot_zones(game_id, ...)
Arguments
game_id |
A length-1 character string — the ten-character NBA Stats
game identifier (e.g. |
... |
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 withabs(x_legacy) >= 220andy_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
See Also
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_fantasywidget(),
nba_possession_lineups(),
nba_rapm(),
nba_shotchartdetail(),
nba_teamdashboardbyclutch()
Examples
try({ df <- nba_shot_zones(game_id = "0022200001") print(df[!is.na(df$shot_zone), c("shot_distance", "shot_zone")]) })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 Detail
Get NBA Stats API Shot Chart League-Wide
Get NBA Stats API Shot Chart League-Wide
Get NBA Stats API Shot Chart for Lineups
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() - 2), 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() - 2), ... ) 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() - 2), 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 = "", ... )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() - 2), 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() - 2), ... ) 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() - 2), 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() - 2))
nba_shotchartleaguewide(league_id = '00', season = year_to_season(most_recent_nba_season() - 2))
nba_shotchartlineupdetail(group_id = '-202689-203493-203501-1626174-1627827-',
group_id2 = '-202689-203493-203501-1626174-1627827-',
season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA Shooting Functions:
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_teamdashboardbyclutch()
Other NBA League Functions:
nba_fantasywidget(),
nba_leaguedashoppptshot(),
nba_leaguegamelog()
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_fantasywidget(),
nba_possession_lineups(),
nba_rapm(),
nba_shot_zones(),
nba_teamdashboardbyclutch()
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())nba_team_crosswalk(season = most_recent_nba_season())
Arguments
season |
NBA season per hoopR convention (default |
Value
A hoopR_data tibble, one row per team (ESPN / nba_* / Fox / Yahoo
column groups + match_method / match_confidence).
See Also
Other NBA Crosswalk Functions:
load_nba_team_crosswalk(),
nba_player_crosswalk(),
nba_schedule_crosswalk()
Examples
try(nba_team_crosswalk())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() - 2), ...)nba_team_dict(season = year_to_season(most_recent_nba_season() - 2), ...)
Arguments
season |
Season in |
... |
Additional arguments passed to |
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. |
See Also
Other NBA Dictionary Functions:
nba_player_dict(),
nba_player_headshot_url(),
nba_team_logo_url()
Examples
try(nba_team_dict())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")nba_team_logo_url(team_id, variant = "primary")
Arguments
team_id |
Team id(s) ( |
variant |
Logo variant: |
Value
A character vector of SVG logo URLs.
See Also
Other NBA Dictionary Functions:
nba_player_dict(),
nba_player_headshot_url(),
nba_team_dict()
Examples
nba_team_logo_url(team_id = 1610612744) # Golden State Warriorsnba_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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), season_segment = "", season_type = "Regular Season", team_id = "1610612749", vs_conference = "", vs_division = "", ... )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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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
nba_teamdashboardbyclutch(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
nba_teamdashboardbygamesplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Dashboard by General Splits
nba_teamdashboardbygeneralsplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Dashboard by Last N Games
nba_teamdashboardbylastngames(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
nba_teamdashboardbyopponent(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Dashboard by Shooting Splits
nba_teamdashboardbyshootingsplits(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Dashboard by Team Performance
nba_teamdashboardbyteamperformance(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Dashboard by Year over Year
nba_teamdashboardbyyearoveryear(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
nba_teamdashlineups(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Player Tracking (Second Spectrum) Stats - Passing
nba_teamdashptpass(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Player Tracking (Second Spectrum) Stats - Rebounds
nba_teamdashptreb(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
Team Player Tracking (Second Spectrum) Stats - Shooting
nba_teamdashptshots(team_id = '1610612749', season = year_to_season(most_recent_nba_season() - 2))
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
See Also
Other NBA Team Functions:
nba_leaguedashoppptshot(),
nba_teams()
Other NBA Clutch Functions:
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch()
Other NBA Shooting Functions:
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_shotchartdetail()
Other NBA Lineup Functions:
nba_boxscoretraditionalv3(),
nba_fantasywidget(),
nba_possession_lineups(),
nba_rapm(),
nba_shot_zones(),
nba_shotchartdetail()
Other NBA Player Tracking Functions:
nba_boxscoretraditionalv2(),
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_tracking_aggregate()
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() - 2), season_type = "Regular Season", ... ) nba_teamgamelog( date_from = "", date_to = "", league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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 = "", ... )nba_teams(...) nba_teamdetails(team_id = "1610612749", ...) nba_teamestimatedmetrics( league_id = "00", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", ... ) nba_teamgamelog( date_from = "", date_to = "", league_id = "00", season = year_to_season(most_recent_nba_season() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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() - 2), 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')
nba_teamestimatedmetrics()
nba_teamgamelog(team_id = '1610612749')
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')
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
See Also
Other NBA Team Functions:
nba_leaguedashoppptshot(),
nba_teamdashboardbyclutch()
Other NBA Game Finder Functions:
nba_leaguegamelog(),
nba_playerindex()
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, ...)nba_tidy_boxscore(game_id, ...)
Arguments
game_id |
Game ID (10-digit, zero-padded e.g. |
... |
Additional arguments passed to |
Value
A hoopR_data tibble, one row per player, with the player's stats and
their team's totals (team columns suffixed _team).
See Also
Other NBA Combined Datasets:
nba_tidy_franchise_history(),
nba_tidy_player_profile()
Examples
try(nba_tidy_boxscore(game_id = "0022300061"))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(...)nba_tidy_franchise_history(...)
Arguments
... |
Additional arguments passed to |
Value
A hoopR_data tibble, one row per franchise era, with a leading
franchise_status column (active / defunct).
See Also
Other NBA Combined Datasets:
nba_tidy_boxscore(),
nba_tidy_player_profile()
Examples
try(nba_tidy_franchise_history())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, ...)nba_tidy_player_profile(player_id, ...)
Arguments
player_id |
Player ID (e.g. |
... |
Additional arguments passed to |
Value
A hoopR_data tibble with set_name, PLAYER_ID and a .data
list-column.
See Also
Other NBA Combined Datasets:
nba_tidy_boxscore(),
nba_tidy_franchise_history()
Examples
prof <- try(nba_tidy_player_profile(player_id = 201939))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 asTEAM_CITY) are carried viafirst()— never summed. -
*_FG_PCT/*_FT_PCTare recomputed from the summed FGM/FGA and FTM/FTA denominators (denom 0 ->NA); a*_FG_PCT/*_FT_PCTcolumn whose makes/attempts pair is absent is dropped rather than recomputed. -
Other
*_PCTcolumns (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-pydtype.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", ... )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.
|
season_types |
Character vector of season type(s), e.g.
|
per_mode |
Per-mode string passed to |
pt_measure_type |
Tracking measure type string, e.g. |
player_or_team |
|
league_id |
League identifier string. Default |
... |
Additional arguments forwarded to |
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
See Also
Other NBA Player Tracking Functions:
nba_boxscoretraditionalv2(),
nba_leaguedashoppptshot(),
nba_playerdashboardbyclutch(),
nba_teamdashboardbyclutch()
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")]) })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)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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_turnover_pct(),
nba_usage_rate()
Examples
nba_true_shooting_pct(pts = 30, fga = 20, fta = 8)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)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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_usage_rate()
Examples
nba_turnover_pct(tov = 13, fga = 88, fta = 25)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 )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).
See Also
Other Basketball Analytics Utilities:
espn_basketball_player_core(),
nba_add_advanced_metrics(),
nba_assist_pct(),
nba_assist_to_turnover(),
nba_defensive_rating(),
nba_effective_fg_pct(),
nba_four_factors(),
nba_ft_rate(),
nba_game_score(),
nba_net_rating(),
nba_offensive_rating(),
nba_oreb_pct(),
nba_pace(),
nba_per_minutes(),
nba_per_possessions(),
nba_possessions(),
nba_true_shooting_pct(),
nba_turnover_pct()
Examples
nba_usage_rate(fga = 20, fta = 8, tov = 3, minutes = 36, team_fga = 88, team_fta = 25, team_tov = 13, team_minutes = 240)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() - 2), 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() - 2), 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, ...)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() - 2), 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() - 2), 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')
Requires a real scoring-play game_event_id – the default 0 is a
placeholder with no clip attached and returns zero rows.
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)nbadraft_mock_draft(year = NULL)
Arguments
year |
(integer optional): Draft year (e.g. |
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. |
See Also
Other Salary & Draft Functions:
hoopshype_salaries(),
spotrac_team_cap()
Examples
try(nbadraft_mock_draft())try(nbadraft_mock_draft())
Get NBA G-League Stats API Live Boxscore
Description
Get NBA G-League Stats API Live Boxscore
Get NBA G-League Stats API Live Boxscore
Usage
nbagl_live_boxscore(game_id, ...)nbagl_live_boxscore(game_id, ...)
Arguments
game_id |
Game ID |
... |
Additional arguments passed to an underlying function like httr. |
Details
nbagl_live_boxscore(game_id = "2052500034")
Value
Returns a named list of data frames: game_details, arena, officials, home_team_boxscore, away_team_boxscore, home_team_player_boxscore, away_team_player_boxscore, home_team_linescores, away_team_linescores
game_details
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
See Also
Other NBA G-League Functions:
nbagl_live_pbp(),
nbagl_pbp(),
nbagl_players(),
nbagl_schedule(),
nbagl_standings()
Get NBA G-League Stats API Live play-by-play
Description
Get NBA G-League Stats API Live play-by-play
Get NBA G-League Stats API Live play-by-play
Usage
nbagl_live_pbp(game_id, ...)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
See Also
Other NBA G-League Functions:
nbagl_live_boxscore(),
nbagl_pbp(),
nbagl_players(),
nbagl_schedule(),
nbagl_standings()
Get NBA Data API Play-by-Play for G-League Games
Description
Retrieves G-League play-by-play using the NBA Stats play-by-play pipeline.
Usage
nbagl_pbp(game_id, on_court = TRUE, ...)nbagl_pbp(game_id, on_court = TRUE, ...)
Arguments
game_id |
Game ID - 10 digits, i.e. 0021900001 |
on_court |
If TRUE (default), on-court player IDs are added for each play event. |
... |
Additional arguments passed to an underlying function like httr. |
Details
nbagl_pbp(game_id = "2052500034")
Value
Returns a data frame of play-by-play with core columns:
When on_court = TRUE, lineup columns are included and may be NA when lineup
inference data is unavailable for a given game.
| col_name | types | description |
| game_id | character | Unique game identifier. |
| action_number | integer | Sequential action number within a game (V3 PBP). |
| clock | character | Game clock value. |
| period | integer | Period of the game (1-4 quarters; 5+ for OT). |
| team_id | integer | Unique team identifier. |
| person_id | integer | Unique player identifier (V3 endpoints). |
| player_name | character | Player name. |
| x_legacy | integer | V2-format X coordinate (preserved for V3-to-V2 compatibility). |
| y_legacy | integer | V2-format Y coordinate (preserved for V3-to-V2 compatibility). |
| shot_distance | numeric | Shot distance from the basket, in feet. |
| shot_result | character | Shot result ('Made' / 'Missed'). |
| is_field_goal | integer | 1 if the action was a field goal; 0 otherwise. |
| score_home | character | Score home. |
| score_away | character | Score away. |
| points_total | integer | Running total of points scored. |
| location | character | Location. |
| description | character | Long-form description text. |
| action_type | character | Action type label (e.g. 'Made Shot', 'Substitution'). |
| sub_type | character | Action sub-type label. |
| video_available | logical | Video available. |
| shot_value | integer | Point value of the shot (2 or 3). |
| action_id | integer | Unique action identifier within a game (V3 PBP). |
| away_player1 | numeric | Away team's player1. |
| away_player2 | numeric | Away team's player2. |
| away_player3 | numeric | Away team's player3. |
| away_player4 | numeric | Away team's player4. |
| away_player5 | numeric | Away team's player5. |
| home_player1 | numeric | Home team's player1. |
| home_player2 | numeric | Home team's player2. |
| home_player3 | numeric | Home team's player3. |
| home_player4 | numeric | Home team's player4. |
| home_player5 | numeric | Home team's player5. |
Author(s)
Billy Fryer
See Also
Other NBA G-League Functions:
nbagl_live_boxscore(),
nbagl_live_pbp(),
nbagl_players(),
nbagl_schedule(),
nbagl_standings()
Get G League Player Data Base from NBA API
Description
Retrieves G-League player index data via the NBA Stats API player index endpoint.
Usage
nbagl_players( college = "", country = "", draft_pick = "", draft_round = "", draft_year = "", height = "", historical = 1, league_id = "20", player_position = "", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", team_id = "0", weight = "", active = "", all_star = "", ... )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() - 2), season_type = "Regular Season", team_id = "0", weight = "", active = "", all_star = "", ... )
Arguments
college |
College filter. |
country |
Country filter. |
draft_pick |
Draft pick filter. |
draft_round |
Draft round filter. |
draft_year |
Draft year filter. |
height |
Height filter. |
historical |
Historical flag. |
league_id |
League - default: '20' (G-League). |
player_position |
Player position filter. |
season |
Season - format 2020-21. |
season_type |
Season Type - Regular Season, Playoffs, All-Star. |
team_id |
Team ID filter. |
weight |
Weight filter. |
active |
Active status filter. |
all_star |
All-Star filter. |
... |
Additional arguments passed to an underlying function like httr. |
Details
nbagl_players()
Value
Returns a named list of data frames: PlayerIndex
PlayerIndex
| col_name | types | description |
| PERSON_ID | character | Unique player identifier (V3 endpoints). |
| PLAYER_LAST_NAME | character | |
| PLAYER_FIRST_NAME | character | |
| PLAYER_SLUG | character | URL-safe player identifier. |
| TEAM_ID | character | Unique team identifier. |
| TEAM_SLUG | character | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
| TEAM_CITY | character | Team city or region (e.g. 'Las Vegas'). |
| TEAM_NAME | character | Full team display name (e.g. 'Las Vegas Aces'). |
| TEAM_ABBREVIATION | character | Short team abbreviation (e.g. 'LAS'). |
| JERSEY_NUMBER | character | |
| POSITION | character | Listed roster position (G, F, C, etc.). |
| HEIGHT | character | Player height (string e.g. '6-2' or inches). |
| WEIGHT | character | Player weight in pounds. |
| COLLEGE | character | College or school attended. |
| COUNTRY | character | Country (full name or code). |
| DRAFT_YEAR | character | Draft year (4-digit). |
| DRAFT_ROUND | character | Round of the draft selection. |
| DRAFT_NUMBER | character | |
| ROSTER_STATUS | character |
Author(s)
Billy Fryer
See Also
Other NBA G-League Functions:
nbagl_live_boxscore(),
nbagl_live_pbp(),
nbagl_pbp(),
nbagl_schedule(),
nbagl_standings()
Get G League Schedule from NBA API
Description
Retrieves G-League schedule data via the NBA Stats API schedule endpoint.
Usage
nbagl_schedule( league_id = "20", season = year_to_season(most_recent_nba_season() - 1), ... )nbagl_schedule( league_id = "20", season = year_to_season(most_recent_nba_season() - 1), ... )
Arguments
league_id |
League - default: '20' (G-League). |
season |
Season - format 2020-21. |
... |
Additional arguments passed to an underlying function like httr. |
Details
nbagl_schedule(season = most_recent_nba_season() - 1)
Value
Returns a data frame of the G League Season Schedule
| col_name | types | description |
| game_date | date | Game date (YYYY-MM-DD). |
| game_id | character | Unique game identifier. |
| game_code | character | ESPN game code (numeric identifier). |
| game_status | integer | Game status label. |
| game_status_text | character | Game status display text (e.g. 'Final', '4:32 - 4th'). |
| game_sequence | integer | Game sequence. |
| game_date_est | character | Game date est. |
| game_time_est | character | Game time est. |
| game_date_utc | character | Game date utc. |
| game_time_utc | character | Game start time in UTC (ISO 8601 timestamp). |
| arena_name | character | Arena name. |
| arena_state | character | Arena state. |
| arena_city | character | Arena city. |
| home_team_id | character | Unique identifier for the home team. |
| home_team_name | character | Home team name. |
| home_team_tricode | character | Home team three-letter code. |
| home_team_score | character | Home team's score. |
| away_team_id | character | Unique identifier for the away team. |
| away_team_name | character | Away team name. |
| away_team_tricode | character | Away team three-letter code. |
| away_team_score | character | Away team's score. |
| season | character | Season identifier (4-digit year or 'YYYY-YY' string). |
| league_id | character | League identifier ('10' = WNBA). |
| season_type_id | character | Unique identifier for season type. |
| season_type_description | character | Season type description. |
Author(s)
Billy Fryer
See Also
Other NBA G-League Functions:
nbagl_live_boxscore(),
nbagl_live_pbp(),
nbagl_pbp(),
nbagl_players(),
nbagl_standings()
Get Current G League Standings from NBA API
Description
Retrieves G-League standings via the NBA Stats API standings endpoint.
Usage
nbagl_standings( league_id = "20", season = year_to_season(most_recent_nba_season() - 2), season_type = "Regular Season", season_year = "", ... )nbagl_standings( league_id = "20", season = year_to_season(most_recent_nba_season() - 2), 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 = year_to_season(most_recent_nba_season() - 2))
Value
Returns a named list of data frames: Standings
Standings
| col_name | types | description |
| LeagueID | character | |
| SeasonID | character | |
| TeamID | character | Teamid. |
| TeamCity | character | Teamcity. |
| TeamName | character | Teamname. |
| TeamSlug | character | |
| Conference | character | Conference. |
| ConferenceRecord | character | |
| PlayoffRank | character | |
| Division | character | Team division. |
| WINS | character | Total wins. |
| LOSSES | character | Total losses. |
| WinPCT | character | |
| LeagueRank | character | |
| Record | character | Record string (e.g. '12-4'). |
| HOME | character | Home. |
| ROAD | character | Road. |
| CurrentStreak | character | |
| strCurrentStreak | character | |
| ConferenceGamesBack | character | |
| DivisionGamesBack | character | |
| LeagueGamesBack | character | |
| ClinchedPostSeason | character | |
| NEUTRAL | character |
Author(s)
Billy Fryer
See Also
Other NBA G-League Functions:
nbagl_live_boxscore(),
nbagl_live_pbp(),
nbagl_pbp(),
nbagl_players(),
nbagl_schedule()
Get men's college basketball NET rankings for the current date from the NCAA website
Description
Get men's college basketball NET rankings for the current date from the NCAA website
Usage
ncaa_mbb_NET_rankings()ncaa_mbb_NET_rankings()
Value
Returns a tibble
Author(s)
Saiem Gilani
Examples
# Get current NCAA NET rankings try(ncaa_mbb_NET_rankings())# 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, ...)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)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)progressively(f, p = NULL)
Arguments
f |
a function to add progressr functionality to. |
p |
a progressor function as created by |
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)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()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. |
See Also
Other RealGM Functions:
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_coaches()) ## End(Not run)## 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)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 ( |
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).
|
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_draft(year = 2020)) ## End(Not run)## 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()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).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_draft_prospects()) ## End(Not run)## 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()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).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_early_entry()) ## End(Not run)## 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()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. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_future_free_agents()) ## End(Not run)## 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()realgm_gms()
Value
A hoopR_data tibble with one row per general manager (staff,
team, start_season, years_in_role, birth_date, nationality).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_gms()) ## End(Not run)## 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()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.).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_individual_games()) ## End(Not run)## 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()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.).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_individual_seasons()) ## End(Not run)## 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" )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. |
stat_type |
Statistic family. One of |
season_type |
Season segment. One of |
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. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_player_stats(season = 2025, stat_type = "Averages")) ## End(Not run)## 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()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. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_players()) ## End(Not run)## 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()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. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_players_abroad()) ## End(Not run)## 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()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).
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_rookie_scale()) ## End(Not run)## 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()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. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_standings(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_salary_cap()) ## End(Not run)## 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()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.
|
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_team_stats(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_standings()) ## End(Not run)## 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" )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. |
stat_type |
Statistic family. One of |
season_type |
Season segment. One of |
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.
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_teams(),
realgm_transactions()
Examples
## Not run: try(realgm_team_stats(season = 2025, stat_type = "Averages")) ## End(Not run)## 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()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.
|
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_transactions()
Examples
## Not run: try(realgm_teams()) ## End(Not run)## 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()realgm_transactions()
Value
A hoopR_data tibble with one row per transaction:
| col_name | types | description |
| date | Date | Transaction date. |
| transaction | character | Transaction description. |
See Also
Other RealGM Functions:
realgm_coaches(),
realgm_draft(),
realgm_draft_prospects(),
realgm_early_entry(),
realgm_future_free_agents(),
realgm_gms(),
realgm_individual_games(),
realgm_individual_seasons(),
realgm_player_stats(),
realgm_players(),
realgm_players_abroad(),
realgm_rookie_scale(),
realgm_salary_cap(),
realgm_standings(),
realgm_team_stats(),
realgm_teams()
Examples
## Not run: try(realgm_transactions()) ## End(Not run)## 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()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)rejoin_schedules(df)
Arguments
df |
data frame pulled from nba_leaguegamefinder() |
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()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())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())spotrac_team_cap(season = most_recent_nba_season())
Arguments
season |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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).
|
See Also
Other Salary & Draft Functions:
hoopshype_salaries(),
nbadraft_mock_draft()
Examples
try(spotrac_team_cap(season = 2024))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_linksteams_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())torvik_game_schedule(year = most_recent_mbb_season())
Arguments
year |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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.
See Also
Other Torvik Functions:
torvik_game_stats(),
torvik_ncaa_results(),
torvik_player_stats(),
torvik_ratings(),
torvik_team_factors()
Examples
try(torvik_game_schedule(year = 2024))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())torvik_game_stats(year = most_recent_mbb_season())
Arguments
year |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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.
|
See Also
Other Torvik Functions:
torvik_game_schedule(),
torvik_ncaa_results(),
torvik_player_stats(),
torvik_ratings(),
torvik_team_factors()
Examples
try(torvik_game_stats(year = 2024))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")torvik_ncaa_results(min_year, max_year, type = "team")
Arguments
min_year |
(integer required): Minimum tournament year (4-digit, e.g. |
max_year |
(integer required): Maximum tournament year (4-digit, e.g. |
type |
(character optional): Aggregation level. One of |
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).
|
See Also
Other Torvik Functions:
torvik_game_schedule(),
torvik_game_stats(),
torvik_player_stats(),
torvik_ratings(),
torvik_team_factors()
Examples
try(torvik_ncaa_results(min_year = 2010, max_year = 2024, type = "conf"))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())torvik_player_stats(year = most_recent_mbb_season())
Arguments
year |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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.
See Also
Other Torvik Functions:
torvik_game_schedule(),
torvik_game_stats(),
torvik_ncaa_results(),
torvik_ratings(),
torvik_team_factors()
Examples
try(torvik_player_stats(year = 2024))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())torvik_ratings(year = most_recent_mbb_season())
Arguments
year |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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.
See Also
Other Torvik Functions:
torvik_game_schedule(),
torvik_game_stats(),
torvik_ncaa_results(),
torvik_player_stats(),
torvik_team_factors()
Examples
try(torvik_ratings(year = 2024))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())torvik_team_factors(year = most_recent_mbb_season())
Arguments
year |
(integer required): Season, in 4-digit ending-year format
(e.g. |
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).
|
See Also
Other Torvik Functions:
torvik_game_schedule(),
torvik_game_stats(),
torvik_ncaa_results(),
torvik_player_stats(),
torvik_ratings()
Examples
try(torvik_team_factors(year = 2024))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 )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 |
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 |
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 nametblnamewill 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 nametblnamewill be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.
The parameter db_connection is intended for advanced users who want
to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that
the arguments dbdir and dbname are dropped in case a db_connection
is provided but the argument tblname will still be used to write the
data table into the database.
Value
Returns a logical value (TRUE/FALSE)
See Also
Other hoopR Database Functions:
update_nba_db()
Update or create a hoopR NBA play-by-play database
Description
update_nba_db() updates or creates a database with hoopR
play by play data of all completed and available games since 2002.
Usage
update_nba_db( dbdir = ".", dbname = "hoopR_db", tblname = "hoopR_nba_pbp", force_rebuild = FALSE, db_connection = NULL )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 |
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 |
Details
This function creates and updates a data table with the name tblname
within a SQLite database (other drivers via db_connection) located in
dbdir and named dbname.
The data table combines all play by play data for every available game back
to the 2002 season and adds the most recent completed games as soon as they
are available for hoopR.
The argument force_rebuild is of hybrid type. It can rebuild the play
by play data table either for the whole hoopR era (with force_rebuild = TRUE)
or just for specified seasons (e.g. force_rebuild = c(2019, 2020)).
Please note the following behavior:
-
force_rebuild = TRUE: The data table with the nametblnamewill 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 nametblnamewill be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.
The parameter db_connection is intended for advanced users who want
to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that
the arguments dbdir and dbname are dropped in case a db_connection
is provided but the argument tblname will still be used to write the
data table into the database.
Value
Returns a logical value (TRUE/FALSE)
See Also
Other hoopR Database Functions:
update_mbb_db()
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 )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
|
datasets |
Character vector of dataset shortnames (see Details). |
seasons |
Optional integer vector of seasons to load. Defaults to all
available seasons ( |
db_connection |
A |
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)year_to_season(year)
Arguments
year |
Four digit year (XXXX) |