🏏 Cricsheet Cricket Match Data Scraper

🚀 Export cricket match data in seconds. Pull match summaries or per-ball delivery records for 15,000+ matches across Test, ODI, T20I, IPL, BBL, PSL, CPL, The Hundred, WPL, and World Cups. No sign-up needed.

🕒 Last updated: 2026-05-15 · 📊 28 fields per match · 🏏 15,000+ matches · 🌍 16 formats and leagues · 📅 Decades of historical archive

The Cricsheet Scraper pulls structured match records from Cricsheet, the open-source cricket data archive used by analysts, fantasy-cricket developers, and academics worldwide. Two modes share a single input form: matches (one row per match with summary plus aggregate stats) or deliveries (one row per ball with batter, bowler, runs, and wicket info, the format that makes Cricsheet uniquely valuable).

Coverage spans 15,000+ matches across 16 formats and leagues: Tests, ODIs, T20Is, IPL, BBL, PSL, CPL, The Hundred, WBBL, WPL, SA20, ILT20, World Cups (men and women), other multi-day, and other one-day cricket. Filter by team, season, gender, or venue and download as CSV, Excel, JSON, or XML in under three minutes.

🎯 Target Audience	💡 Primary Use Cases
Fantasy-cricket developers, sports analysts, betting modellers, academic researchers, broadcasters, app developers, podcast statisticians	Player performance modelling, ball-by-ball replay generators, T20 win-probability models, fantasy scoring engines, historical archive apps

---

📋 What the Cricsheet Scraper does

Six filtering inputs combine in a single run:

• 📊 Output mode. Match summaries (one row per match) or per-ball deliveries (one row per ball, the headline value of Cricsheet).
• 🏆 Match type / league. Tests, ODIs, T20Is, IPL, BBL, PSL, CPL, The Hundred, WBBL, WPL, SA20, ILT20, multi-day, one-day, World Cups, or "recently added" for the latest 30.
• 🏏 Team filter. Case-insensitive substring match on team name.
• 📅 Season filter. Restrict to a specific season or year (e.g. 2024, 2023/24).
• 🚹 Gender filter. Men's, women's, or both.
• 🏟️ Venue filter. Case-insensitive substring match on venue (e.g. Eden Gardens).

Match-summary records carry teams, winner, win margin (runs/wickets/innings), result, toss winner and decision, player of the match, total runs scored across innings, total wickets, and run rate per over. Per-ball delivery records carry batter, bowler, non-striker, runs scored, extras type, boundary flag, wicket flag, dismissal kind, and player out.

💡 Why it matters: Cricsheet's per-ball data unlocks ball-by-ball win-probability models, fantasy scoring engines, and replay generators. Building this pipeline yourself means downloading per-format archives, unpacking JSONs, and writing per-format parsers. This Actor handles it all on every run.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded ball-by-ball dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.
mode	string	"matches"	matches = one row per match. deliveries = one row per ball.
matchType	string	"recently_added_30"	Cricket format or league (Tests, ODIs, T20Is, IPL, BBL, PSL, CPL, The Hundred, WBBL, WPL, SA20, ILT20, World Cups, or recently added).
team	string	""	Team name substring filter.
season	string	""	Season or year filter (e.g. 2024, 2023/24).
gender	string	""	One of empty (both), male, female.
venue	string	""	Venue name substring filter.

Example: 50 most-recent IPL match summaries.

{
    "maxItems": 50,
    "mode": "matches",
    "matchType": "ipl"
}

Example: every ball bowled by India in 2024 World Cup matches.

{
    "maxItems": 5000,
    "mode": "deliveries",
    "matchType": "wc",
    "team": "India",
    "season": "2024"
}

⚠️ Good to Know: the deliveries mode emits one row per ball (typically 240 rows per T20 innings, up to 540 per ODI innings, several thousand for a Test). Set maxItems accordingly. The Cricsheet archive is contributor-driven, so very recent fixtures may take a few days to appear. Older matches may have varying levels of detail.

---

📊 Output

Match-summary records contain 28 fields. Per-ball delivery records contain 17 fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Match summary schema

