Match Data

At the moment we have ball-by-ball information for 10,107 matches, comprising 688 Test matches, 23 other multi-day matches, 2,226 One-day internationals, 383 other one-day matches, 1,837 T20 internationals, 328 international T20s, 414 Big Bash League matches, 876 Indian Premier League matches, 935 T20 Blast matches, 180 Pakistan Super League matches, 319 Women's Big Bash League matches, 277 Caribbean Premier League matches, 170 Super Smash matches, 64 The Hundred matches, 856 County Championship matches, 9 Women's T20 Challenge matches, 75 Sheffield Shield matches, 26 Charlotte Edwards Cup matches, 53 Rachael Heyhoe Flint Trophy matches, 56 Mzansi Super League matches, and 266 Bangladesh Premier League matches featuring 95 countries, 129 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 Bangladesh vs Pakistan Men’s Test match that finished on the 30th of November, 2021, the India vs New Zealand Men’s Test match that finished on the 29th of November, 2021, and the Otago vs Central Districts New Zealand Cricket Women's Twenty20 match that was played on the 28th of November, 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
10,107 matches - JSON (49.4 MB), YAML (51.4 MB)
Test matches
688 matches - JSON (8.2 MB), YAML (9.2 MB)
Multi-day matches
954 matches - JSON (9.7 MB), YAML (11.2 MB)
One-day internationals
2,226 matches - JSON (10.9 MB), YAML (11.0 MB)
One-day matches
436 matches - JSON (2.0 MB), YAML (2.1 MB)
T20 internationals
1,837 matches - JSON (5.9 MB), YAML (5.6 MB)
Non-official T20 internationals
328 matches - JSON (1.0 MB), YAML (981 KB)
Afghanistan Premier League
23 matches - JSON (78 KB), YAML (76 KB)
Bangladesh Premier League
266 matches - JSON (886 KB), YAML (859 KB)
Big Bash League
414 matches - JSON (1.3 MB), YAML (1.3 MB)
Caribbean Premier League
277 matches - JSON (894 KB), YAML (869 KB)
Charlotte Edwards Cup
26 matches - JSON (83 KB), YAML (81 KB)
County Championship
856 matches - JSON (8.7 MB), YAML (10.0 MB)
Indian Premier League
876 matches - JSON (2.9 MB), YAML (2.7 MB)
Lanka Premier League
23 matches - JSON (76 KB), YAML (73 KB)
Mzansi Super League
56 matches - JSON (178 KB), YAML (174 KB)
Pakistan Super League
180 matches - JSON (593 KB), YAML (563 KB)
Rachael Heyhoe Flint Trophy
53 matches - JSON (263 KB), YAML (276 KB)
Sheffield Shield
75 matches - JSON (829 KB), YAML (974 KB)
Super Smash
170 matches - JSON (534 KB), YAML (526 KB)
T20 Blast
935 matches - JSON (2.9 MB), YAML (2.8 MB)
The Hundred
64 matches - JSON (194 KB), YAML (183 KB)
Women's Big Bash League
319 matches - JSON (989 KB), YAML (974 KB)
Women's T20 Challenge
9 matches - JSON (29 KB), YAML (28 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.