Download a CSV without a key
Choose an endpoint in the website exporter, supply its required filters, inspect the rows, and download a CSV. No personal key to request or test on the website.
Open the data exporterCollege basketball · Developer quick start
Start with the college basketball API or a CSV
Teams, games, statistics, ratings, and play-by-play for your next project. Download a file to explore, or build repeatable requests into your own code.
Basic website CSV export needs no account or API key.
REST API · Bearer authentication
Your first request
Fetch teams with a key from your shell environment.
curl --fail 'https://api.collegebasketballdata.com/teams' \
-H "Authorization: Bearer $CBBD_API_KEY" Set CBBD_API_KEY in your server-side environment. Keep personal keys out of browser code, public repositories, and URLs.
Choose your starting point
A quick download or a repeatable workflow
Use the same basketball data in the format that fits your project.
Connect your own code
Request a personal key, authenticate with a Bearer header, and use the REST documentation to inspect current endpoint parameters and response shapes.
Request a free keyPlan your analysis
Know your season coverage
Season IDs use the ending year: 2026 means 2025–26. API coverage varies by endpoint; check a sample response for your selected season.
| Dataset | Available from |
|---|---|
| Season and box-score statistics | 2002–03 |
| Play-by-play | 2005–06 |
| Shot distribution | 2013–14 |
| Substitutions and lineups | 2023–24 |
Availability and completeness can vary. These API ranges differ from the Starter Pack’s fixed historical snapshot.
Work in your language
Use an existing client library
Follow each package’s current documentation for installation, authentication, and examples.
Python
Bring basketball data into your Python research and analysis workflows with the cbbd wrapper.
Python cbbd packageTypeScript
Use the cbbd API client in your TypeScript applications and integrations.
TypeScript cbbd packageUnderstand your access
Choose what fits your project
A personal API key, website login, downloadable pack, and ongoing Patreon membership are distinct. Football and basketball API use share a quota. Public previews stay free; full Team Metrics and Shooting Profiles require Tier 2+. Tier 1+ chart export requires access to the underlying data.
Prefer a guided notebook workflow?
The Starter Pack pairs a historical data snapshot with guided notebooks and setup documentation.