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