ceblpy ¶

The goal of this package is to help people access clean and tidy data from the Canadian Elite Basketball League. It provides a set of loaders that return schedules, box scores, play-by-play, and officials as pandas DataFrames, ready to analyze.

Installation¶

pip install ceblpy

Usage¶

import ceblpy

schedule = ceblpy.load_cebl_schedule(2025)

print(
    schedule[
        [
            "start_time_utc",
            "home_team_name",
            "home_team_score",
            "away_team_name",
            "away_team_score",
        ]
    ]
    .head()
    .to_markdown(index=False)
)

start_time_utc	home_team_name	home_team_score	away_team_name	away_team_score
2025-05-11 22:00:00+00:00	Edmonton Stingers	84	Calgary Surge	86
2025-05-16 01:30:00+00:00	Saskatchewan Rattlers	65	Vancouver Bandits	105
2025-05-16 23:00:00+00:00	Niagara River Lions	98	Calgary Surge	94
2025-05-17 00:30:00+00:00	Winnipeg Sea Bears	92	Edmonton Stingers	89
2025-05-18 19:00:00+00:00	Ottawa BlackJacks	85	Niagara River Lions	87

Every loader takes a season, a list of seasons, or nothing at all for every season available.

ceblpy.load_cebl_player_boxscore(2025)
ceblpy.load_cebl_pbp([2024, 2025])
ceblpy.load_cebl_team_boxscore()

Data is sourced from cebl-data, which updates daily during the season.