pbpstats Documentation

A package to scrape and parse NBA, WNBA and G-League play-by-play data.


  • Adds lineup on floor for all events
  • Adds detailed data for each possession including start time, end time, score margin, how the previous possession ended
  • Shots, rebounds and assists broken down by shot zone
  • Supports both stats.nba.com and data.nba.com endpoints
  • Supports NBA, WNBA and G-League stats
  • All stats on pbpstats.com are derived from these stats
  • Fixes order of events for some common cases in which events are out of order