Skip to contents

The API's current pointers: competition, edition, week, round and match.

One row: the ids the site opens by default, and the current match with its teams.

Endpoint: GET https://api2.acb.com/api/matchdata/Menu/competition-data

Usage

acb_competition_current(competition_ids = NULL)

Arguments

competition_ids

(default NULL) Competition id (1, 2, 3, 10) or a list of ids for several. Omitted = the API's default competition. One or more whole numbers (a vector repeats competitionIds in the query).

Value

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

col_nametypedescription
competition_idintegerCompetition the site opens by default.
edition_idintegerEdition (season) the site opens by default.
seasonintegerSeason END year (2027 = 2026-27) = edition_id + 1936: the key the wrappers take.
week_idintegerWeek the site opens by default.
round_idintegerRound the site opens by default.
match_groupingcharacterround or week (current pointers)
match_idintegerThe current match (the featured game).
statuscharacterState of the current match.
startPOSIXctTip-off instant (UTC) of the current match.
home_team_idintegerHome season-team entry id of the current match.
home_club_idintegerHome stable club id of the current match.
home_teamcharacterHome team name of the current match.
home_team_abbrcharacterHome team abbreviation of the current match.
away_team_idintegerAway season-team entry id of the current match.
away_club_idintegerAway stable club id of the current match.
away_teamcharacterAway team name of the current match.
away_team_abbrcharacterAway team abbreviation of the current match.

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_competition_current())
#> Error in acb_competition_current() : 
#>   api2.acb.com/api/matchdata/Menu/competition-data: the answer holds no
#> rows (competitions is empty).
# }