Pull Your First Match Data with StatsBomb Open Data
Use statsbombpy to load free, event-level data for a real match, understand the events table, and summarize it - with the attribution StatsBomb's license requires.
10 tutorials
Soccer
Free event data from StatsBomb plus xG from Understat let you analyse matches like a pro - no paid feed required.
The xG explainers come first — they're the language of everything else. Then the StatsBomb event-data tutorials show you how professional match data is actually structured, and the World Cup scoring tutorial applies one groupby to the complete 2026 tournament. Soccer's bundled data includes every real 2026 World Cup result, so every claim is checkable from the files you downloaded.
No tutorials match that filter.
Group vs Knockout Scoring at the 2026 World Cup, with groupby
Test 'the knockouts tighten up' on the completed 2026 World Cup — all 104 matches — with one pandas groupby: goals per game, both-scored and goalless rates by stage.
Build an xG League Table from Understat Data
Pull a season of Understat shot-level xG via its JSON endpoint, aggregate it to a team table, and compare an xG-based table against the real one.
Draw a Pass Map with mplsoccer
Filter a match's passes from StatsBomb event data and draw them as arrows on a correctly-proportioned pitch using mplsoccer, with StatsBomb attribution.
Build a Match Shot Map with Expected Goals
Plot every shot from a real match on an mplsoccer pitch, sized by its expected-goals value with goals highlighted — the most useful soccer viz there is.
Draw a Player Heatmap from Event Data
Collect every action a player took from StatsBomb event data and turn the locations into a smooth territory heatmap on the pitch, showing where they did their work.
Predict a Scoreline with Poisson: the World Cup Final as a Grid
Fit a Poisson scoreline model to all 104 games of the 2026 World Cup and grid the final: the most likely cell says Spain 1-0 - which is how the final ended.
Pull Live Soccer Results from ESPN's Public Scoreboard API
Pull all 380 Premier League results from ESPN's keyless scoreboard API with two year-form calls: dodge the silent 100-event cap and guard the saved season file.
Is xG Calibrated? Checking a Published Model Against 1,494 Real Shots
Audit StatsBomb xG on 1,494 WC2022 shots: shoot-out rows unmasked, +14 goals at z=1.39, five of six reliability bins hold, Brier skill +19.8%.
Build a Team Pass Network
Combine players' average positions with their pass combinations to draw a pass network - the chart that reveals a team's shape and its most important connections.
