Skip to content

Basketball Reference NBA Player Stats Scraper

Try for free

NBA player statistics from Basketball-Reference by season or by player: points, rebounds, assists, shooting percentages and minutes per game, plus season totals, advanced, per-36 and per-100 stats, regular season and playoffs. One row per player, team and season.

🏀 Basketball Reference NBA Player Stats Scraper

Get NBA player statistics from Basketball-Reference by season or by player: points, rebounds, assists, shooting percentages, minutes and games per game, plus season totals, advanced, per-36 and per-100 stats if you want them. Regular season and playoffs, every season from 1946-47 to the one being played now. One row per player, team and season. No login needed.

✨ Why use Basketball Reference NBA Player Stats Scraper?

  • 📅 Whole seasons — every player who played in a season, in one run; several seasons or a range such as 2015-2026 at once.
  • 👤 Whole careers — give a player's name or link and get his career season by season.
  • 📊 One merged row — per-game, totals, advanced, per-36 and per-100 stats of a player's season in a single row, not five tables to join.
  • 🔁 Traded players handled — per-team rows plus the combined row, marked clearly, or just one row per player and season.
  • 🏆 Playoffs too — regular season, playoffs or both.
  • ⚡ Fast — a full season of per-game stats in seconds.

🎯 Use cases

  • 📈 Fantasy and betting models — season averages and rates for every player.
  • 🧮 Historical research — compare players and eras across decades.
  • 📰 Sports journalism — leaders, career arcs and team rosters with numbers.
  • 🤖 Machine learning datasets — clean, typed numbers ready for analysis.

🚀 How to use

  1. Enter one or more Seasons (e.g. 2025-26) and/or Players (a name such as Nikola Jokic or a Basketball-Reference player link).
  2. Pick the Season type and any Extra stats (season totals, advanced, per 36 minutes, per 100 possessions).
  3. Optional: keep only the combined row of traded players, or only some teams.
  4. Run it and download the results as JSON, CSV or Excel, or read them through the API.

📥 Input

FieldWhat it does
seasonsSeasons such as 2025-26, 2025-2026 or 2026 (a season is named after the year it ends in), ranges such as 2020-2026 (2020-21 to 2025-26), or current.
playersPlayer names or Basketball-Reference player links. Without seasons: the whole career; with seasons: only those seasons of the career.
seasonTyperegular (default), playoffs or both.
includeExtra stats merged into each row: totals, advanced, per36, per100. Per-game stats are always there.
teamRowsTraded players: all rows (default), combined row only, or per-teams rows only.
teamsOnly players of these teams (LAL, BOS, GSW ...).
maxItemsStop after this many rows (0 = no limit).
{
  "seasons": ["2025-26"],
  "seasonType": "regular",
  "include": ["totals"],
  "teamRows": "all"
}

📤 Output

One row per player, team, season and season type. Numbers are typed; shooting percentages are fractions as the site shows them (0.476 = 47.6%).

FieldDescription
season, seasonEndYear, leagueSeason (2025-26), the year it ends in, and the league (NBA, or BAA/ABA for early seasons).
seasonTypeRegular Season or Playoffs.
playerName, playerId, playerUrlPlayer name, Basketball-Reference player id and page.
team, teamUrlTeam abbreviation. For a player traded during the season, the combined row has 2TM, 3TM ...
isMultiTeamTotal, teamsPlayedFortrue on that combined row, and the teams it covers.
position, agePosition and age (on January 31 of the season, as the site counts it).
gamesPlayed, gamesStartedGames played and started.
minutesPerGame, pointsPerGame, reboundsPerGame, assistsPerGame, stealsPerGame, blocksPerGame, turnoversPerGame, personalFoulsPerGamePer-game averages.
fieldGoalsPerGame, fieldGoalAttemptsPerGame, threePointersPerGame, threePointAttemptsPerGame, twoPointersPerGame, twoPointAttemptsPerGame, freeThrowsPerGame, freeThrowAttemptsPerGame, offensiveReboundsPerGame, defensiveReboundsPerGameShooting and rebounding per game.
fieldGoalPct, threePointPct, twoPointPct, effectiveFieldGoalPct, freeThrowPctShooting percentages.
totalMinutes, totalPoints, totalRebounds, totalAssists, tripleDoubles ...With totals: season totals of every stat.
playerEfficiencyRating, trueShootingPct, usagePct, winShares, winSharesPer48, boxPlusMinus, valueOverReplacement ...With advanced.
pointsPer36, reboundsPer36 ... / pointsPer100, offensiveRating, defensiveRating ...With per36 / per100.
awardsSeason awards and honours as listed (e.g. MVP-4,AS,NBA1).
sourceUrl, scrapedAtThe page the row came from, and when.
{
  "season": "2025-26",
  "seasonEndYear": 2026,
  "league": "NBA",
  "seasonType": "Regular Season",
  "playerName": "Luka Dončić",
  "playerId": "doncilu01",
  "team": "LAL",
  "isMultiTeamTotal": false,
  "teamsPlayedFor": ["LAL"],
  "position": "PG",
  "age": 26,
  "gamesPlayed": 64,
  "gamesStarted": 64,
  "minutesPerGame": 35.8,
  "pointsPerGame": 33.5,
  "reboundsPerGame": 7.7,
  "assistsPerGame": 8.3,
  "fieldGoalPct": 0.476,
  "threePointPct": 0.366,
  "freeThrowPct": 0.78,
  "totalPoints": 2143,
  "awards": "MVP-4,CPOY-8,AS,NBA1",
  "playerUrl": "https://www.basketball-reference.com/players/d/doncilu01.html"
}

⚠️ Limits

  • Stats are what Basketball-Reference shows. Older seasons have empty cells for stats that were not recorded then (three-pointers before 1979-80, steals and blocks before 1973-74 ...).
  • Seasons that have not started yet are skipped; the current season has the games played so far.
  • The site asks crawlers to wait 3 seconds between pages, so each page takes about 3 seconds. A season with all extra stats is 5 pages.
  • A name search picks the best match of the site's search; the status names it (and other candidates). Use the player's link to pick a specific player.

❓ FAQ

Can I get several seasons in one run? Yes: list them, or use a range such as 2016-2026.

Why does a player have three rows in one season? He changed teams. Set Players who changed teams to "Combined row only" for one row per player and season.

Do I need an account? No. All data is public.

💬 Support

Questions or ideas? Write to hello@scrape.ly or open an issue on the Actor's Issues tab.

//From the blog\\

Latest articles

All articles

The internet is full of data.
Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

No credit card. No setup calls.