Cricket Data Scraper — Fixtures, Results & Full Scorecards 🏏

foXLabs sports data: Cricket · UFC/MMA · Golf · Formula 1 · Rugby

🎉 Cricket as clean, structured data: matches across the major competitions (ICC World Cup, World Test Championship, IPL, Big Bash and more) with teams, innings scores, result and status, plus full per-player batting and bowling scorecards for any match — live or historical. No API key, no login. Built for fantasy and betting modellers, stats products and AI agents.

🔍 What is the Cricket Data Scraper — and when should you use it?

Give a date range (or specific competitions) for fixtures and results, or pass historical match IDs for full scorecards. Turn on includeScorecards to attach every batter's and bowler's card to each completed match.

Use it when you need: fixtures and results across competitions; full batting/bowling scorecards (runs, balls, strike rate, overs, wickets, economy) for current or historical matches; or a fantasy/betting dataset. Use something else when you want another sport — see the rest of the foXLabs sports family.

🤖 Use with AI agents

Already on the Apify MCP server? Ask for it by name: foxlabs/cricket-data.

Your agent can pay for its own runs — pay-per-event with agentic payments over x402 (USDC on Base) or Skyfire, with no Apify account of its own. Billing is per delivered match, never for errors or empty results.

Paste into Claude, ChatGPT, Cursor or any MCP assistant:

Use the Apify Actor `foxlabs/cricket-data`.
Input: `dateFrom`/`dateTo` (YYYY-MM-DD) and `leagueIds` for fixtures/results; `includeScorecards` adds full batting/bowling cards;
`matchIds` fetches full scorecards for specific historical matches; `maxResults` caps rows.
Start with: { "dateFrom": "2026-10-01", "dateTo": "2026-12-31", "includeScorecards": true }

Things you can ask your agent:

• "Give me the IPL matches this month with each batter's runs and strike rate."
• "Fetch the full scorecard for match 1384439."
• "Which bowlers took three or more wickets?"

📋 Overview

Fixtures, results and innings scores come from ESPN's public, keyless cricket API. Full per-player batting and bowling cards come from ESPNcricinfo, read through the Apify Unblocker so no key or login is ever needed from you. ESPN's cricket event id is the ESPNcricinfo match id, so a match's summary and its full scorecard line up.

Why teams pick this actor:

• 🧱 Fixtures, results and scorecards in one actor — not just scores.
• 🧬 Full batting & bowling cards — every player's runs, balls, 4s, 6s, strike rate; every bowler's overs, maidens, wickets, economy.
• 🕰️ Historical by match id — pull the full scorecard of any past match, not only the current season.
• 🔑 Zero setup — no API key, no login, no proxy to buy.
• 🤝 Agent-ready — MCP + x402, billed per delivered match.

✨ Features

• 🏏 Fixtures & results — teams, innings scores, result, status and venue across competitions.
• 📊 Batting cards — per batter: runs, balls, minutes, 4s, 6s, strike rate and dismissal.
• 🎯 Bowling cards — per bowler: overs, maidens, runs, wickets, economy, dot balls.
• 🕰️ Any match — current window by date, or any historical match by matchIds.
• 📦 Clean export — deduplicated camelCase rows, ready for CSV/Excel/JSON.

🎬 Quick Start

curl -X POST "https://api.apify.com/v2/acts/foxlabs~cricket-data/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"matchIds": ["1384439"]}'

🚀 Getting Started (3 steps)

1. Choose the matches — a dateFrom/dateTo range (with optional leagueIds), or matchIds for specific historical matches.
2. Add depth — turn on includeScorecards for full batting/bowling cards on completed matches.
3. Run and export — download the dataset as JSON, CSV or Excel, or pull it from the API.

📥 Input

{
  "dateFrom": "2026-10-01",
  "dateTo": "2026-12-31",
  "includeScorecards": true,
  "matchIds": [],
  "maxScorecardMatches": 20,
  "maxResults": 0
}

Field	Type	Description
dateFrom / dateTo	string	Match date range (YYYY-MM-DD). Defaults: last 21 / next 21 days.
leagueIds	array	ESPN cricket league IDs. Empty = the major default set.
includeScorecards	boolean	Add full batting/bowling cards for completed matches (default off).
matchIds	array	ESPNcricinfo match IDs for direct historical scorecards; when set, only these are returned.
maxScorecardMatches	integer	Cap on how many matches get the scorecard lookup in one run (default 20).
maxResults	integer	Cap on delivered matches (0 = default).
proxyConfiguration	object	Apify datacenter by default — no setup needed.

📤 Output

Match with scorecard (includeScorecards or matchIds):

{
  "league": "ICC Cricket World Cup", "eventId": "1384439",
  "name": "India vs Australia", "status": "Result", "result": "Australia won by 6 wickets",
  "teams": [ { "name": "India", "score": "240" }, { "name": "Australia", "score": "241/4", "winner": true } ],
  "innings": [
    { "inningsNumber": 1,
      "batting": [ { "name": "RG Sharma", "playerId": "34102", "captain": true, "dismissal": "c Head b Maxwell", "runs": 47, "balls": 44, "fours": 4, "sixes": 3, "strikeRate": 151.61 } ],
      "bowling": [ { "name": "MA Starc", "overs": 10, "maidens": 0, "runs": 55, "wickets": 3, "economy": 5.5 } ] }
  ],
  "source": "ESPN", "scrapedAt": "2026-11-02T13:00:00.000Z"
}

