Match Data

At the moment we have ball-by-ball information for 9,467 matches, comprising 685 Test matches, 23 other multi-day matches, 2,218 One-day internationals, 375 other one-day matches, 1,719 T20 internationals, 328 international T20s, 876 Indian Premier League matches, 414 Big Bash League matches, 935 T20 Blast matches, 180 Pakistan Super League matches, 273 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, 856 County Championship matches, and 69 Sheffield Shield matches featuring 94 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 Bangladesh vs Papua New Guinea Men’s T20 match that was played on the 21st of October, 2021, the Oman vs Scotland Men’s T20 match that was played on the 21st of October, 2021, and the Malta vs Gibraltar Men’s T20 match that was played on the 21st of October, 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
9,467 matches - JSON (47.1 MB), YAML (49.1 MB)
Test matches
685 matches - JSON (8.2 MB), YAML (9.2 MB)
Multi-day matches
948 matches - JSON (9.7 MB), YAML (11.2 MB)
One-day internationals
2,218 matches - JSON (10.9 MB), YAML (11.0 MB)
One-day matches
375 matches - JSON (1.7 MB), YAML (1.8 MB)
T20 internationals
1,719 matches - JSON (5.5 MB), YAML (5.2 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
876 matches - JSON (2.9 MB), YAML (2.7 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
273 matches - JSON (847 KB), YAML (836 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
856 matches - JSON (8.7 MB), YAML (10.0 MB)
Sheffield Shield
69 matches - JSON (768 KB), YAML (902 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.