Coverage Board
Player Stats Endpoints
Player scouting report endpoints for bios, career arcs, awards, and dashboards
Player Stats Endpoints
Seven endpoints build the player scouting report.
Primary route: Start with a lookup surface if you only know the name, then move into
player_idendpoints for the actual dossier.Pair this board with Team Stats to place players inside franchise context and Draft for pre-NBA background.
Quick route
| If you need... | Use | Why it is the fastest route |
|---|---|---|
| the full player universe | CommonAllPlayers | Fastest directory for current and historical NBA players |
| bio plus current-season snapshot in one row set | PlayerIndex | Good first stop when you want identity and lightweight production together |
| one player's core bio and headline context | CommonPlayerInfo | Best single dossier opener once you have player_id |
| season-by-season and career totals | PlayerCareerStats | Best historical arc for one player across regular season and playoffs |
| awards and honors | PlayerAwards | Clean honors timeline keyed by player_id |
| a year-over-year dashboard | PlayerDashboardByYearOverYear | Quick way to compare one season against the surrounding seasons |
| streak hunting with filters | PlayerGameStreakFinder | Best route when the question is “find games like this” |
Lookup surfaces
| Endpoint | Result sets | Key columns / signals | Route cue |
|---|---|---|---|
CommonAllPlayers | CommonAllPlayers | person_id, display_first_last, roster_status, from_year, to_year, team_id | Start here when you need the canonical player list or a fast ID lookup |
PlayerIndex | PlayerIndex | person_id, player_first_name, player_last_name, position, height, weight, college, country, draft_year, draft_round, draft_number, pts, reb, ast | Best first page when you want a searchable player directory with lightweight stat context |
Core player dossier
| Endpoint | Parameters | Result sets | Route cue |
|---|---|---|---|
CommonPlayerInfo | player_id (required) | CommonPlayerInfo, PlayerHeadlineStats, AvailableSeasons | Open this first once you have a player ID; it anchors bio, position, jersey, draft slot, and available seasons |
PlayerCareerStats | player_id (required) | SeasonTotalsRegularSeason, SeasonTotalsPostSeason, SeasonTotalsAllStarSeason, CareerTotalsRegularSeason, CareerTotalsPostSeason | Use when you need the actual season-by-season arc and career rollup |
PlayerAwards | player_id (required) | PlayerAwards | Add when awards, All-NBA history, or honors context matters |
Dashboards and search tools
| Endpoint | Parameters | Result sets | Key columns / signals | Route cue |
|---|---|---|---|---|
PlayerDashboardByYearOverYear | player_id (required), season (required) | OverallPlayerDashboard, ByYearPlayerDashboard | year-over-year comparison lanes for the selected season | Use when one season needs to be benchmarked against the player's nearby history |
PlayerGameStreakFinder | various filter criteria | PlayerGameStreakFinderResults | streak-criteria match output | Use when the prompt starts with thresholds, streak length, or repeating game patterns |
Route cues
- Use lookup surfaces first when you are still resolving identity or IDs.
- Use
CommonPlayerInfo+PlayerCareerStatsas the default two-endpoint stack for a player file. - Add awards, dashboard, or streak endpoints only when the question clearly needs them.
Next steps from player scouting
Place the player inside a club file
Continue to Team Stats when a player dossier needs roster context, front-office detail, or franchise history around the same people and seasons.
Trace the pre-NBA background
Open Draft to connect current player records back to class order, combine testing, and prospect-era measurements.
Benchmark against the whole league
Jump to League Stats when one player's dashboard needs leaderboards, lineup context, or season-wide comparison sets.
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.