Skip to contents

Advanced player box of a finished game (usage, true shooting, rebound/steal/block rates, zone splits), one row per player.

Endpoint: POST https://data-server.cbaleague.com/api/player-match-datas/advance-count (JSON body)

Usage

cba_player_advanced(schedule_id)

Arguments

schedule_id

(required) Required. CBA game id (integer), the global 9-digit sequence 100xxxxxx (100105799 = 2025-26 round 1). Only a finished game is served.

Value

A hoopR_data tibble: One row per player (deduplicated on player_id, first row kept). An empty valid answer is a zero-row tibble with these columns, in this order (sportsdataverse-py cba_player_advanced):

col_nametypedescription
schedule_idintegerCBA game id (key space: CBA games, ONE global 9-digit sequence 100xxxxxx across seasons and match types; the {scheduleId} of every game route). Stamped by the runtime from the request; null on a body parsed without it.
sidecharacterSide of the game the row belongs to: home (the API's host / home block) or away (guest / visiting block).
assists_percentagedoubleassist rate: the share of teammates' made field goals the player assisted while on the court. A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
assists_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: assist rate: the share of teammates' made field goals the player assisted while on the court. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
assists_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: assist rate: the share of teammates' made field goals the player assisted while on the court.
blocked_percentagedoubleblock rate: blocks as a share of the opponent's two-point attempts while the player is on the court (site definition). A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
blocked_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: block rate: blocks as a share of the opponent's two-point attempts while the player is on the court (site definition). Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
blocked_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: block rate: blocks as a share of the opponent's two-point attempts while the player is on the court (site definition).
cn_aliascharacterPlayer name (Chinese).
field_goals_at_rim_percentagecharacterAt-the-rim ((Chinese text), inside the restricted area (Chinese text)) field goals as the string 'made/attempted'. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
field_goals_at_rim_percentage_rankcharacterUnobserved: null in every sample. When filled: colour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: At-the-rim ((Chinese text), inside the restricted area (Chinese text)) field goals as the string 'made/attempted'.
field_goals_at_rim_percentage_sortcharacterUnobserved: null in every sample. When filled: unformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: At-the-rim ((Chinese text), inside the restricted area (Chinese text)) field goals as the string 'made/attempted'.
field_goals_mid_percentagecharacterMid-range ((Chinese text), two-point shots outside the restricted area) field goals as the string 'made/attempted'. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
field_goals_mid_percentage_rankcharacterUnobserved: null in every sample. When filled: colour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: Mid-range ((Chinese text), two-point shots outside the restricted area) field goals as the string 'made/attempted'.
field_goals_mid_percentage_sortcharacterUnobserved: null in every sample. When filled: unformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: Mid-range ((Chinese text), two-point shots outside the restricted area) field goals as the string 'made/attempted'.
game_startintegerStarter flag: 1 = started the game.
is_colorintegerHighlight flag, 1 on every sampled row (unverified meaning; the site uses it to colour the row).
numbercharacterJersey number as a string.
player_idintegerplayerId (key space: CBA persons, stable across seasons and clubs; 3-9 digits, older players have short ids (393433) and newer ones 100xxxxxx). Joins the player box routes, the season player lists and getPlayersByScheduleId. Not a team id.
player_timesinteger0 on every sampled row; meaning unverified (a games-played slot the game route does not fill).
positioncharacterPosition label (Chinese). Eras differ: coarse (Chinese text) (guard) / (Chinese text) (forward) / (Chinese text) (center) in older seasons, five-way (Chinese text) (point guard) / (Chinese text) (shooting guard) / (Chinese text) (small forward) / (Chinese text) (power forward) / (Chinese text) (center) in newer ones; dual positions are joined with '/' (e.g. (Chinese text)). Label glosses: C = (Chinese text); C/PF = (Chinese text); F = (Chinese text); G = (Chinese text); PF = (Chinese text); PF/C = (Chinese text); PF/SF = (Chinese text); PG = (Chinese text); PG/SG = (Chinese text); SF = (Chinese text); SF/PF = (Chinese text); SF/SG = (Chinese text); SG = (Chinese text); SG/PG = (Chinese text); SG/SF = (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text); (Chinese text).
rebounds_defensive_percentagedoubledefensive-rebound rate: the player's defensive rebounds as a share of the defensive rebounds available while he is on the court (site definition). A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
rebounds_defensive_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: defensive-rebound rate: the player's defensive rebounds as a share of the defensive rebounds available while he is on the court (site definition). Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
rebounds_defensive_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: defensive-rebound rate: the player's defensive rebounds as a share of the defensive rebounds available while he is on the court (site definition).
rebounds_offensive_percentagedoubleoffensive-rebound rate: the player's offensive rebounds as a share of the offensive rebounds available while he is on the court (site definition). A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
rebounds_offensive_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: offensive-rebound rate: the player's offensive rebounds as a share of the offensive rebounds available while he is on the court (site definition). Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
rebounds_offensive_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: offensive-rebound rate: the player's offensive rebounds as a share of the offensive rebounds available while he is on the court (site definition).
steals_percentagedoublesteal rate: steals as a share of the opponent's possessions while the player is on the court (site definition). A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
steals_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: steal rate: steals as a share of the opponent's possessions while the player is on the court (site definition). Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
steals_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: steal rate: steals as a share of the opponent's possessions while the player is on the court (site definition).
team_idintegerteamId (key space: CBA clubs; 5 digits 29115-29140 for the long-standing clubs, 9 digits for newer ones (100074683 = Ningbo); stable across seasons and club renames, but the display name changes with the sponsor: 29128 = 'Zhejiang Guangsha' under many sponsor names, (Chinese text) in 2025-26). Joins getTeam / teamList and the team and player routes. Not a player or schedule id.
true_shooting_percentagedoubletrue-shooting percentage: scoring efficiency counting field goals and free throws, all attempts converted to two-point attempts. A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
true_shooting_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: true-shooting percentage: scoring efficiency counting field goals and free throws, all attempts converted to two-point attempts. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
true_shooting_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: true-shooting percentage: scoring efficiency counting field goals and free throws, all attempts converted to two-point attempts.
turn_sharedouble'possession share': the share of the team's possessions the player ends while on the court. A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
turn_share_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: 'possession share': the share of the team's possessions the player ends while on the court. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
turn_share_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: 'possession share': the share of the team's possessions the player ends while on the court.
turnovers_percentagedoubleturnover rate: the share of the player's possession-ending plays that are turnovers. A FRACTION 0-1 (the API sends a percent string such as '39.4%'; the _sort column holds the same fraction).
turnovers_percentage_rankdoubleColour rank for the metric, a fraction 0-1 (1 = best, inverted for 'bad' statistics such as turnovers) that the site uses to colour the cell (inferred from the sample values; the base population is not documented). Metric: turnover rate: the share of the player's possession-ending plays that are turnovers. Null on every row of some eras: the 2017-18 and 2009-10 samples have no Rank values, and the at-rim / mid-range strings are null in 2009-10 and '0/0' strings in 2025-26.
turnovers_percentage_sortdoubleUnformatted numeric value behind the formatted string of the same metric (a fraction 0-1 for percentages), used by the site to sort the table. Metric: turnover rate: the share of the player's possession-ending plays that are turnovers.
typeintegerSide flag: 0 on every home row, 1 on every visiting row (differs from best_quota, where the visiting side is 2).
up_timeintegerTime on court in SECONDS (1692 = 28:12).

Details

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

 cba_player_advanced(schedule_id = 100105799)