Field	Description
league / eventId	Competition and match id (ESPN id = ESPNcricinfo match id).
name / status / result / venue	Match identity and outcome.
teams	Both teams with innings scores and the winner.
innings[]	Per innings: batting (runs, balls, 4s, 6s, strikeRate, dismissal) and bowling (overs, maidens, runs, wickets, economy).

💼 Use cases

• Fantasy / betting model
  • Input: { "includeScorecards": true, "dateFrom": "2026-10-01", "dateTo": "2026-12-31" }
  • Output: matches with full player cards.
  • Use: model batter form, strike rates and bowler economy.
• Historical research
  • Input: { "matchIds": ["1384439", "1384438"] }
  • Output: full scorecards of specific past matches.
• Results feed
  • Input: { "dateFrom": "2026-11-01", "dateTo": "2026-11-30" }
  • Output: the month's fixtures and results.

🔗 Integration

JavaScript (Apify client):

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('foxlabs/cricket-data').call({ matchIds: ['1384439'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python (Apify client):

from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("foxlabs/cricket-data").call(run_input={"matchIds": ["1384439"]})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

n8n / Zapier / Make: use the Apify connector, pick this actor, map the dates or matchIds and includeScorecards, then route the dataset into your sheet, database or webhook.

📊 Pricing

Pay per result (PPE). You are billed only for delivered matches, never for errors or empty runs. Full scorecards come with the match. Current prices are on the Pricing tab.

❓ FAQ

Do I need an API key or a login to scrape cricket data?

No. You supply only a date range or match IDs. There is no API key, login or browser to configure; fixtures come from a keyless ESPN API and scorecards are read for you through the Apify Unblocker.

What does a match row contain?

The competition and match, both teams with their innings scores, the result and status, the venue and the date. With scorecards on, an innings array adds full batting and bowling cards.

What is in a full scorecard?

For each innings: every batter's runs, balls, minutes, 4s, 6s, strike rate and dismissal, and every bowler's overs, maidens, runs, wickets, economy and dot balls — the complete card, not just the top scorers.

Can I get the scorecard of a historical match?

Yes. Pass the match IDs in matchIds and the actor returns the full scorecard for each, from any past match — not only the current season.

How do I find a match ID?

Run a date range or league first to get eventId values (ESPN's cricket event id is the same as the ESPNcricinfo match id), then pass those in matchIds, or take the number from an ESPNcricinfo match URL.

Which competitions are covered?

By default the ICC World Cup, World Test Championship, IPL and Big Bash; pass your own leagueIds for others. Scorecards work for any match that has a match id.

How current is the data?

Fixtures and results are read live each run. Scorecards reflect the match as played; a completed match returns its full final card, an in-progress match returns what has happened so far.

How is billing calculated?

Pay per result: you are charged only for matches actually returned, never for an empty run or an error. The full scorecard comes with the match, not as a separate charge.

Can I export to CSV, Excel or JSON?

Yes. Download the dataset as JSON, CSV or Excel from the Apify console, or pull it from the Apify API or the dataset's .json endpoint for a model, a spreadsheet or an AI agent.

How is this different from a live-score scraper?

A live-score scraper gives the result. This actor adds the complete batting and bowling scorecard, per player, for current and historical matches — the depth fantasy and betting models need.

🐛 Troubleshooting

• No matches found — widen dateFrom/dateTo, pass specific leagueIds, or use matchIds; cricket has off-season windows.
• No innings on a match — scorecards appear with includeScorecards (or matchIds), and only for matches that have been played.
• Only the first N matches have scorecards — maxScorecardMatches caps how many get the lookup; raise it for a bigger run.

⚠️ Trademark

Independent, third-party tool. Not affiliated with, endorsed by or connected to the ICC, any board or league, ESPN or ESPNcricinfo. All marks belong to their owners and are used for identification only.

⚖️ Is it legal to scrape this data?

This actor reads publicly available, non-personal sports data (scores and scorecards) already published for public viewing. It collects no private personal data and requires no login. Use the output in line with applicable laws and the terms of the sources. When in doubt, consult a lawyer.

🤝 Support & contact

• 🌐 Website: data.foxlabs.com.tr
• 📧 Email: info@foxlabs.com.tr
• 🧰 More clean data actors: Fox Labs on Apify

Changelog

0.2 — 2026-11-02

• New includeScorecards option and matchIds input add full per-player batting and bowling cards (from ESPNcricinfo, via the Apify Unblocker) for completed and historical matches, with a maxScorecardMatches cap.
• Added output schema (dataset + run-report key-value live view).

0.1 — 2026-11-02

• Initial release: fixtures, results and innings scores across the major competitions from ESPN's keyless API.