Match Data

At the moment we have ball-by-ball information for 8,677 matches, comprising 684 Test matches, 23 other multi-day matches, 2,205 One-day internationals, 375 other one-day matches, 1,659 T20 internationals, 328 international T20s, 850 Indian Premier League matches, 414 Big Bash League matches, 935 T20 Blast matches, 180 Pakistan Super League matches, 264 Women's Big Bash League matches, 277 Caribbean Premier League matches, 166 Super Smash matches, 64 The Hundred matches, 9 Women's T20 Challenge matches, 233 County Championship matches, and 11 Sheffield Shield matches featuring 91 countries, 83 club teams, and 3 representative XIs going back as far as 2007 (for women), and 2004 (for men).

The most recent matches added to the site are: the Hampshire vs Lancashire County Championship match that finished on the 24th of September, 2021, the Leicestershire vs Worcestershire County Championship match that finished on the 24th of September, 2021, and the Mumbai Indians vs Kolkata Knight Riders Indian Premier League match that was played on the 23rd of September, 2021.

The data format

The match data is provided in multiple different formats. The current formats are JSON, YAML, XML, and 2 versions in CSV. A detailed description of each format can be found in the Format section.

The data

The data is provided in number of zip files, one of which contains all of the matches, and the others certain sub-sets of matches, such as for type of matches, matches for certain countries, teams, or genders, or periods of time. We also provide (as an experiment) CSV, and XML versions of all matches. A sample is provided here, in both JSON and YAML formats, of some of the downloads available (specifically matches grouped by types of matches, and also domestic competitions, (for any gender), or you can see the full set of downloads, in various formats, on the downloads page.

All matches
8,677 matches - JSON (39.8 MB), YAML (40.7 MB)
Test matches
684 matches - JSON (8.2 MB), YAML (9.2 MB)
Multi-day matches
267 matches - JSON (2.7 MB), YAML (3.1 MB)
One-day internationals
2,205 matches - JSON (10.8 MB), YAML (10.9 MB)
One-day matches
375 matches - JSON (1.7 MB), YAML (1.8 MB)
T20 internationals
1,659 matches - JSON (5.3 MB), YAML (5.0 MB)
Non-official T20 internationals
328 matches - JSON (1.0 MB), YAML (981 KB)
Big Bash League
414 matches - JSON (1.3 MB), YAML (1.3 MB)
Indian Premier League
850 matches - JSON (2.8 MB), YAML (2.6 MB)
Caribbean Premier League
277 matches - JSON (894 KB), YAML (869 KB)
T20 Blast
935 matches - JSON (2.9 MB), YAML (2.8 MB)
Pakistan Super League
180 matches - JSON (593 KB), YAML (563 KB)
Super Smash
166 matches - JSON (521 KB), YAML (513 KB)
Women's Big Bash League
264 matches - JSON (818 KB), YAML (808 KB)
The Hundred
64 matches - JSON (194 KB), YAML (183 KB)
Women's T20 Challenge
9 matches - JSON (29 KB), YAML (28 KB)
County Championship
233 matches - JSON (2.3 MB), YAML (2.7 MB)
Sheffield Shield
11 matches - JSON (117 KB), YAML (137 KB)

Using the data

What could you do with the data? Well that’s up to you really. You could investigate who are the best and worst value players in the IPL. Or see how much difference different non-strikers make to the scoring rate of the people they bat with. Or come up with something completely new that revolutionises cricket like finding the equivalent of DIPS (Defense independent pitching statistics) from baseball.