What is Cricsheet?
Cricsheet is Retrosheet for Cricket. We provide ball-by-ball data for Men’s and Women’s Test Matches, One-day internationals, Twenty20 Internationals, some other international T20s, and various club competitions such as all Indian Premier League seasons, and some Big Bash League, T20 Blast, and Pakistan Super League matches.
At the moment we have ball-by-ball information for 7,094 matches, comprising 536 Test matches, 13 other multi-day matches, 1,951 One-day internationals, 303 other one-day matches, 1,414 T20 internationals, 327 international T20s, 786 Indian Premier League matches, 353 Big Bash League matches, 815 T20 Blast matches, 142 Pakistan Super League matches, 210 Women's Big Bash League matches, and 244 Caribbean Premier League matches, featuring 82 countries, 57 club teams, and 3 representative XIs going back as far as 2009 (for women), and 2005 (for men).
The most recent matches added to the site are: the Delhi Capitals vs Rajasthan Royals Indian Premier League match that was played on the 14th of October, 2020, the Chennai Super Kings vs Sunrisers Hyderabad Indian Premier League match that was played on the 13th of October, 2020, and the Guernsey vs Germany Men’s ODM match that was played on the 9th of September, 2017.
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. Below is the listing of the data grouped by types of matches (for any gender), or you can see the full set of downloads, in various formats, on the downloads page.
- All matches
- 7,094 matches, 28.4 MB
- Test matches
- 536 matches, 7.0 MB
- Multi-day matches
- 13 matches, 141 KB
- One-day internationals
- 1,951 matches, 8.8 MB
- One-day matches
- 303 matches, 1.3 MB
- T20 internationals
- 1,414 matches, 3.7 MB
- Non-official T20 internationals
- 327 matches, 823 KB
- Big Bash League matches
- 353 matches, 926 KB
- Indian Premier League matches
- 786 matches, 2.1 MB
- Caribbean Premier League matches
- 244 matches, 644 KB
- T20 Blast matches
- 815 matches, 2.1 MB
- Pakistan Super League matches
- 142 matches, 376 KB
- Women's Big Bash League matches
- 210 matches, 555 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.
The data format
The data is provided in YAML format, a human-readable data format. There are libraries available to parse this in multiple languages. As for the structure of the file, hopefully it is clear enough when you have a look at the data, although a full description of the format is also available.
How can I help?
Spotting errors in the data
The first method of helping would be to spot any errors in the data. Ideally we won’t have any but there’s always the chance and if we can spot the errors we can fix them and write further validation to ensure that further examples don’t slip through.
Helping with missing data
The second method of helping is to help us get ball-by-ball data for our missing games. This doesn’t even have to involve finding the data, it’s possible you know a contact who may be able to shed light on some matches, or you know of someone who has the commentary for a match on tape. Even small bits of info might be enough to put us on the right track.
Blog Entries
We do have an infrequent blog to which we occasionally post about updates to the data format, additions to the site, or random musings. The most recent entry was “Hello again” on the 17th of April, 2019.
Getting in touch
You can contact the project at stephen (at) cricsheet (dot) org. Feel free to get in touch, we love hearing about what people are doing with the data.