Get CEBL Player Statistics

Player statistic table (totals or per game) for a season or all-time; filter by competition, segment or team.

Endpoint: GET https://api.data.cebl.ca/players/statistics/aggregated/

Usage

cebl_player_stats(
  mode = "PER_GAME",
  season = NULL,
  competition = NULL,
  segment = NULL,
  team_id = NULL
)

Arguments

mode

(default "PER_GAME") TOTALS (sums over the selected games) or PER_GAME (per-game averages); the API requires one.

season

(default NULL) Season: the calendar year (May to August) = the sdv END year. NULL = every season combined (the Stats Hub's All-Time). An unknown year answers hoopR_no_data.

competition

(default NULL) REGULAR (regular season) or FINALS (the playoffs). NULL = both.

segment

(default NULL) Game subset: HOME, AWAY, L7D (last 7 days), L5G (last 5 games), L10G (last 10 games), MAY, JUNE, JULY or AUGUST. NULL = all games. Values from the CEBL Stats Hub bundle.

team_id

(default NULL) CEBL team id (team_id in cebl_teams): limits the rows to that team; the rows echo it.

Value

A hoopR_data tibble: Player statistic table (totals or per game) for a season or all-time; filter by competition, segment or team. An empty valid answer raises hoopR_no_data; the columns are always these, in this order (sportsdataverse-py cebl_player_stats):

col_name	type	description
season	integer	Season: the calendar year it is played in (May to August) = the sdv END year (2025). Taken from the request (the body does not echo it); null for the all-time table and for a bare body.
mode	character	Table mode of the request: TOTALS (sums over the selected games) or PER_GAME (per-game averages); the body does not echo it.
competition	character	Competition filter of the request: REGULAR or FINALS; null when both were asked. The body does not echo it.
segment	character	Game-subset filter of the request (HOME, AWAY, L5G, MAY ...); null for all games. The body does not echo it.
player_id	integer	CEBL player id (its own key space). Joins /players/{player_id}/ and id in the other player rows. Genius LiveStats data.json carries no person id, so the join to Genius play-by-play is by name, team and jersey number (unverified).
full_name	character	Player's full name.
nationality	character	Nationality: an upper-case English country name ('CANADA', 'UNITED STATES', 'SOUTH SUDAN'); null when unknown.
team_id	integer	CEBL team id (its own key space; not a Genius id). Joins /teams/ id, the games' home_team_id / away_team_id, team_id in player rows and the team_id / vs_team_id params. A relocated or renamed franchise has a second id: the Stats Hub groups 15+56 (Saskatchewan Rattlers, Saskatoon Mamba), 17+53 (Calgary Surge, Guelph Nighthawks), 19+55 (Brampton, Hamilton Honey Badgers) and 16+54 (Vancouver, Fraser Valley Bandits).
team_name_en	character	Full English name of the player's team.
team_short_name_en	character	Short English name (city) of the player's team.
team_name_fr	character	Full French name of the player's team.
team_short_name_fr	character	Short French name (city) of the player's team.
team_logo_url	character	Logo URL (icon with the name) of the player's team.
played	integer	Games played (a count in both modes).
started	integer	Games started (a count in both modes).
minutes	double	Minutes played, decimal minutes (not mm:ss). TOTALS: the sum ('1281.7'); PER_GAME: the per-game average ('29.5'). A string.
points	double	Points scored. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
field_goals_made	double	Field goals made (2- and 3-pointers). TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
field_goals_attempted	double	Field goals attempted (2- and 3-pointers). TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
field_goal_percentage	double	Field-goal percentage, 0-100 with 1 decimal ('44.7'): made / attempted over the selected games (the same in both modes). A string.
three_points_made	double	Three-pointers made. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
three_points_attempted	double	Three-pointers attempted. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
three_point_percentage	double	Three-point percentage, 0-100 with 1 decimal ('44.7'): made / attempted over the selected games (the same in both modes). A string.
free_throws_made	double	Free throws made. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
free_throws_attempted	double	Free throws attempted. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
free_throw_percentage	double	Free-throw percentage, 0-100 with 1 decimal ('44.7'): made / attempted over the selected games (the same in both modes). A string.
offensive_rebounds	double	Offensive rebounds. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
defensive_rebounds	double	Defensive rebounds. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
rebounds	double	Total rebounds (offensive + defensive). TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
assists	double	Assists. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
turn_overs	double	Turnovers. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
steals	double	Steals. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
blocks	double	Shots blocked. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
fouls	double	Personal fouls committed. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
double_doubles	double	Double-doubles: games with 10 or more in two of points, rebounds, assists, steals, blocks. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
triple_doubles	double	Triple-doubles: games with 10 or more in three of those. TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').
target_scores	double	Target-score baskets: games in which the player made the basket that reached the Elam Ending target score and ended the game (CEBL has used the Elam Ending since 2020, so 2019 is 0). TOTALS: the sum over the selected games; PER_GAME: the per-game average, 1 decimal. A decimal sent as a string ('2256.0', '12.7').

Details

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

See also

Other CEBL Functions: cebl_games(), cebl_news(), cebl_player(), cebl_player_gamelog(), cebl_player_leaders(), cebl_player_seasons(), cebl_roster(), cebl_seasons(), cebl_standings(), cebl_team_stats(), cebl_teams()

Examples

# \donttest{
  try(cebl_player_stats(mode = "PER_GAME", season = 2025))
#> ── CEBL Player Statistics from the CEBL Stats API ─────────────── hoopR 3.2.0 ──
#> ℹ Data updated: 2026-10-31 21:27:57 UTC
#> # A tibble: 175 × 37
#>    season mode     competition segment player_id full_name   nationality team_id
#>     <int> <chr>    <chr>       <chr>       <int> <chr>       <chr>         <int>
#>  1   2025 PER_GAME NA          NA              7 Cat Barber  UNITED STA…      22
#>  2   2025 PER_GAME NA          NA              8 Jalen Harr… UNITED STA…      24
#>  3   2025 PER_GAME NA          NA             11 Danilo Dju… CANADA           22
#>  4   2025 PER_GAME NA          NA             14 Elijah Luf… CANADA           14
#>  5   2025 PER_GAME NA          NA             15 David Walk… CANADA           20
#>  6   2025 PER_GAME NA          NA             24 Alain Louis CANADA           21
#>  7   2025 PER_GAME NA          NA             25 Ahmed Hill  UNITED STA…      14
#>  8   2025 PER_GAME NA          NA             27 Christian … CANADA           20
#>  9   2025 PER_GAME NA          NA             29 Elijah Ife… CANADA           15
#> 10   2025 PER_GAME NA          NA             44 Deng Adel   SOUTH SUDAN      20
#> # ℹ 165 more rows
#> # ℹ 29 more variables: team_name_en <chr>, team_short_name_en <chr>,
#> #   team_name_fr <chr>, team_short_name_fr <chr>, team_logo_url <chr>,
#> #   played <int>, started <int>, minutes <dbl>, points <dbl>,
#> #   field_goals_made <dbl>, field_goals_attempted <dbl>,
#> #   field_goal_percentage <dbl>, three_points_made <dbl>,
#> #   three_points_attempted <dbl>, three_point_percentage <dbl>, …
# }