Basketball-Reference Player Game Log

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

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

Usage

bref_player_game_log(player_id, season = most_recent_nba_season())

Arguments

player_id

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

season

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

Value

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

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

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

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

# \donttest{
  try(bref_player_game_log(player_id = "jokicni01", season = 2024))
#> ── Player game log from basketball-reference.com ──────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-06-13 07:17:29 UTC
#> # A tibble: 82 × 36
#>    ranker player_game_num_career team_game_num_season date  team  location opp  
#>     <dbl>                  <dbl>                <dbl> <chr> <chr> <chr>    <chr>
#>  1      1                    597                    1 2023… DEN   ""       LAL  
#>  2      2                    598                    2 2023… DEN   "@"      MEM  
#>  3      3                    599                    3 2023… DEN   "@"      OKC  
#>  4      4                    600                    4 2023… DEN   ""       UTA  
#>  5      5                    601                    5 2023… DEN   "@"      MIN  
#>  6      6                    602                    6 2023… DEN   ""       DAL  
#>  7      7                    603                    7 2023… DEN   ""       CHI  
#>  8      8                    604                    8 2023… DEN   ""       NOP  
#>  9      9                    605                    9 2023… DEN   ""       GSW  
#> 10     10                    606                   10 2023… DEN   "@"      HOU  
#> # ℹ 72 more rows
#> # ℹ 29 more variables: result <chr>, is_starter <chr>, mp <chr>, fg <dbl>,
#> #   fga <dbl>, fg_pct <dbl>, fg3 <dbl>, fg3a <dbl>, fg3_pct <dbl>, fg2 <dbl>,
#> #   fg2a <dbl>, fg2_pct <dbl>, efg_pct <dbl>, ft <dbl>, fta <dbl>,
#> #   ft_pct <dbl>, orb <dbl>, drb <dbl>, trb <dbl>, ast <dbl>, stl <dbl>,
#> #   blk <dbl>, tov <dbl>, pf <dbl>, pts <dbl>, game_score <dbl>,
#> #   plus_minus <dbl>, player_id <chr>, season <int>
# }