Play-by-play of a final game (2017-18 on), one row per action with x/y; coordinate frame by era.
Endpoint: GET https://www.legabasket.it/api/championships/get-championships-matches-play-by-play (info=true&sort=asc&id=<game_id>)
Value
A hoopR_data tibble: Play-by-play of a final game (2017-18 on), one row per action with x/y; coordinate frame
by era. The columns are always these, in this order (sportsdataverse-py lba_pbp); a column the site adds later is
appended after them:
| col_name | type | description |
| game_id | integer | Game id (global across seasons); joins lba_calendar and lba_game. |
| season | integer | Season END year (2027 = 2026-27): the row's START year + 1. |
| home_team_id | integer | Home team-season id of the game (the play-by-play ht_id). |
| visitor_team_id | integer | Visitor team-season id of the game (the play-by-play vt_id). |
| team_side | character | Side of the acting team, home or visitor; null for a clock action without a team. |
| home_score | integer | Home points after the action, parsed from the score text (2021-22 on; else null). |
| visitor_score | integer | Visitor points after the action, parsed from the score text (2021-22 on; else null). |
| coord_frame | character | Frame of x and y: half_court_px (2017-18 and 2018-19 image pixels) or court_pct (2019-20 on, 0-100). |
| action_id | integer | Action id within the game (ascending in time from 2021-22; not ordered before). |
| description | character | Action type in Italian, e.g. 2 punti segnato (2-pointer made); full translation table in the Divergence notes. |
| player_id | integer | Player id (null for team and clock actions). |
| team_id | integer | Team id (team-season) of the actor. |
| home_club | integer | 1 = the home team acted, 0 = the away team; null for clock actions, and on every action in 2018-19 and 2019-20 (use side there). |
| in_area | logical | True on shots from the paint (zone 3). |
| dunk | integer | 1 = dunk, 0 otherwise. |
| seconds | integer | Elapsed seconds within minute (0-59); 0 before 2019-20. Elapsed = minute x 60 + seconds; print_time = period length minus that. |
| minute | integer | Elapsed minute of the period (2019-20 on: 0-9, with seconds); 2017-18 / 2018-19: 1-10, the minute in progress, seconds 0. |
| period | integer | Period: 1-4, 5+ = overtime. |
| order | integer | Sort key; sort=asc orders by it. |
| side | integer | Basket the row's side_area_zone is measured from, as sent: 0 = the basket at x = 0, 1 = the one at x = 100 (zone A is that basket's half: x < 50 for 0, x >= 50 for 1). It is NOT the team of the game (that is team_side): on shots, assists, fouls committed, turnovers and offensive rebounds it is the actor's attacking basket, which changes at half-time; on defensive rebounds, steals, blocks and fouls drawn it is the opponent's. |
| x | integer | Court x; frame by era (see the coordinates section): 2019-20 on, 0-100 % of the 28 m length; 2017-18 / 2018-19, half-court image pixels; null (2019-20 on) or 0 (earlier) when unlocated. |
| y | integer | Court y; 2019-20 on, 0-100 % of the 15 m width; 2017-18 / 2018-19, image pixels (see the coordinates section). |
| score | character | Score after the action, home - away string (0 - 0); 2020-21 on scoring actions only, null before. |
| linked_action_id | integer | action_id of the related action: the shot an assist or rebound belongs to, the foul a drawn foul answers, the player swapped in a substitution. |
| print_time | character | Game clock remaining, MM:SS (10:00 at a period start); null before 2021-22. |
| action_1_qualifier_code | character | First qualifier code, number sent as a string (shot type, turnover type, foul type; see legend). |
| action_2_qualifier_code | character | Second qualifier code (fast break 500, blocked 1005, tip-ins 1001-1004, ...). |
| action_1_qualifier_description | character | legend label of action_1_qualifier_code, Italian. |
| action_2_qualifier_description | character | legend label of action_2_qualifier_code, Italian. |
| side_area_zone | character | A = in the actor's attacking half, D = its defensive half (2021-22 on). |
| side_area_code | character | Court zone 1-10, number sent as a string (see the coordinates section; 2021-22 on). |
| player_name | character | Given name of the acting player. |
| player_surname | character | Family name of the acting player. |
| player_number | character | Jersey number, number sent as a string. |
| team_name | character | Team name in that season, with its sponsor (Nutribullet Treviso Basket); changes with the sponsor. |
| id | integer | Always null (not a key). |
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in lba_championships().
See also
Other LBA Functions:
lba_box_score(),
lba_calendar(),
lba_championships(),
lba_game(),
lba_game_log(),
lba_pbp_legend(),
lba_player(),
lba_player_stats(),
lba_players(),
lba_players_leaderboard(),
lba_roster(),
lba_roster_coach(),
lba_shots(),
lba_standings(),
lba_team_box_score(),
lba_team_players_stats(),
lba_teams(),
lba_teams_leaderboard()
Examples
# \donttest{
try(lba_pbp(game_id = 25602))
#> ── LBA Play-by-Play from legabasket.it ────────────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:31:38 UTC
#> # A tibble: 605 × 36
#> game_id season home_team_id visitor_team_id team_side home_score
#> <int> <int> <int> <int> <chr> <int>
#> 1 25602 2027 1764 1761 NA 0
#> 2 25602 2027 1764 1761 home 0
#> 3 25602 2027 1764 1761 home 0
#> 4 25602 2027 1764 1761 home 0
#> 5 25602 2027 1764 1761 home 0
#> 6 25602 2027 1764 1761 home 0
#> 7 25602 2027 1764 1761 home 0
#> 8 25602 2027 1764 1761 visitor 0
#> 9 25602 2027 1764 1761 visitor 0
#> 10 25602 2027 1764 1761 visitor 0
#> # ℹ 595 more rows
#> # ℹ 30 more variables: visitor_score <int>, coord_frame <chr>, action_id <int>,
#> # description <chr>, player_id <int>, team_id <int>, home_club <int>,
#> # in_area <lgl>, dunk <int>, seconds <int>, minute <int>, period <int>,
#> # order <int>, side <int>, x <int>, y <int>, score <chr>,
#> # linked_action_id <int>, print_time <chr>, action_1_qualifier_code <chr>,
#> # action_2_qualifier_code <chr>, action_1_qualifier_description <chr>, …
# }