Field	Type	Example
🆔 match_id	string	"1426294"
📅 match_date	string | null	"2024-05-26"
📅 match_dates	array	["2024-05-26"]
🏆 match_type	string | null	"T20"
🏷️ match_type_number	number | null	74
🚹 gender	string | null	"male"
👥 team_type	string | null	"club"
🏟️ venue	string | null	"M Chinnaswamy Stadium"
🏙️ city	string | null	"Bengaluru"
🏆 event_name	string | null	"Indian Premier League"
🔢 event_match_number	number | null	74
🎫 event_group	string | null	null
📅 season	string | null	"2024"
⚪ overs	number | null	20
⚪ balls_per_over	number | null	6
👥 teams	array	["Kolkata Knight Riders","Sunrisers Hyderabad"]
🥇 winner	string | null	"Kolkata Knight Riders"
🏃 win_by_runs	number | null	null
🎯 win_by_wickets	number | null	8
🎲 toss_winner	string | null	"Sunrisers Hyderabad"
🪙 toss_decision	string | null	"bat"
🏅 player_of_match	array	["MA Starc"]
🎯 totalRunsScored	number	227
🎯 totalWickets	number	9
📊 runRatePerOver	number | null	7.566
🔗 url	string	"https://cricsheet.org/downloads/..."
🕒 scrapedAt	ISO 8601	"2026-05-15T00:00:00.000Z"

🧾 Per-ball delivery schema

Field	Type	Example
🆔 match_id	string	"1426294"
🔢 innings	number	1
🏏 batting_team	string	"Kolkata Knight Riders"
⚪ over	number	0
⚪ ball	number	1
🏏 batter	string	"SP Narine"
🎯 bowler	string	"B Kumar"
🏏 non_striker	string	"PD Salt"
🎯 runs_batter	number	4
🎯 runs_extras	number	0
🎯 runs_total	number	4
🚩 extras_type	string | null	null
🎯 isBoundary	boolean	true
🎯 isWicket	boolean	false
❌ wicket_kind	string | null	null
❌ player_out	string | null	null
🔗 url	string	"https://cricsheet.org/downloads/..."

📦 Sample records

---

✨ Why choose this Actor

	Capability
🏏	Per-ball detail. Deliveries mode emits one row per ball with batter, bowler, runs, extras, and wicket info. The format that makes Cricsheet unique.
🏆	16 formats and leagues. Tests, ODIs, T20Is, IPL, BBL, PSL, CPL, The Hundred, WBBL, WPL, SA20, ILT20, multi-day, one-day, World Cups.
🚹	Men's and women's cricket. Full coverage of both with a single gender filter.
📊	Pre-computed aggregates. Match summaries include total runs, wickets, and run rate per over so you skip the per-ball roll-up.
🥇	Outcomes and tosses. Winner, win margin, toss winner, toss decision, and player of the match all structured.
⚡	Fast. Hundreds of match summaries in under a minute, multi-thousand delivery rows in seconds.
🚫	No authentication. Public Cricsheet open archive. No login or registration needed.

🏏 Cricsheet is the most-cited open cricket dataset and is used by fantasy platforms, broadcasters, and academic studies worldwide.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ Cricsheet Scraper (this Actor)	$5 free credit, then pay-per-use	15,000+ matches, per-ball detail	Live per run	format, team, season, gender, venue	⚡ 2 min
Manual Cricsheet downloads	Free	All formats	Manual	Manual unzip + parse	🐢 Hours per format
Commercial cricket-data feeds	$1,000+/month	Live + archive	Real-time	Many	⏳ License + onboarding
Per-source scoreboard scraping	Free	One source	Per-page	Few	⏳ Many parsers

Pick this Actor when you want clean, structured, ball-by-ball cricket data without writing parsers.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the Cricsheet Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode (matches or deliveries), choose a format/league, optionally filter by team or season.
4. 🚀 Run it. Click Start and let the Actor collect your cricket data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from sign-up to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

🎮 Fantasy & Betting Fantasy scoring engines fed live by per-ball deliveries Win-probability models trained on historical T20 ball-by-ball Player-prop betting analytics across formats DFS lineup optimizers using per-batter-versus-bowler splits	📺 Broadcast & Media Real-time graphics fed by structured match metadata "On this day" highlight segments from historical archive Statistical overlays for commentary and post-match analysis Newsroom backgrounders on player and team form
📱 Apps & Products Cricket scoreboard apps with consistent format coverage Player career-history apps spanning men's and women's cricket League-comparison dashboards (IPL vs BBL vs PSL vs The Hundred) Replay-viewer apps powered by ball-by-ball delivery records	🎓 Analytics & Coaching Team-performance analytics for coaching staff Opposition-scouting reports built from per-ball data Bowler-versus-batter matchup analyses Venue-effect studies (high-scoring vs low-scoring grounds)

