Cricsheet Cricket Match Data Scraper

Cricsheet Cricket Match Data Scraper

Scrape Cricsheet cricket match data as match summaries or per-ball deliveries, filtered by league, team, season, and venue. Every record includes match metadata, teams, and outcomes. No API key or registration. Export to CSV, JSON, Excel, or XML.

Cricsheet is the open-source archive of professional cricket match data, but downloading and parsing its YAML files by hand is slow. This Actor reads the public match feeds directly, filters by format, team, season, gender, or venue, and returns each match or delivery in one flat row. It works for Tests, ODIs, T20Is, IPL, BBL, PSL, The Hundred, and more.

Who uses it	What they scrape Cricsheet for
Cricket analysts	Build player-vs-player matchup models from ball-by-ball data.
Fantasy league players	Pull recent match stats to inform daily fantasy picks.
Sports journalists	Gather match summaries and scorecards for a tournament recap.
Data science students	Get a clean dataset of international or T20 league matches for a project.

What it does

This Actor collects Cricsheet cricket match data by league or format and returns each match as a summary row or each ball as a delivery row.

• 📋 Match summaries: one row per match with teams, date, venue, toss, and result.
• 🏏 Per-ball deliveries: one row per delivery with batter, bowler, runs, extras, and wicket details.
• 🏆 League presets: IPL, BBL, PSL, CPL, The Hundred, SA20, ILT20, WPL, WBBL, and World Cups.
• 🔍 Team and venue filters: substring match on team name or venue to narrow results before download.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Cricsheet data

📊 Build a batting performance dashboard.

A cricket analyst runs the Actor in deliveries mode for an IPL season, filters by a specific team, and loads the CSV into a BI tool to chart run rates and wicket patterns.

🏏 Prepare a fantasy league cheat sheet.

A fantasy player scrapes the most recent T20I matches in deliveries mode, filters by the players on their watchlist, and computes recent strike rates and economy rates.

📰 Write a tournament preview article.

A journalist runs the Actor in matches mode for a World Cup, filters by the two finalist teams, and pulls head-to-head results and venue stats for the story.

🎓 Complete a university data science assignment.

A student scrapes all Test matches from a season in deliveries mode, filters by gender, and uses the flat CSV to train a win-probability model in Python.

Why choose this scraper

	What you get
No parsing needed	Cricsheet's raw YAML is flattened into clean rows ready for analysis.
Two output modes	Choose match summaries for overviews or per-ball deliveries for granular stats.
League shortcuts	Jump straight to IPL, BBL, The Hundred, and other T20 leagues without manual setup.
Flexible filters	Filter by team, season, gender, and venue before the run to keep datasets small.

How it compares

This Actor returns flat rows from Cricsheet in two modes, while the competitor focuses only on raw YAML downloads and per-ball parsing.

Feature	ParseForge	Cricsheet Ball-by-Ball Match Data Scraper
Match summaries mode	Yes	Not listed
Per-ball deliveries mode	Yes	Yes
Team, season, gender, venue filters	Yes	Not listed
League presets (IPL, BBL, etc.)	Yes	Not listed
Flat CSV/JSON/Excel export	Yes	Not listed

Configure the run

Drive the Actor from a match type or league preset, then narrow results with team, season, gender, and venue filters so only relevant matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "mode": "matches",
  "matchType": "recently_added_30",
  "maxItems": 10
}

A larger pull:

{
  "mode": "matches",
  "matchType": "recently_added_30",
  "maxItems": 200
}

Pricing

Pay-per-result: $0.04 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$4.00
1,000 results	$40.00
10,000 results	$400.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the Cricsheet Cricket Match Data Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Cricsheet through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/cricsheet-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check your filters. A team, season, or venue filter that is too specific can return zero matches. Try clearing the filters and running with only a match type selected.

Why does the run stop at 10 items?

Free Apify accounts are limited to 10 items per run as a preview. Upgrade to a paid plan to increase the maximum matches limit.

Why are some deliveries missing data?

Cricsheet's archive may have incomplete data for older or less-covered matches. Missing fields will appear as empty values in your dataset.

How do I get data for a specific season like 2023/24?

Enter the season exactly as it appears in Cricsheet, such as '2023/24' or '2024'. The filter does a substring match, so '2023' will also catch '2023/24'.

FAQ

Question	Answer
What is Cricsheet?	Cricsheet is an open-source project that archives ball-by-ball data for professional cricket matches across international and domestic leagues. This Actor reads its public feeds directly.
What is the difference between matches mode and deliveries mode?	Matches mode returns one row per match with summary info like teams, date, venue, toss, and result. Deliveries mode returns one row per ball with batter, bowler, runs, extras, and wicket details.
Which leagues and formats are supported?	Tests, ODIs, T20Is, IPL, BBL, PSL, CPL, The Hundred, WBBL, WPL, SA20, ILT20, other multi-day and one-day matches, and World Cups for both men and women.
Can I filter by a specific team?	Yes. The Team Filter accepts a case-insensitive substring, so 'India' or 'Mumbai' will match any match where that team played.
How do I get only women's matches?	Set the Gender Filter to 'Female'. You can also combine it with a league like WBBL or WPL for women's domestic T20 data.
Can I filter by venue?	Yes. The Venue Filter does a case-insensitive substring match, so 'Eden' will return matches at Eden Gardens, Eden Park, and any other venue containing 'Eden'.
How many matches can I scrape in one run?	Free users are limited to 10 items as a preview. Paid users can set a maximum up to 1,000,000 matches.
Does this Actor require an API key?	No. It reads Cricsheet's public data feeds directly. No registration, API key, or authentication is needed.
What export formats are available?	You can export your dataset to CSV, JSON, Excel, or XML from the Apify platform.
How recent is the data?	The 'Recently added' option returns the most recent 30 matches across all formats. League-specific options include matches up to the latest Cricsheet update.

Related actors

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Cricsheet. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.