NBA Player Stats
Every NBA player's season stats from the official NBA stats API (stats.nba.com leaguedashplayerstats): team, age, games played and started, minutes, shooting splits, rebounds, assists, steals, blocks, points and plus-minus, per game, totals or per 36.
585 rows in the dataset
Download the dataset
Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.
DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/nba-player-stats/downloads" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -H "Content-Type: application/json" \ -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \ -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status') [ "$STATUS" != "refreshing" ] && break sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -o dataset.csvAt its current 585 rows, this download costs 6 credits when the data is fresh enough, or 12 credits when it has to be refreshed first.
The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.
Start a run
To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.
curl -X POST "https://api.pandorlabs.com/v1/scrapers/nba-player-stats/runs" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "season": "2025-26", "seasonType": "Regular Season", "perMode": "PerGame", "includeGamesStarted": true } }'A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.
Parameters
Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.
Targeting
seasonstring
Season
NBA season as YYYY-YY. Empty means the latest season with data: the current one once it has tipped off, otherwise the last completed one.
- Default
- none
- Example
2025-26
seasonTypeenum
Season type
- Default
Regular Season- Allowed values
Regular SeasonPlayoffs
perModeenum
Stat mode
- Default
PerGame- Allowed values
PerGameTotalsPer36
Advanced
includeGamesStartedboolean
Resolve games started
Adds one request for the starters split; games started is the games played in that split.
- Default
true
maxPlayersnumber
Max players per run
- Default
1000- Range
- 1 to 2000
requestDelayMsnumber
Delay between requests (ms)
- Default
600- Range
- 300 to 30000
Input as JSON Schema
The same schema the API validates against. Use it as a tool input schema or to generate a typed client.
{ "type": "object", "additionalProperties": false, "properties": { "season": { "type": "string", "maxLength": 2000, "title": "Season", "description": "NBA season as YYYY-YY. Empty means the latest season with data: the current one once it has tipped off, otherwise the last completed one.", "examples": [ "2025-26" ] }, "seasonType": { "type": "string", "enum": [ "Regular Season", "Playoffs" ], "title": "Season type", "default": "Regular Season" }, "perMode": { "type": "string", "enum": [ "PerGame", "Totals", "Per36" ], "title": "Stat mode", "default": "PerGame" }, "includeGamesStarted": { "type": "boolean", "title": "Resolve games started", "description": "Adds one request for the starters split; games started is the games played in that split.", "default": true }, "maxPlayers": { "type": "number", "minimum": 1, "maximum": 2000, "title": "Max players per run", "default": 1000 }, "requestDelayMs": { "type": "number", "minimum": 300, "maximum": 30000, "title": "Delay between requests (ms)", "default": 600 } }}Run, poll, read rows
The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).
RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/nba-player-stats/runs" \ -H "Authorization: Bearer $PANDORLABS_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "season": "2025-26", "seasonType": "Regular Season", "perMode": "PerGame", "includeGamesStarted": true } }' | jq -r '.id')while true; do RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \ -H "Authorization: Bearer $PANDORLABS_KEY") STATUS=$(echo "$RUN" | jq -r '.status') BILLING=$(echo "$RUN" | jq -r '.billing.status') case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \ -H "Authorization: Bearer $PANDORLABS_KEY"See the API reference for pagination, cancelling and listing runs.
Output fields
Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.
| Field | Type | Coverage |
|---|---|---|
| age | number | 100% |
| assists | number | 100% |
| blocks | number | 100% |
| blocks_against | number | 100% |
| defensive_rebounds | number | 100% |
| double_doubles | number | 100% |
| field_goal_pct | number | 100% |
| field_goals_attempted | number | 100% |
| field_goals_made | number | 100% |
| fouls_drawn | number | 100% |
| free_throw_pct | number | 100% |
| free_throws_attempted | number | 100% |
| free_throws_made | number | 100% |
| games_played | number | 100% |
| games_started | number | 99% |
| losses | number | 100% |
| minutes | number | 100% |
| nba_fantasy_points | number | 100% |
| nickname | string | 100% |
| offensive_rebounds | number | 100% |
| per_mode | string | 100% |
| personal_fouls | number | 100% |
| player_id | string | 100% |
| player_name | string | 100% |
| plus_minus | number | 100% |
| points | number | 100% |
| points_rank | number | 100% |
| rebounds | number | 100% |
| season | string | 100% |
| season_type | string | 100% |
| steals | number | 100% |
| team_abbreviation | string | 100% |
| team_id | string | 100% |
| three_point_pct | number | 100% |
| three_pointers_attempted | number | 100% |
| three_pointers_made | number | 100% |
| triple_doubles | number | 100% |
| turnovers | number | 100% |
| win_pct | number | 100% |
| wins | number | 100% |
| created_at | date | 100% |
| updated_at | date | 100% |
| _id | string | 100% |
