Cfl-sdk

What's Changed

> ⚠️ **Breaking.** The CFL retired `cfl.ca/standings` and `cfl.ca/league-leaders` on 2026-09-02, and the scrapers had started silently returning empty data (4).

- **Standings on the new API** — `get_standings()` now hits `echo.pims.cfl.ca`; returns `{week, east, west, unified}` with typed int rows instead of scraped strings
- **Leaders on the new API** — `get_leaderboards()` now hits `api.stats.cfl.ca`; returns `{offence, defence, special_teams}` as `list[{category, leaders}]`, plus a new `count` arg (1–25)
- **`get_leaderboards_async()` removed** — use `get_leaderboards()`
- **History back to 2016** — `MIN_SEASON` lowered from 2023
- **Dropped `beautifulsoup4`** — no more HTML scraping

**Full Changelog**: https://github.com/ojadeyemi/cfl-sdk/compare/v0.0.3...v0.1.0

What's Changed

- **2026 season support** — default season updated to 2026 (preseason starts May 12, regular season June 2, Grey Cup Nov 10)
- **Fix stats endpoints** — CFL API permanently renamed `/stats/players` → `/stats/playerrecords` and
`/stats/teams` → `/stats/teamrecords` (308 redirects)
- **Type fixes** — `Season` fields are now optional for historical seasons; `RosterPlayer.birthdate` is now `str | None` to match actual API responses


v.0.0.2
What's New

- Added players, colleges, roster players endpoints
- Added team roster, fixture, and roster summary endpoints
- Fixed `limit` param being ignored in paginated requests
- Updated fixtures with `home_team_id`, `away_team_id`, `venue_id` filters

v.0.0.1

Overview

This is the first pre-release of CFL-SDK, a Python wrapper for the [Canadian Football League (CFL)](https://cfl.ca) API.
The goal of this package is to provide a simple, consistent interface for retrieving CFL data for use in analytics, applications, and research.

See more details in the **[README.md](./README.md)** file.