Skip to contents

Header of one finished game: date, venue, both clubs with their score and the Preciser game uuid.

Endpoint: GET https://pleagueofficial.com/game/{gid}

Usage

pleague_game(gid)

Arguments

gid

Required. P. LEAGUE+ game id on the site: ONE global integer sequence over every stage and season (197 = the 2022-23 opener, 662 = the 2025-26 opener), e.g. 197; gid in pleague_schedule. Only finished games are served.

Value

A hoopR_data tibble: Header of one finished game: date, venue, both clubs with their score and the Preciser game uuid. An empty valid answer is a zero-row tibble with these columns, in this order (sportsdataverse-py pleague_game):

col_nametypedescription
gidintegerP. LEAGUE+ game id on the site: ONE global integer sequence over every stage and season (1-12 = 2020-21 pre-season, 13 = the 2020-21 opener, 197 = the 2022-23 opener, 662 = the 2025-26 opener), with gaps; a row id, not a count. The {gid} of /game/{gid}.
uuidcharacterPreciser game uuid (key space: the analytics vendor's games, a version-1 uuid), embedded in the game page as getPlayByPlay('uuid'); keys the play-by-play and every pleague_preciser wrapper. Null before 2022-23 (the page embeds an empty string: no play-by-play or vendor data).
status_zhcharacterStatus badge: (Chinese text) = finished. The only value the wrappers serve (anything else raises hoopR_asset_fetch).
finishedlogicalTrue when the status badge is (Chinese text) (finished); always true for a served game.
dateDateGame date from the header, Asia/Taipei (UTC+8) local time.
timecharacterTip-off 'HH:MM' from the header, Asia/Taipei (UTC+8) local time.
venue_zhcharacterVenue (arena) name in Traditional Chinese.
game_label_zhcharacterStage and game number as printed in the header: '(Chinese text)G1' = regular season game 1 ('(Chinese text)G01' on 2020-21 pages); (Chinese text) = playoffs, (Chinese text) = finals.
away_name_zhcharacterAway team's name on that date in Traditional Chinese (short or long form; (Chinese text) = Braves, (Chinese text) = Pilots, (Chinese text) = Lioneers, (Chinese text) = Dreamers, (Chinese text) = Steelers, (Chinese text) = Kings, (Chinese text) = Ghosthawks, (Chinese text) = Yankey Ark). Printed names change by season (short and long forms, renames): key on the id, not the name.
away_name_encharacterAway team's English name on that date; renames change it. Null on 2020-21 game pages (no English name is printed).
away_logocharacterAway team logo url as printed by the page: protocol-relative ('//d36fypkbmmogz6.cloudfront.net/upload/p_team/logo_{team}_{epoch}.png'); some game pages print a malformed 'https:////d36...'. The trailing number is the upload time.
away_scoreintegerAway team's final points (0 on a future game).
home_name_zhcharacterHome team's name on that date in Traditional Chinese (short or long form). Printed names change by season (short and long forms, renames): key on the id, not the name.
home_name_encharacterHome team's English name on that date; renames change it. Null on 2020-21 game pages (no English name is printed).
home_logocharacterHome team logo url as printed by the page: protocol-relative ('//d36fypkbmmogz6.cloudfront.net/upload/p_team/logo_{team}_{epoch}.png'); some game pages print a malformed 'https:////d36...'. The trailing number is the upload time.
home_scoreintegerHome team's final points (0 on a future game).
overtimesintegerNumber of overtime periods played (overtime cells with points on the page).

Details

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

Examples

# \donttest{
  try(pleague_game(gid = 197))
#> ── P. LEAGUE+ Game from pleagueofficial.com ───────────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:33:21 UTC
#> # A tibble: 1 × 17
#>     gid uuid          status_zh finished date       time  venue_zh game_label_zh
#>   <int> <chr>         <chr>     <lgl>    <date>     <chr> <chr>    <chr>        
#> 1   197 e6f98675-3e5… 已完賽    TRUE     2022-11-05 17:00 臺北和平籃球館… 例行賽G1     
#> # ℹ 9 more variables: away_name_zh <chr>, away_name_en <chr>, away_logo <chr>,
#> #   away_score <int>, home_name_zh <chr>, home_name_en <chr>, home_logo <chr>,
#> #   home_score <int>, overtimes <int>
# }