Skip to contents

Get ACB Bracket

Source: R/acb.R
acb_bracket.Rd

Playoff bracket: one row per series (quarter-final, semifinal, final).

One row per series; stage is quarter_finals, semifinals or final. home_wins / away_wins are the series score, best_of the series length, n_games the games listed. An edition with no playoffs yet raises hoopR_no_data.

Endpoint: GET https://api2.acb.com/api/seasondata/Competition/bracket

Usage

acb_bracket(competition_id = NULL, season = NULL)

Arguments

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_bracket):

col_nametypedescription
stagecharacterBracket stage: quarter_finals, semifinals, final (other_positions when present).
phase_idintegerPhase id of the series (111 = Play Off Titulo).
subphase_idintegerSub-phase id (the playoff stage).
home_team_idintegerSeason-team id: one team's entry in one competition edition (4467 = Barca in Liga 2026-27, 4388 = Real Madrid in Liga 2025-26). Changes every season and competition. Joins every homeTeamId / awayTeamId / teamId / teamEditionId. Not the club id.
home_club_idintegerClub id, stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket): the clubId request param and every homeClubId / awayClubId.
home_teamcharacterTeam name that season (sponsor names change)
home_team_abbrcharacterThree-letter abbreviation (BAR, RMB)
away_team_idintegerSeason-team id: one team's entry in one competition edition (4467 = Barca in Liga 2026-27, 4388 = Real Madrid in Liga 2025-26). Changes every season and competition. Joins every homeTeamId / awayTeamId / teamId / teamEditionId. Not the club id.
away_club_idintegerClub id, stable across seasons and sponsor names (2 = Barca, 9 = Real Madrid, 13 = Valencia Basket): the clubId request param and every homeClubId / awayClubId.
away_teamcharacterTeam name that season (sponsor names change)
away_team_abbrcharacterThree-letter abbreviation (BAR, RMB)
home_winsintegerGames won by the home-court team in the series.
away_winsintegerGames won by the other team in the series.
finishedlogicalTrue once the series is decided.
best_ofintegerSeries length (best of N).
n_gamesintegerGames listed for the series.
edition_idintegerSeason id (editionId) = season START year - 1935 (91 = 2026-27, 81 = 2016-17, 70 = 2005-06, 48 = 1983-84, the first). The sdv season (END year) is editionId + 1936. Season lists also carry seasonStartYear / seasonEndYear
seasonintegerSeason END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take.

Details

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

See also

Other ACB Functions: acb_box_info(), acb_bracket_games(), acb_calendar(), acb_career_stints(), acb_career_trophies(), acb_club_data(), acb_competition_current(), acb_competition_editions(), acb_competition_rounds(), acb_competition_weeks(), acb_current_roster(), acb_lead_stats(), acb_lead_tracker(), acb_league_zones(), acb_lineup(), acb_match_advanced_stats(), acb_match_header(), acb_match_leaders(), acb_matchlist(), acb_next_matches(), acb_pbp(), acb_period_scores(), acb_player_advanced_stats(), acb_player_box(), acb_player_data(), acb_player_matches(), acb_player_stats(), acb_player_totals(), acb_quickfacts(), acb_round_matches(), acb_search(), acb_season_leaders(), acb_serie(), acb_shots(), acb_standings(), acb_standings_rounds(), acb_team_box(), acb_team_comparison(), acb_team_leaders(), acb_team_matches(), acb_team_records(), acb_team_stats(), acb_team_totals(), acb_teams()

Examples

# \donttest{
  try(acb_bracket(season = 2026))
#> ── ACB Bracket from api2.acb.com ──────────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:26:24 UTC
#> # A tibble: 7 × 18
#>   stage  phase_id subphase_id home_team_id home_club_id home_team home_team_abbr
#>   <chr>     <int>       <int>        <int>        <int> <chr>     <chr>         
#> 1 quart…      111         293         4388            9 Real Mad… RMB           
#> 2 quart…      111         293         4393           12 UCAM Mur… UCM           
#> 3 quart…      111         293         4397           13 Valencia… VBC           
#> 4 quart…      111         293         4398            3 Kosner B… BKN           
#> 5 semif…      111         292         4386            2 Barça     BAR           
#> 6 semif…      111         292         4397           13 Valencia… VBC           
#> 7 final       111         291         4397           13 Valencia… VBC           
#> # ℹ 11 more variables: away_team_id <int>, away_club_id <int>, away_team <chr>,
#> #   away_team_abbr <chr>, home_wins <int>, away_wins <int>, finished <lgl>,
#> #   best_of <int>, n_games <int>, edition_id <int>, season <int>
# }