Play-by-play of one finished game (2022-23 on) in game order, with shot x / y and the clip references.
Endpoint: GET https://pleagueofficial.com/api/playbyplay.php?uuid={uuid} (after the game page, which holds the uuid)
Value
A hoopR_data tibble with one row per play-by-play event.
Its columns are listed in return_columns
(subset(return_columns, fn == "pleague_pbp")) and in the searchable
return columns article.
Details
Source, terms of use, request pacing, seasons, ids, coverage and error classes of this family: see the notes in pleague_schedule().
Action codes
Each code of action, its meaning and [the number of plays] in 258,183 plays of 404 finished 2022-23..2025-26 games (82 printed phrases plus the blank row):
ast: assist [17,020]blk: block [3,181]fg2_alley_oop_made: 2-point alley-oop, made [205]fg2_alley_oop_missed: 2-point alley-oop, missed [81]fg2_driving_layup_made: 2-point driving layup, made [4,281]fg2_driving_layup_missed: 2-point driving layup, missed [3,961]fg2_dunk_made: 2-point dunk, made [1,316]fg2_dunk_missed: 2-point dunk, missed [162]fg2_fadeaway_jumper_made: 2-point fadeaway jumper, made [583]fg2_fadeaway_jumper_missed: 2-point fadeaway jumper, missed [1,121]fg2_floater_made: 2-point floater, made [1,920]fg2_floater_missed: 2-point floater, missed [3,052]fg2_hook_shot_made: 2-point hook shot, made [610]fg2_hook_shot_missed: 2-point hook shot, missed [773]fg2_jump_shot_made: 2-point jump shot, made [1,657]fg2_jump_shot_missed: 2-point jump shot, missed [3,606]fg2_layup_made: 2-point layup, made [4,428]fg2_layup_missed: 2-point layup, missed [3,403]fg2_pull_up_jumper_made: 2-point pull-up jumper, made [1,004]fg2_pull_up_jumper_missed: 2-point pull-up jumper, missed [1,564]fg2_putback_made: 2-point putback / tip-in, made [2,138]fg2_putback_missed: 2-point putback / tip-in, missed [1,539]fg2_step_back_shot_made: 2-point step-back shot, made [243]fg2_step_back_shot_missed: 2-point step-back shot, missed [410]fg2_turnaround_jumper_made: 2-point turnaround jumper, made [672]fg2_turnaround_jumper_missed: 2-point turnaround jumper, missed [1,158]fg3_fadeaway_jumper_made: 3-point fadeaway jumper, made [48]fg3_fadeaway_jumper_missed: 3-point fadeaway jumper, missed [92]fg3_made: 3-point shot, style not recorded, made [7,817]fg3_missed: 3-point shot, style not recorded, missed [17,046]fg3_pull_up_jumper_made: 3-point pull-up jumper, made [480]fg3_pull_up_jumper_missed: 3-point pull-up jumper, missed [922]fg3_step_back_shot_made: 3-point step-back shot, made [245]fg3_step_back_shot_missed: 3-point step-back shot, missed [559]fg3_turnaround_jumper_made: 3-point turnaround jumper, made [10]fg3_turnaround_jumper_missed: 3-point turnaround jumper, missed [23]fg_made: field goal made, shot type and distance not recorded [158]fg_missed: field goal missed, shot type and distance not recorded [168]foul: foul, kind not recorded (team row) [18]foul_bench_technical: technical foul on the bench [35]foul_coach_technical: technical foul on the coach [75]foul_disqualifying: disqualifying foul [2]foul_drawn: foul drawn (the opponent's foul on this player) [17,035]foul_offensive: offensive foul committed [1,024]foul_personal: personal foul committed [15,745]foul_technical: technical foul [210]foul_unsportsmanlike: unsportsmanlike foul [261]ft_made: free throw 1 of 1 awarded, made [1,326]ft_made: free throw 1 of 3 awarded, made [128]ft_made: free throw 1 of 2 awarded, made [5,187]ft_made: free throw 3, made [149]ft_made: free throw 2, made [5,798]ft_missed: free throw 1 of 1 awarded, missed [669]ft_missed: free throw 1 of 3 awarded, missed [67]ft_missed: free throw 1 of 2 awarded, missed [2,736]ft_missed: free throw 3, missed [46]ft_missed: free throw 2, missed [2,319]jump_ball_lost: jump ball lost [404]jump_ball_won: jump ball won [708]reb_def: defensive rebound (a team rebound has no player) [29,537]reb_off: offensive rebound (a team rebound has no player) [12,379]review_coach_challenge: video review: coach's challenge (2025-26 onward; the printed text ends with a bare comma) [videoReview, coachChallenge,, 82]review_instant_replay: video review: instant-replay system, started by the officials (2025-26 onward) [videoReview, instantReplaySystem,, 67]review_instant_replay_1: video review: instant-replay system, variant printed with a trailing '1' (meaning unexplained; the row also prints the running score and the points tag '+videoReview') [videoReview, instantReplaySystem, 1, 6]stl: steal [7,361]sub_in: substitution: enters the game [25,505]sub_out: substitution: leaves the game [25,532]timeout: timeout (a team row) [2,854]tov_3sec: turnover: 3-second violation [249]tov_5sec: turnover: 5-second violation [40]tov_8sec: turnover: 8-second violation [26]tov_backcourt: turnover: backcourt violation [96]tov_bad_pass: turnover: bad pass [6,325]tov_ball_handling: turnover: ball-handling [3,547]tov_carrying: turnover: carrying the ball [47]tov_double_dribble: turnover: double dribble [53]tov_offensive: turnover: offensive (kind not recorded) [1,007]tov_offensive_goaltending: turnover: offensive goaltending [4]tov_other: turnover: other [51]tov_out_of_bounds: turnover: ball out of bounds [441]tov_shot_clock: turnover: shot-clock violation [489]tov_travel: turnover: travelling [718]unlabelled: row has a player but no action text; in the corpus a shot with x/y followed by a rebound, i.e. a missed shot (inferred) [(blank), 169]
See also
family_p_league lists every function in this family.
Examples
# \donttest{
try(pleague_pbp(gid = 197))
#> ── P. LEAGUE+ Play-by-Play from pleagueofficial.com ───────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-11-13 21:16:42 UTC
#> # A tibble: 630 × 26
#> gid seq period period_no clock seconds_left side jersey player_zh action
#> <int> <int> <chr> <int> <chr> <int> <chr> <chr> <chr> <chr>
#> 1 197 1 Q1 1 12:00 720 away 35 辛巴 jump_…
#> 2 197 2 Q1 1 12:00 720 home 5 強森 jump_…
#> 3 197 3 Q1 1 11:41 701 away 35 辛巴 fg2_d…
#> 4 197 4 Q1 1 11:41 701 away 31 阿提諾 ast
#> 5 197 5 Q1 1 11:20 680 home 5 強森 fg3_m…
#> 6 197 6 Q1 1 10:53 653 away 8 朱雲豪 tov_b…
#> 7 197 7 Q1 1 10:53 653 home 5 強森 stl
#> 8 197 8 Q1 1 10:49 649 home NA 賴廷恩 fg3_m…
#> 9 197 9 Q1 1 10:42 642 away 35 辛巴 fg2_l…
#> 10 197 10 Q1 1 10:42 642 away 9 田浩 ast
#> # ℹ 620 more rows
#> # ℹ 16 more variables: action_zh <chr>, action_en <chr>, text_zh <chr>,
#> # ft_number <int>, ft_awarded <int>, points <int>, score_away <int>,
#> # score_home <int>, x <dbl>, y <dbl>, nice_play <lgl>, video_uuid <chr>,
#> # synergy_play_id <chr>, video_stat_category <chr>, tryspot_player_id <int>,
#> # video_created_at <chr>
# }
