Skip to contents

A player's season statistics, one row per team and edition.

One row per team-edition the player played: total_* counts, avg_* averages and per40_* per-40 rates as in acb_team_stats. edition_year is the label ('2026-2027').

Endpoint: GET https://api2.acb.com/api/seasondata/PlayerProfile/player-stats

Usage

acb_player_stats(player_id, competition_id = NULL, season = NULL)

Arguments

player_id

(required) ACB licence number (integer): the person id everywhere (box score, play-by-play, shots, rosters). 20209407 = Edy Tavares, 20212243 = Olek Balcerowski. A whole number; a whole double is accepted.

competition_id

(default NULL) Competition id: 1 Liga Endesa, 2 Copa del Rey, 3 Supercopa Endesa, 10 Minicopa Endesa (youth). Omitted = the API's default competition. A whole number; a whole double is accepted.

season

(default NULL) Season END year used as an UPPER bound: the rows keep the seasons up to this one (2026 drops the 2026-27 row). Omitted = all seasons. A whole number; a whole double is accepted.

Value

A hoopR_data tibble, one row per record described above; the columns are always these, in this order (sportsdataverse-py acb_player_stats):

col_nametypedescription
player_idintegerACB licence number asked for (the body names the player only in the totals block).
team_idintegerSeason-team entry the row covers (the API's teamEditionId).
competition_idintegerCompetition of the row.
edition_idintegerSeason id of the row (START year - 1935).
seasonintegerSeason END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take.
edition_yearcharacterSeason label as sent ('2026-2027').
club_idintegerStable club id of the team.
teamcharacterTeam name that season.
team_abbrcharacterTeam abbreviation that season.
total_num_gamesintegerSeason total of games played.
total_time_playedintegerSeason total of time on court in seconds.
total_starterintegerSeason total of games started.
total_pointsintegerSeason total of points.
total_max_pointsintegerSeason total of most points in a single game.
total_three_pointers_madeintegerSeason total of three-point field goals made.
total_three_pointers_attemptedintegerSeason total of three-point field goals attempted.
total_three_pointers_percentagedoubleSeason total of three-point percentage (0-100).
total_two_pointers_madeintegerSeason total of two-point field goals made.
total_two_pointers_attemptedintegerSeason total of two-point field goals attempted.
total_two_pointers_percentagedoubleSeason total of two-point percentage (0-100).
total_free_throws_madeintegerSeason total of free throws made.
total_free_throws_attemptedintegerSeason total of free throws attempted.
total_free_throws_percentagedoubleSeason total of free-throw percentage (0-100).
total_reboundsintegerSeason total of total rebounds.
total_offensive_reboundsintegerSeason total of offensive rebounds.
total_defensive_reboundsintegerSeason total of defensive rebounds.
total_assistsintegerSeason total of assists.
total_stealsintegerSeason total of steals.
total_turnoversintegerSeason total of turnovers.
total_blocksintegerSeason total of blocks made.
total_shots_rejectedintegerSeason total of own shots blocked.
total_dunksintegerSeason total of dunks.
total_personal_foulsintegerSeason total of personal fouls committed.
total_fouls_receivedintegerSeason total of fouls drawn.
total_ratingintegerSeason total of ACB rating (valoracion).
total_plus_minusintegerSeason total of plus/minus.
total_winsintegerSeason total of team wins in the counted games (meaning unverified).
total_lossesintegerSeason total of team losses in the counted games (meaning unverified).
avg_num_gamesdoublePer-game average of games played.
avg_time_playeddoublePer-game average of time on court in seconds.
avg_starterdoublePer-game average of games started.
avg_pointsdoublePer-game average of points.
avg_max_pointsdoublePer-game average of most points in a single game.
avg_three_pointers_madedoublePer-game average of three-point field goals made.
avg_three_pointers_attempteddoublePer-game average of three-point field goals attempted.
avg_three_pointers_percentagedoublePer-game average of three-point percentage (0-100).
avg_two_pointers_madedoublePer-game average of two-point field goals made.
avg_two_pointers_attempteddoublePer-game average of two-point field goals attempted.
avg_two_pointers_percentagedoublePer-game average of two-point percentage (0-100).
avg_free_throws_madedoublePer-game average of free throws made.
avg_free_throws_attempteddoublePer-game average of free throws attempted.
avg_free_throws_percentagedoublePer-game average of free-throw percentage (0-100).
avg_reboundsdoublePer-game average of total rebounds.
avg_offensive_reboundsdoublePer-game average of offensive rebounds.
avg_defensive_reboundsdoublePer-game average of defensive rebounds.
avg_assistsdoublePer-game average of assists.
avg_stealsdoublePer-game average of steals.
avg_turnoversdoublePer-game average of turnovers.
avg_blocksdoublePer-game average of blocks made.
avg_shots_rejecteddoublePer-game average of own shots blocked.
avg_dunksdoublePer-game average of dunks.
avg_personal_foulsdoublePer-game average of personal fouls committed.
avg_fouls_receiveddoublePer-game average of fouls drawn.
avg_ratingdoublePer-game average of ACB rating (valoracion).
avg_plus_minusdoublePer-game average of plus/minus.
avg_winsdoublePer-game average of team wins in the counted games (meaning unverified).
avg_lossesdoublePer-game average of team losses in the counted games (meaning unverified).
per40_num_gamesdoublePer-40-minute rate of games played.
per40_time_playeddoubleAlways null: the per-40 block carries no time played.
per40_starterdoublePer-40-minute rate of games started.
per40_pointsdoublePer-40-minute rate of points.
per40_max_pointsdoublePer-40-minute rate of most points in a single game.
per40_three_pointers_madedoublePer-40-minute rate of three-point field goals made.
per40_three_pointers_attempteddoublePer-40-minute rate of three-point field goals attempted.
per40_three_pointers_percentagedoublePer-40-minute rate of three-point percentage (0-100).
per40_two_pointers_madedoublePer-40-minute rate of two-point field goals made.
per40_two_pointers_attempteddoublePer-40-minute rate of two-point field goals attempted.
per40_two_pointers_percentagedoublePer-40-minute rate of two-point percentage (0-100).
per40_free_throws_madedoublePer-40-minute rate of free throws made.
per40_free_throws_attempteddoublePer-40-minute rate of free throws attempted.
per40_free_throws_percentagedoublePer-40-minute rate of free-throw percentage (0-100).
per40_reboundsdoublePer-40-minute rate of total rebounds.
per40_offensive_reboundsdoublePer-40-minute rate of offensive rebounds.
per40_defensive_reboundsdoublePer-40-minute rate of defensive rebounds.
per40_assistsdoublePer-40-minute rate of assists.
per40_stealsdoublePer-40-minute rate of steals.
per40_turnoversdoublePer-40-minute rate of turnovers.
per40_blocksdoublePer-40-minute rate of blocks made.
per40_shots_rejecteddoublePer-40-minute rate of own shots blocked.
per40_dunksdoublePer-40-minute rate of dunks.
per40_personal_foulsdoublePer-40-minute rate of personal fouls committed.
per40_fouls_receiveddoublePer-40-minute rate of fouls drawn.
per40_ratingdoublePer-40-minute rate of ACB rating (valoracion).
per40_plus_minusdoublePer-40-minute rate of plus/minus.
per40_winsdoublePer-40-minute rate of team wins in the counted games (meaning unverified).
per40_lossesdoublePer-40-minute rate of team losses in the counted games (meaning unverified).

Details

Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in acb_match_header().

Examples

# \donttest{
  try(acb_player_stats(player_id = 20209407))
#> ── ACB Player Stats from api2.acb.com ─────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:38 UTC
#> # A tibble: 13 × 96
#>    player_id team_id competition_id edition_id season edition_year club_id team 
#>        <int>   <int>          <int>      <int>  <int> <chr>          <int> <chr>
#>  1  20209407    4476              1         91   2027 2026-2027          9 Real…
#>  2  20209407    4388              1         90   2026 2025-2026          9 Real…
#>  3  20209407    4345              1         89   2025 2024-2025          9 Real…
#>  4  20209407    4239              1         88   2024 2023-2024          9 Real…
#>  5  20209407    4149              1         87   2023 2022-2023          9 Real…
#>  6  20209407    3674              1         86   2022 2021-2022          9 Real…
#>  7  20209407    3387              1         85   2021 2020-2021          9 Real…
#>  8  20209407    3301              1         84   2020 2019-2020          9 Real…
#>  9  20209407    3212              1         83   2019 2018-2019          9 Real…
#> 10  20209407    3148              1         82   2018 2017-2018          9 Real…
#> 11  20209407    2980              1         79   2015 2014-2015          5 Herb…
#> 12  20209407    2940              1         78   2014 2013-2014          5 Herb…
#> 13  20209407    2870              1         77   2013 2012-2013          5 Gran…
#> # ℹ 88 more variables: team_abbr <chr>, total_num_games <int>,
#> #   total_time_played <int>, total_starter <int>, total_points <int>,
#> #   total_max_points <int>, total_three_pointers_made <int>,
#> #   total_three_pointers_attempted <int>,
#> #   total_three_pointers_percentage <dbl>, total_two_pointers_made <int>,
#> #   total_two_pointers_attempted <int>, total_two_pointers_percentage <dbl>,
#> #   total_free_throws_made <int>, total_free_throws_attempted <int>, …
# }