ESPNcricinfo Stats Scraper

Extract cricket statistics from ESPNcricinfo Statsguru — the world's most comprehensive cricket statistics database covering Tests, ODIs, T20Is, and domestic cricket.

What Does This Actor Do?

ESPNcricinfo Scraper fetches innings-by-innings batting and bowling performances and match results across three modes:

• Batting Stats — individual innings batting records: runs, balls faced, strike rate, boundaries, venue
• Bowling Stats — individual innings bowling figures: wickets, overs, economy rate, maidens
• Match Results — team-level match results: win/loss, margin, toss, batting order

All data is filtered and cleaned — no null fields are emitted.

Input Parameters

Parameter	Type	Description	Default
mode	String	Stat type to scrape	battingStats
matchType	String	Match format	tests
teamId	Integer	Filter by team ID (optional)	—
startDate	String	Filter from date (YYYY-MM-DD)	—
endDate	String	Filter to date (YYYY-MM-DD)	—
maxItems	Integer	Max records (1–500)	50

Match Types

Value	Description
tests	Test matches (5-day)
odis	One Day Internationals
t20is	T20 Internationals
firstClass	First-class cricket
listA	List A cricket

Common Team IDs

Team	ID
England	1
Australia	2
South Africa	3
West Indies	4
New Zealand	5
India	6
Pakistan	7
Sri Lanka	8
Bangladesh	25
Zimbabwe	29

Output Format

Batting Stats

{
  "player": "BC Lara",
  "country": "WI",
  "playerUrl": "https://www.espncricinfo.com/ci/content/player/52337.html",
  "matchType": "tests",
  "statType": "batting",
  "runs": 400,
  "notOut": true,
  "minutes": 778,
  "ballsFaced": 582,
  "fours": 43,
  "sixes": 4,
  "strikeRate": 68.72,
  "innings": 1,
  "opposition": "England",
  "ground": "Antigua Recreation Ground",
  "matchDate": "10 Apr 2004",
  "mode": "battingStats",
  "scrapedAt": "2024-01-15T10:30:00+00:00"
}

Bowling Stats

{
  "player": "JC Laker",
  "country": "ENG",
  "matchType": "tests",
  "statType": "bowling",
  "overs": "51.2",
  "maidens": 6,
  "runsConceded": 23,
  "wickets": 10,
  "economy": 1.03,
  "innings": 3,
  "opposition": "Australia",
  "ground": "Old Trafford",
  "matchDate": "27 Jul 1956",
  "mode": "bowlingStats",
  "scrapedAt": "2024-01-15T10:30:00+00:00"
}

Match Results

{
  "team": "Australia",
  "result": "won",
  "margin": "45 runs",
  "tossResult": "won",
  "battedFirst": "1st",
  "opposition": "England",
  "ground": "Lords",
  "matchDate": "18 Jun 2023",
  "matchType": "tests",
  "statType": "matchResult",
  "mode": "matchResults",
  "scrapedAt": "2024-01-15T10:30:00+00:00"
}

FAQ

Q: Is an API key required? A: No. This actor scrapes the public Statsguru HTML pages which are freely accessible.

Q: How many records per run? A: Statsguru returns 50 records per page. Set maxItems up to 500 to collect more.

Q: Can I filter by specific players? A: Player filtering is not directly supported. Use team ID and date range to narrow results, then filter the output dataset.

Q: What does notOut mean? A: In batting records, notOut: true means the batsman was not dismissed in that innings (indicated by an asterisk in score tables).