Skip to contents

A club's player season statistics for an edition: totals, averages and per-40 side by side.

One row per player. total_* are season counts (Int64; total_time_played is seconds, *_percentage are Float64), avg_* per-game averages and per40_* per-40-minute rates (Float64). num_games is games played and starter games started.

Endpoint: GET https://api2.acb.com/api/seasondata/TeamProfile/team-stats

Usage

acb_team_stats(club_id, competition_id = NULL, season = NULL)

Arguments

club_id

(required) ACB club id (integer), stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket). Not the season-team team_id. 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 (2027 = 2026-27; the first ACB season, 1983-84, is 1984). acb_runtime sends the API's editionId = season - 1936. Omitted = the current season. 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_team_stats):

col_nametypedescription
club_idintegerStable club id of the club asked for (2 = Barca).
team_idintegerSeason-team entry id of the selected edition.
edition_idintegerSeason id (editionId) = season START year - 1935 (91 = 2026-27). The wrappers take the END year, season.
seasonintegerSeason END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take.
player_idintegerACB licence number: the person id everywhere. A player's box-score player.id, his play-by-play and shot playerLicenseId and the playerLicenceId / playerLicense request params hold the same number (all 24 players of match 105401 match). 20209407 = Edy Tavares. Older licences start 2020..., recent ones 3000....
player_namecharacterDisplay (sporting) name ('Edy Tavares')
first_namecharacterLegal first name(s)
last_namecharacterLegal last name(s)
shirt_numbercharacterShirt number, a string (” or null when unknown)
game_rolecharacterPosition or staff role, in Spanish: Base (point guard), Escolta (shooting guard), Alero (small forward), Ala-pivot (power forward), Pivot (centre); Entrenador (head coach), Segundo Entrenador / Entrenador Ayudante (assistant coach). Null or ” in many rows
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_team_stats(club_id = 2, season = 2027))
#> ── ACB Team Stats from api2.acb.com ───────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:45 UTC
#> # A tibble: 14 × 97
#>    club_id team_id edition_id season player_id player_name  first_name last_name
#>      <int>   <int>      <int>  <int>     <int> <chr>        <chr>      <chr>    
#>  1       2    4467         91   2027  30005357 Olivier Nka… Olivier    Nkamhoua 
#>  2       2    4467         91   2027  20212243 Olek Balcer… Aleksander Balcerow…
#>  3       2    4467         91   2027  30005378 Tyrese Mart… Tyrese     Martin   
#>  4       2    4467         91   2027  30001332 Agustín Ubal Agustín    Ubal     
#>  5       2    4467         91   2027  30005377 Tosan Evbuo… Torisesan  Evbuomwan
#>  6       2    4467         91   2027  30005356 Josh Nebo    Joshua     Nebo     
#>  7       2    4467         91   2027  20212265 Joel Parra   Joel       Parra    
#>  8       2    4467         91   2027  30003340 Justin Robi… Justin     Robinson 
#>  9       2    4467         91   2027  30005355 Umoja Gibson Umoja      Gibson   
#> 10       2    4467         91   2027  30000093 Juan Núñez   Juan       Núñez    
#> 11       2    4467         91   2027  30003361 Kevin Punter Kevin      Punter   
#> 12       2    4467         91   2027  30005361 Stanley Umu… Stanley    Umude    
#> 13       2    4467         91   2027  20209919 Darío Brizu… Darío      Brizuela 
#> 14       2    4467         91   2027  30005476 Justin Mina… Justin     Minaya   
#> # ℹ 89 more variables: shirt_number <chr>, game_role <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>, …
# }