season_player_statsnba.season_player_stats

Season totals for each NBA player — scoring, rebounding, assists, steals, blocks, shooting splits, advanced metrics, plus-minus, and minutes played. Regular-season games only; playoff, play-in, and preseason totals are not included. Players traded mid-season have one merged row (no per-team split).

Full field reference (49 columns) → Data Dictionary Query in GraphQL →

GET/api/v1/nba/season_player_statsList season_player_stats for NBA

Requires one of: season_id or player_id — requests satisfying none of these return 400.

Parameters

season_idquerybigintoptional

Filter to a single season. Defaults to the current season.

player_idquerybigintoptional

Filter to a single player.

limitqueryintegeroptionaldefault 50

Page size. Defaults to 50; max 5000.

from_idquerybigintoptional

Return rows with id strictly greater than this value; page using the previous response's `next_from_id`. Omit on the first page.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/season_player_stats?season_id=2026'

Responses

200season_player_stats rows matching the declared filter set, wrapped in { season_player_stats, limit, next_from_id }. next_from_id is the last row's id on a full page — pass it back via ?from_id= to walk the full result; null marks the terminal page.application/jsonshow example ▸

400No declared filter set was satisfied — response body matches MissingRequiredFiltersError; pick one combo from the accepted-sets hint and resend.application/json

Response Schema(49 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 176
season_id	bigint		— e.g. 2021
assist_percentage	decimal	—	— e.g. 0.0000
assist_ratio	decimal	—	— e.g. 0.0000
assist_to_turnover	decimal	—	— e.g. 0.0000
assists	integer	—	— e.g. 0
avg_dribbles_per_touch	decimal	—	— e.g. 0.0000
avg_seconds_per_touch	decimal	—	— e.g. 1.6400
blocks	integer	—	— e.g. 0
defensive_rating	decimal	—	— e.g. 111.1000
defensive_rebound_percentage	decimal	—	— e.g. 0.0000
defensive_rebounds	integer	—	— e.g. 0
double_doubles	integer	—	— e.g. 0
effective_field_goal_percentage	decimal	—	— e.g. 0.5000
field_goal_percentage	decimal	—	— e.g. 0.5000
field_goals_attempted	integer	—	— e.g. 6
field_goals_made	integer	—	— e.g. 0
fouls	integer	—	— e.g. 0
free_throw_percentage	decimal	—	— e.g. 0.0000
free_throws_attempted	integer	—	— e.g. 0
free_throws_made	integer	—	— e.g. 0
front_court_touches	integer	—	— e.g. 0
games_played	integer	—	— e.g. 68
losses	integer	—	— e.g. 1
minutes	decimal	—	— e.g. 1297.0367
net_rating	decimal	—	— e.g. 0.3000
offensive_rating	decimal	—	— e.g. 113.9000
offensive_rebound_percentage	decimal	—	— e.g. 0.0000
offensive_rebounds	integer	—	— e.g. 0
pace	decimal	—	— e.g. 100.6900
player_impact_estimate	decimal	—	— e.g. 0.0730
plus_minus	integer	—	— e.g. -7
possessions	integer	—	— e.g. 41
pts	integer	—	— e.g. 0
rebound_percentage	decimal	—	— e.g. 0.0620
rebounds	integer	—	— e.g. 0
steals	integer	—	— e.g. 0
three_point_percentage	decimal	—	— e.g. 0.0000
three_pointers_attempted	integer	—	— e.g. 0
three_pointers_made	integer	—	— e.g. 0
time_of_possession	decimal	—	— e.g. 0.0000
touches	integer	—	— e.g. 0
triple_doubles	integer	—	— e.g. 0
true_shooting_percentage	decimal	—	— e.g. 0.0000
turnover_percentage	decimal	—	— e.g. 0.0000
turnovers	integer	—	— e.g. 0
usage_percentage	decimal	—	— e.g. 0.1360
wins	integer	—	— e.g. 1

GET/api/v1/nba/season_player_stats/{id}Get a single season_player_stat by id

Parameters

idpathbigintrequired

Primary key (id) of the season_player_stat row.

Restores the documented defaults (trial keys only accept the unchanged defaults).

Request

curl -sS --compressed \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://api.stat-api.com/api/v1/nba/season_player_stats/{pk_value}'

Responses

200Single season_player_stat row.application/jsonshow example ▸

404Row not found.

Response Schema(49 fields)show schema ▸

Field	Type	References	Description
idkey	bigint	—	Primary Key
player_id	bigint		— e.g. 176
season_id	bigint		— e.g. 2021
assist_percentage	decimal	—	— e.g. 0.0000
assist_ratio	decimal	—	— e.g. 0.0000
assist_to_turnover	decimal	—	— e.g. 0.0000
assists	integer	—	— e.g. 0
avg_dribbles_per_touch	decimal	—	— e.g. 0.0000
avg_seconds_per_touch	decimal	—	— e.g. 1.6400
blocks	integer	—	— e.g. 0
defensive_rating	decimal	—	— e.g. 111.1000
defensive_rebound_percentage	decimal	—	— e.g. 0.0000
defensive_rebounds	integer	—	— e.g. 0
double_doubles	integer	—	— e.g. 0
effective_field_goal_percentage	decimal	—	— e.g. 0.5000
field_goal_percentage	decimal	—	— e.g. 0.5000
field_goals_attempted	integer	—	— e.g. 6
field_goals_made	integer	—	— e.g. 0
fouls	integer	—	— e.g. 0
free_throw_percentage	decimal	—	— e.g. 0.0000
free_throws_attempted	integer	—	— e.g. 0
free_throws_made	integer	—	— e.g. 0
front_court_touches	integer	—	— e.g. 0
games_played	integer	—	— e.g. 68
losses	integer	—	— e.g. 1
minutes	decimal	—	— e.g. 1297.0367
net_rating	decimal	—	— e.g. 0.3000
offensive_rating	decimal	—	— e.g. 113.9000
offensive_rebound_percentage	decimal	—	— e.g. 0.0000
offensive_rebounds	integer	—	— e.g. 0
pace	decimal	—	— e.g. 100.6900
player_impact_estimate	decimal	—	— e.g. 0.0730
plus_minus	integer	—	— e.g. -7
possessions	integer	—	— e.g. 41
pts	integer	—	— e.g. 0
rebound_percentage	decimal	—	— e.g. 0.0620
rebounds	integer	—	— e.g. 0
steals	integer	—	— e.g. 0
three_point_percentage	decimal	—	— e.g. 0.0000
three_pointers_attempted	integer	—	— e.g. 0
three_pointers_made	integer	—	— e.g. 0
time_of_possession	decimal	—	— e.g. 0.0000
touches	integer	—	— e.g. 0
triple_doubles	integer	—	— e.g. 0
true_shooting_percentage	decimal	—	— e.g. 0.0000
turnover_percentage	decimal	—	— e.g. 0.0000
turnovers	integer	—	— e.g. 0
usage_percentage	decimal	—	— e.g. 0.1360
wins	integer	—	— e.g. 1