Coverage Board
Endpoints
Coverage board for all 131 NBA API endpoints used by nbadb
Endpoints
nbadb extracts data from 131 nba_api endpoints, covering every major statistical category in the NBA.
nbadb now inventories the full nba_api runtime surface across stats, static,
and live feeds. Some classes still split into multiple extractor paths or
result-set lanes, so the docs pages below are the quickest way to find the
right family before you drill into source code or tables.
Route by the first reliable key
| If your first handle is... | Start here | Then add | Why this route works |
|---|---|---|---|
game_id for one matchup | Box Scores | Play-by-Play and Other | Keeps the whole game packet together: final line, event order, rotations, officials, and shot detail |
| possession timing or action order | Play-by-Play | Box Scores | Starts at the action log, then adds the postgame totals that explain what the feed produced |
player_id, a player name, or player bio/history | Player Stats | Team Stats and Draft | Builds the player file from lookup surface to team context and pre-NBA background |
team_id or franchise context | Team Stats | Player Stats and League Stats | Starts with the club file, then branches into roster detail and season-wide competition |
| season-wide rankings, leaders, lineups, or matchups | League Stats | Team Stats or Box Scores | Opens with the league desk, then drills down to clubs or single games |
| draft class, board order, or combine testing | Draft | Player Stats | Keeps prospect-era context tied to later NBA careers |
Coverage lanes at a glance
Use the section like a scouting department wall: pick the lane first, then the exact endpoint.
| Lane | Pages in order | Common keys | Best for |
|---|---|---|---|
| Game package | Box Scores → Play-by-Play → Other | game_id | One matchup from final stat line to possession log, rotations, officials, and shot maps |
| Scouting reports | Player Stats ↔ Team Stats ↔ Draft | player_id, team_id, season | Player dossiers, franchise files, and incoming-class context |
| League desk | League Stats | season plus leaderboard filters | Standings, leaders, lineups, play types, and season matchup coverage |
Game package
Start with Box Scores for the
postgame line, move to
Play-by-Play for ordered actions,
and finish on Other for rotations,
officials, and shot-chart detail keyed by the same game_id.
Scouting reports
Use Player Stats, Team Stats, and Draft when the question is about a person, a franchise, or a class rather than one night.
League desk
Go to League Stats when you need the season board: standings, leaders, lineups, play types, and matchup coverage that frame the single-game and single-team pages.
Board directory
| Page | Endpoints | Common entry key | What the page covers | Route cue |
|---|---|---|---|---|
| Box Scores | 10 | game_id | Traditional line, ratings, four factors, hustle, tracking, usage, and matchup tables for one game | Start here when the game is the unit of work |
| Play-by-Play | 3 | game_id | Ordered action log, V2 event codes, V3 action taxonomy, and win probability | Use when sequence matters more than totals |
| Other | 6 | game_id / season | Shot charts, rotations, officials, summary packets, and estimated metrics outside the core boards | Open when the core game packet is missing context |
| Player Stats | 7 | player_id | Player identity, bio, career arc, honors, dashboards, and streak search | Best first stop for a player dossier |
| Team Stats | 6 | team_id | Team identity, roster sheets, front-office context, and franchise history | Best first stop for a club file |
| Draft | 7 | season | Draft order, historical picks, combine measurements, drills, and shooting tests | Use when the question starts before a player's NBA debut |
| League Stats | 8 | season | Standings, leaders, lineups, play types, and season matchups | Use when the question is bigger than one team or one game |
Extraction notes
All endpoint coverage flows through nba_api, with a few operational patterns that matter when you move from docs to extraction code:
- Rate limiting: tiered semaphores by endpoint family
- Retry logic: exponential backoff with jitter
- Proxy rotation: optional proxy list for higher-volume runs
- Incremental updates: watermark-based refresh with configurable lookback windows
Skipped endpoints
Eight endpoints are deliberately excluded because they are deprecated, redundant with better surfaces, or blocked behind authentication requirements.
Next steps from Endpoints
Follow one game from tip to final horn
Open Box Scores first, then layer in Play-by-Play and Other when you need the full single-game packet.
Build a player or team dossier
Jump to Player Stats or Team Stats when the question is about identity, history, and current context rather than one event stream.
Zoom out to season context
Use League Stats for standings, leaders, lineups, and matchup baselines, or Draft for incoming-class and historical board work.
Keep moving
Stay in the same possession
Keep the mental model warm with adjacent pages, section hubs, and search-friendly routes into the same topic cluster.