---

🔌 Automating Cricsheet Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Daily refreshes during a tournament keep downstream cricket dashboards in sync automatically.

---

🌟 Beyond business use cases

Cricket data powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

🎓 Research and academia Sports-science papers on per-ball performance Reproducible studies with cited, versioned dataset pulls Statistics coursework using ball-by-ball data Open-data exercises on cricket history	🎨 Personal and creative Personal stat-tracker projects for favourite teams Hobbyist analysis of niche leagues (BBL, ILT20, SA20) Cricket-blog charts and visualisations Indie cricket-games and simulators
🤝 Non-profit and civic Grassroots-cricket development analytics Civic projects on women's cricket visibility Investigative journalism on match-fixing patterns Cricsheet community contributions	🧪 Experimentation Train ML models for ball-outcome prediction Validate sports-tech product hypotheses with real data Prototype agent pipelines that resolve player and venue names Test dashboard concepts with live cricket feeds

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a mode (matches or deliveries), choose a format or league, optionally filter by team, season, gender, or venue, click Start, and the Actor returns clean structured rows with full metadata or per-ball detail.

🏏 What's the difference between matches and deliveries mode?

matches returns one row per match with summary fields and aggregate stats (total runs, wickets, run rate per over). deliveries returns one row per ball, with batter, bowler, runs, extras, boundary flag, wicket flag, and dismissal info. Choose deliveries for ball-by-ball modelling, matches for high-level summaries.

🏆 Which formats and leagues are covered?

16 formats and leagues: Tests, ODIs, T20Is, IPL, BBL (Big Bash League), PSL (Pakistan Super League), CPL (Caribbean Premier League), The Hundred, WBBL (Women's Big Bash League), WPL (Women's Premier League), SA20, ILT20 (UAE), other multi-day cricket, other one-day cricket, and World Cups (men and women combined).

🚹 Are women's matches included?

Yes. WBBL and WPL are dedicated leagues, and women's World Cup matches are included under the World Cup option. Use the gender filter to scope to men's-only or women's-only across any format.

📅 How far back does the archive go?

Cricsheet has structured records going back decades for Tests and ODIs, and complete coverage of every IPL season since the league's inception in 2008. The "recently added" option returns the most recent 30 matches across all formats for quick previews.

🔁 How often is the dataset refreshed?

Cricsheet adds new matches within hours to days of completion. Every run of this Actor pulls live data from the archive, so your dataset reflects the current state at run time.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to run this Actor on any cron interval. Daily refreshes during a tournament keep downstream cricket dashboards in sync.

⚖️ Is this data legal to use?

Cricsheet publishes match data under a permissive open-data licence (ODC-BY) that allows free use including commercial purposes, with attribution. Review the Cricsheet terms for your specific use case.

💳 Do I need a paid Apify plan to use this Actor?

No. The free Apify plan is enough for testing and small runs (10 records per run). A paid plan lifts the limit and gives you access to scheduling, higher concurrency, and larger datasets.

🔁 What happens if a run fails or gets interrupted?

Apify automatically retries transient errors. If a run still fails, you can inspect the log in the Runs tab, fix the input, and re-run. Partial datasets from failed runs are preserved so you never lose progress.

🆘 What if I need help?

Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below.

---

🔌 Integrate with any app

Cricsheet Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get run notifications in your channels
• n8n - Self-hosted automation pipelines
• Pipedream - Event-driven workflow automation
• Airbyte - Pipe cricket data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh cricket data into your product backend, or alert your team in Slack.

---

🔗 Recommended Actors

• ⚽ Football Stats Scraper - Live and historical football match data
• 🏀 NBA Stats Scraper - NBA player and team statistics
• 🎾 ATP Tennis Scraper - Professional tennis match results
• 📊 ESPN Stats Scraper - Multi-sport stats and scores
• 🏟️ Sportradar Scraper - Comprehensive sports data feeds

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Cricsheet, the BCCI, ICC, or any cricket league or governing body. All trademarks mentioned are the property of their respective owners. Only publicly available open cricket data is collected.